grill-with-docs

To validate a project plan against your domain model, run a guided grilling session that relentlessly questions assumptions across CONTEXT.md and ADRs. This surfaces gaps and misalignments by iteratively clarifying decisions until they are fully explicit and traceable.

Stress-testing architecture decisions involves challenging your plan against documented context to expose hidden dependencies. The session applies guided questioning to refine glossary terms and update ADRs, ensuring decisions are explicit and aligned with the domain model before development proceeds.

You can update CONTEXT.md and ADRs inline as decisions crystallize during a grilling session. The process involves iterative questioning that captures new consensus immediately, refining glossary terms and recording architecture decisions directly within the existing documentation.

Yes, stress-testing a plan requires a repository that already contains CONTEXT.md or CONTEXT-MAP.md and ADRs. These files provide the baseline domain model and recorded decisions needed to surface gaps and align terminology during the guided grilling session.

Use a domain model grilling session during architecture and planning discussions when you need to surface assumptions and dependencies. It is designed for teams aiming to align terminology and ensure decisions are explicit, traceable, and updated directly in project documentation.