mcpField
G
grill-with-docs

grill-with-docs

github.com/carlitoseDevelopment048 installsUpdated 2w ago
Repository

About grill-with-docs

Grill With Docs combines an interview-led grilling process with domain modeling. It is for clarifying a plan and durable domain language, with documentation changes deferred until the user confirms shared understanding.

Key features

  1. 01Combines grilling and domain modeling
  2. 02Frontier questions with recommended answers
  3. 03Waits for user feedback
  4. 04Inspects existing docs and code
  5. 05Updates CONTEXT.md after terms are resolved
  6. 06Creates ADRs only when criteria are met

Use cases

  1. 01Clarify a plan through iterative questions
  2. 02Resolve ambiguous domain terminology
  3. 03Record confirmed domain language in CONTEXT.md
  4. 04Document an important decision as an ADR

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/carlitose/agent-skills --skill grill-with-docs

After installing, type/grill-with-docsin Claude Code to confirm it loaded.

Details

From the project README

Grill With Docs

Compose canonical grilling with domain-modeling.

If slash commands are available, /grilling with /domain-modeling is equivalent. Otherwise load and follow both linked skills directly:

  • Use grilling for the interview loop: rounds of frontier questions, a recommended answer for each, wait for feedback, and do not enact the plan until the user confirms shared understanding.
  • Use domain-modeling for durable language: inspect existing context docs and code, challenge fuzzy terms, update CONTEXT.md only when terms are resolved, and create ADRs only when the ADR criteria are met.

Interview ownership remains with grilling; documentation is subordinate. Do not create docs before the confirmation gate or just because this variant is active. Create or update them lazily only when the confirmed conversation produces durable domain language or a genuinely important decision.

Comments

Markdown supported