What problem does it solve?
It prevents “hand-wavy” design plans by forcing a shared understanding of your project’s domain language and decisions, then updating CONTEXT.md and ADRs as the reasoning solidifies.
Core Features & Use Cases
- Relentless plan interview: Walk the design tree one question at a time, requiring clear answers before moving on.
- Domain glossary enforcement: Detects term conflicts with CONTEXT.md and pushes for canonical terminology and precise definitions.
- Documentation-in-the-loop updates: Updates CONTEXT.md inline as terms are resolved, and offers ADRs only when a decision has meaningful irreversibility, surprise, and trade-offs.
- Code cross-checking: Uses repository exploration to resolve questions from the source of truth and surfaces contradictions between what’s claimed and what the code does.
- Scenario stress-testing: Probes edge cases with concrete invented scenarios to clarify boundaries and relationships.
Quick Start
Use grill-with-docs to stress-test the current plan by saying: "Run grill-with-docs on my design plan for this repo, asking questions one at a time and updating CONTEXT.md and ADRs only when justified."