grilling-plan

name	grilling-plan
description	Stress-test a plan one question at a time before building, especially for shared fleet resources.
metadata	{"internal":true}

grilling-plan

The proactive complement to plan-review-nudge (the after-plan gate). Interview the user relentlessly about every branch of the design tree until you reach shared understanding — then the plan is ready to land.

1. Resolve the deterministic questions first

Before asking the user anything, answer every question the codebase already answers — this is the code-first-then-ai discipline applied to design. If the change proposes a NEW enforcement surface (hook, lint rule, check, skill, agent), run the inventory and compare:

node scripts/fleet/codify-scan/inventory.mts

It emits the authoritative set of existing hooks / lint rules / checks / docs. If the thing you'd build already exists, the answer is "extend it", not "add one" — don't ask the user a question grep or the inventory settles. Read the relevant files in place. Only what the codebase cannot answer goes to the user.

2. Interview one question at a time

Ask the residue — the design-intent questions no script resolves: trade-off framing, naming, cascade blast-radius, the reversal condition. Rules:

• One question at a time. Wait for the answer before the next. Multiple questions at once is bewildering.
• Every question carries your recommended answer and the reason, so the user can accept with one word.
• Walk the tree in dependency order — resolve a decision its children depend on before descending.
• If a later answer can be derived from an earlier one, derive it; don't re-ask.

3. Gate before landing

A fleet-shared change is settled only when the plan has the shape plan-review-nudge checks for:

• Numbered steps, each naming the real files + rules it touches.
• The final name / schema shape decided up front (a name that will cascade must not churn across commits).
• A second-opinion invite when the plan edits a fleet-shared resource (CLAUDE.md, template/, .claude/hooks/, _shared/).

Completion criterion

Every design-tree branch is resolved (by the codebase or by the user), the plan names its files + rules in numbered steps, the cascaded names are settled, and — for a fleet-shared change — a second opinion has been invited. Then write the plan to .claude/plans/<name>.md and execute.