klimkit-grill-me

Klimkit Grill Me

Interview the user relentlessly about every important part of the plan until both sides can see the same shape of the decision. Walk down the design tree branch by branch, resolve dependencies between decisions one at a time, and provide your recommended answer for each question.

Keep the session direct and human. This is a working conversation, not a form: ask the question you would actually ask if you were trying to save the plan from a hidden flaw, a vague assumption, or a weak tradeoff. The Klimkit addition is that every approved decision gets a short written trail.

Workflow

1. Resolve the active work folder. If the repo has no docs/work/ layout, use klimkit-setup first.
2. Create or reuse a grilling phase folder inside the current work folder under docs/work/, for example docs/work/015-140126-checkout-redesign/002-150126-grilling/.
3. Create or reuse a number-prefixed agent-authored Markdown note in that folder, for example 001-grilling-session.md.
4. Start the note with a short title, the source request, and the current decision target.
5. Prepare under the hood before asking:
   • Inspect the relevant codebase, docs, task notes, and existing decisions.
   • Search the web for current outside context when market, product, API, framework, legal, pricing, or best-practice facts could affect the answer.
   • Draft a private top-question list, estimate each question's importance, and rank contradictions or complete requirement gaps first.
6. Before asking, write a compact Question Triage grid into the grilling-session note with up to 10 considered questions:
   • one-sentence TLDR of each candidate question.
   • importance estimate such as critical, high, medium, or low.
   • one-sentence reason for the ranking.
   • mark the question chosen now and why it is top priority at this moment.
7. Ask exactly one question at a time: the current highest-importance question from the ranked list.
8. For each question, include your recommended answer unless repo/web research or user context makes that premature.
9. After the user answers, append a short tracking memo to the grilling-session note:
   • Q: the question asked.
   • Approved decision: the user's decision, or your concise restatement if the user approved your recommendation.
   • Open follow-up: only when the answer leaves a real unresolved branch.
10. Rebuild and rerank the top-question list after every answer, using the new state and any new facts discovered from the repo or web; refresh the Question Triage grid before the next question so the user can audit what was considered and why.
11. Continue until the remaining branches are low-risk, explicitly deferred, or converted into concrete tasks.
12. End with a compact decision summary and the path to the grilling-session note.