grill-with-docs

grill-with-docs runs a structured grilling session that combines adversarial questioning with live documentation output. As you answer questions about your plan or design, it produces Architecture Decision Records (ADRs) and a glossary incrementally, so you leave the session with both a sharpened design and ready-made docs.

• Runs a /grilling interview session to stress-test a plan or design
• Uses the /domain-modeling skill as its foundation
• Generates Architecture Decision Records (ADRs) during the session
• Builds a glossary of terms as the conversation progresses
• Produces documentation artifacts alongside the interview itself

1. 1.Install the skill: npx skills add https://github.com/mattpocock/skills --skill grill-with-docs
2. 2.Open your coding agent (e.g. Claude Code or Cursor)
3. 3.Invoke the session with the /grilling command
4. 4.Present your plan or design when prompted
5. 5.Answer the adversarial questions the agent poses
6. 6.Review ADRs and glossary entries generated during the session
7. 7.Iterate on your design based on the interview findings
8. 8.Save or commit the generated documentation artifacts