What problem does it solve?
It prevents misalignment between a proposed design and the project’s established terminology, domain model, and documented decisions by forcing a plan to be clarified and validated.
Core Features & Use Cases
- Relentless plan interview: It questions every branch of the design tree one step at a time until shared understanding is reached.
- Terminology and glossary sharpening: It detects conflicts with the project’s glossary in CONTEXT.md and proposes precise canonical terms.
- Scenario-driven boundary testing: It probes edge cases and relationships using concrete invented scenarios to resolve ambiguous boundaries.
- Code and documentation cross-checking: If answers can be derived from the codebase, it explores it to surface contradictions and reconcile statements with reality.
- Inline documentation updates: It updates CONTEXT.md immediately when terms are resolved, keeping it free of implementation details, and offers ADRs only when a real trade-off is recorded.
Quick Start
Ask the AI to run grill-with-docs on your proposed change, and provide the high-level plan you want stress-tested.