grill-with-docs

Interview the user one question at a time until the plan, terminology, and important decisions are clear enough to act on.

Workflow

1. Read the user's plan, linked docs, code, or local files needed to understand the topic.
2. Look for existing CONTEXT.md, CONTEXT-MAP.md, and docs/adr/ files before proposing new docs.
3. Ask one focused question at a time. Wait for the answer before continuing.
4. If the answer can be discovered from the codebase or existing docs, inspect those instead of asking.
5. For each question, include your recommended answer or likely tradeoff so the user can accept, reject, or refine it.
6. Push on fuzzy words, hidden assumptions, edge cases, dependencies between decisions, and reversibility.
7. When terminology is resolved, update the appropriate CONTEXT.md immediately.
8. Offer an ADR only for decisions that are hard to reverse, surprising without context, and based on a real tradeoff.

Documentation Rules