grill-with-docs

Conduct structured interviews to refine plans and generate ADRs and glossary terms.

Updated Mar 11, 2025
One-click install
npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill grill-with-docs-mohammedsaudalsahli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/MohammedSaudAlsahli/dotfiles/tree/main/ai/agents-skills/grill-with-docs
Command: npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill grill-with-docs-mohammedsaudalsahli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The grill-with-docs skill aids in refining plans and designs through a structured interview process, simultaneously generating documentation such as ADRs (Architecture Decision Records) and glossary terms.

Core Features & Use Cases

  • Plan Sharpening: Facilitates detailed discussions to improve plans or designs.
  • Documentation Generation: Outputs ADRs and glossary entries as discussions progress.
  • Use Case: When finalizing a new feature in your software, this skill can help in shaping the architecture, and document critical decisions alongside.

Quick Start

To begin the interview process for a feature, run grill-with-docs /feature-name.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create Architecture Decision Records while refining a project plan?

You can create Architecture Decision Records while refining a project plan by using a conversational interface that conducts structured interviews. This process outputs ADRs and glossary terms in real-time as your design discussion progresses.

What is an interview-based approach for project plan refinement?

Interview-based project plan refinement uses a conversational interface to systematically question and sharpen design specifications. It simultaneously generates structured documentation like ADRs and glossary terms during the interactive discussion process.

How do I generate ADRs and glossary terms from a design specification?

You generate ADRs and glossary terms from a design specification by conducting a structured interview using a conversational interface. The tool outputs documentation in real-time, capturing decisions in markdown or structured data formats.

Can I use a conversational interface to document architecture decisions in markdown?

Yes, you can use a conversational interface to document architecture decisions in markdown. The tool requires a text processor capable of outputting structured data formats and generates ADRs directly during the interview dialogue.

What is the best way to sharpen software feature designs before finalizing architecture?

The best way to sharpen software feature designs before finalizing architecture is through a structured interview process. This method facilitates detailed discussions to improve plans while simultaneously generating ADRs and glossary entries alongside the design.