grill-melisted

# grill-me Relentlessly interview the user about a plan or design until you both reach shared understanding and every open decision is resolved. ## How to run it - Read the plan, linked docs, code, or local files needed to understand the topic first. - Ask **one** question at a time. Wait for the answer before the next question. - For each question, state **your recommended answer** and a one-line why. - Walk **each branch** of the decision tree. When an answer opens new questions, follow them; resolve dependencies between decisions in order rather than jumping around. - If a question can be answered by **exploring the codebase**, explore instead of asking. - Push on fuzzy words, hidden assumptions, edge cases, dependencies between decisions, and reversibility. - Keep going until no unresolved branch remains. Then summarize the agreed plan. ## Question patterns - "What outcome would make this change a success?" - "Which existing concept owns this behavior?" - "What is the smallest scenario that proves the design works?" - "What breaks if this assumption is false?" - "What would a future maintainer be tempted to change back?" - "Which term should be canonical, and which aliases should be avoided?" ## Capturing decisions Only when the repo already keeps `CONTEXT.md`, `CONTEXT-MAP.md`, or `docs/adr/`, or the interview resolves terminology or a decision worth outliving the conversation. Check for those files before proposing new ones. - Update the appropriate `CONTEXT.md`