grill-with-docs

You can align your plan with existing documentation by enforcing terminology discipline, cross-checking repository structure like docs/adr, and interactively exploring design decisions to surface ambiguities and ensure domain terminology consistency.

To start a grilling session, ask the agent to walk through your plan interactively, explore design decisions, and update CONTEXT.md and ADRs inline as terminology conflicts surface and decisions crystallize.

Inline documentation updates distinguish this approach by recording trade-offs and reflecting decisions in CONTEXT.md and ADRs as they crystallize, providing an auditable, in-context narrative rather than static, after-the-fact documentation.

You should not use inline documentation updates when your repository lacks a CONTEXT.md or docs/adr structure, as the tool relies on cross-checking these existing files to synchronize living documentation and validate domain terminology.