borghei/Claude-Skills / project-management/discovery/plan-grilling
plan-grilling
VerifiedInterrogate a plan, design or idea one round of questions at a time until every decision is settled. Use when stress-testing a plan before building, when a design feels underspecified, or turning a fuzzy workflow into a spec.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.6 KB |
| assets/question_log_template.md | markdown | 2.0 KB |
| assets/sample_question_log.json | config | 3.4 KB |
| assets/sample_question_log_flawed.json | config | 1.7 KB |
| assets/sample_question_log_midway.json | config | 3.7 KB |
| assets/sample_workflow_spec.json | config | 2.2 KB |
| assets/sample_workflow_spec_flawed.json | config | 578 B |
| assets/workflow_spec_template.md | markdown | 1.5 KB |
| references/question-taxonomy.md | markdown | 9.4 KB |
| references/running-the-grilling.md | markdown | 10.1 KB |
| scripts/question_log_checker.py | script | 11.0 KB |
| scripts/workflow_spec_checker.py | script | 9.1 KB |
assets/question_log_template.md
View on GitHub# Question Log — <plan or idea, one line>
**Mode:** single-session | multi-session (session <n> of <expected>)
**Started:** <YYYY-MM-DD> **Last round:** <n>
**Decision-maker:** <who answers the decision questions>
Keep this file next to the plan. Every question the grilling raises lands here,
including the ones the agent answered itself. Mirror it into the JSON shape in
`sample_question_log.json` when you want the checker to gate it.
## Round <n>
| ID | Category | Kind | Depends on | Question | Recommended answer | Answer | Status |
|----|----------|------|------------|----------|--------------------|--------|--------|
| Q1 | goal | decision | — | <one idea, no compound questions> | <the agent's pick, worded so "yes" accepts it> | <verbatim> | answered |
| Q2 | users | fact | — | <fact the agent looked up> | — | <finding> (source: <where>) | answered |
Category: goal · users · constraints · success · failure_modes · reversibility ·
sequencing · ownership · unknowns
Kind: decision (the user's call) · fact (look it up; ask only if it cannot be found)
Status: open · asked · answered · deferred · assumed
## Decisions so far
One line per settled decision, in the order they were made:
- Q1 — <gist of the answer>
## Assumptions (stated, not silent)
| ID | Assumption | Fact or decision | Confirmed by | Source / how to verify |
|----|------------|------------------|--------------|------------------------|
## Deferred
| ID | Question | Owner | Reason | Revisit when |
|----|----------|-------|--------|--------------|
## Open questions (next round)
Paste the checker's "Next round" list here and draft each question with a
recommended answer before asking.
## Exit check
- [ ] Frontier empty: no open or asked questions remain
- [ ] Every core category has at least one settled question
- [ ] No decision sits under "assumed" without the decision-maker's confirmation
- [ ] Every deferral has an owner and a reason
- [ ] The decision-maker read the "Decisions so far" list back and agreed it is the plan
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |