Grill With Docs

Use when stress-testing a plan against the existing domain model + decisions. Challenges terminology, cross-references code, updates CONTEXT.md and ADRs inline as decisions crystallize.

neumie 93eaa3f 1.4 KB Updated

File contents

Grill With Docs

Follow the grilling skill for the interview loop. Follow the domain-model skill to maintain domain language and ADRs as decisions crystallize.

Domain awareness

These commands run automatically when the skill loads — output replaces each line below:

  • CONTEXT.md: !cat CONTEXT.md 2>/dev/null || true
  • CONTEXT-MAP.md: !cat CONTEXT-MAP.md 2>/dev/null || true
  • ADR list: !ls docs/adr/ 2>/dev/null || true

Use the output above:

  • CONTEXT.md — glossary of domain terms. If content is in context, use its vocabulary in all output. If empty, create one when the first term is resolved.
  • CONTEXT-MAP.md — if content is in context, the repo has multiple bounded contexts. The map points to where each one lives.
  • docs/adr/ — architecture decision records. If files were listed, read the relevant ones. Create the directory when the first ADR is needed.

During the session

Follow the grilling skill for question order, recommendations, specificity, and code exploration.

Follow the domain-model skill for glossary challenges, fuzzy-term sharpening, scenario stress tests, code cross-checks, CONTEXT.md updates, and ADR creation rules.

neumie/almanac/tree/main/skills/productivity/grill-with-docs commit 93eaa3f006

Frequently asked questions

npx skillmds@latest add neumie/grill-with-docs