Grill plans against recorded decisions

grill-with-docspluginsetup L2★17,464

What it does

Interrogate plans against documented terminology and decisions

Best for

Crystallizing terminology and architectural decisions incrementally as a plan develops, preserving them in version-controlled docs instead of tribal knowledge

Inputs

· plan text
· CONTEXT.md file
· docs/adr/ directory

Outputs

· updated CONTEXT.md
· updated ADR files
· terminology audit log

Requires

· Python linter tools
· ADR scanner
· glossary-to-code checker

Preconditions

Project has existing CONTEXT.md and docs/adr/ folder; user supplies plan to grill

Failure modes

Glossary inconsistencies found but team rejects refactoring; terminology audit flags obsolete ADRs; linter finds undocumented assumptions mid-session

Trust signals

· Derived from Matt Pocock's MIT-licensed grill-with-docs
· 3 stdlib validators (CONTEXT linter, ADR scanner, glossary-code checker)
· 3 reference docs citing 7+ sources each on ubiquitous language + ADR practice
· Interview discipline + 3-criteria ADR gate preserved verbatim