Skip to content

borghei/Claude-Skills / project-management/discovery/plan-grilling

plan-grilling

Verified

Interrogate 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.

assets/sample_question_log.json

View on GitHub
{
  "subject": "Replace the nightly invoice export cron job with a queue-driven exporter",
  "mode": "single-session",
  "questions": [
    {"id": "Q1", "category": "goal", "kind": "decision", "round": 1, "status": "answered",
     "question": "Is the goal to stop missed exports, or to make exports near-real-time?",
     "recommended": "Stop missed exports; real-time is a later, separate decision.",
     "answer": "Stop missed exports. Finance only reads the file at 07:00.", "depends_on": []},
    {"id": "Q2", "category": "users", "kind": "fact", "resolved_by": "agent", "status": "answered",
     "question": "Who consumes the export file today?",
     "answer": "Finance ops (3 people) via the shared drive; the ERP import job reads it at 06:30.",
     "source": "export bucket access logs, last 90 days", "depends_on": []},
    {"id": "Q3", "category": "constraints", "kind": "decision", "round": 1, "status": "answered",
     "question": "Must the file format stay byte-identical so the ERP import keeps working?",
     "recommended": "Yes — keep the CSV schema frozen for this change.",
     "answer": "Yes, frozen.", "depends_on": []},
    {"id": "Q4", "category": "success", "kind": "decision", "round": 2, "status": "answered",
     "question": "Is 'zero missed exports over 30 consecutive days' the success bar?",
     "recommended": "Yes, 30 days with zero misses and alerting within 15 minutes of a failure.",
     "answer": "Yes.", "depends_on": ["Q1"]},
    {"id": "Q5", "category": "failure_modes", "kind": "decision", "round": 2, "status": "answered",
     "question": "When the export fails twice, should the job page on-call or open a ticket for the morning?",
     "recommended": "Page on-call before 05:30 so there is time to rerun before the 06:30 import.",
     "answer": "Page on-call.", "depends_on": ["Q1", "Q2"]},
    {"id": "Q6", "category": "reversibility", "kind": "decision", "round": 2, "status": "answered",
     "question": "Do we keep the cron job runnable for two weeks as a fallback?",
     "recommended": "Yes, disabled but deployable, removed after 14 clean days.",
     "answer": "Yes.", "depends_on": ["Q3"]},
    {"id": "Q7", "category": "sequencing", "kind": "decision", "round": 3, "status": "answered",
     "question": "Run old and new exporters in parallel for a week and diff the files before cutover?",
     "recommended": "Yes — shadow-run for 7 nights, cut over after 7 identical diffs.",
     "answer": "Yes, 7 nights.", "depends_on": ["Q6", "Q4"]},
    {"id": "Q8", "category": "ownership", "kind": "decision", "round": 1, "status": "answered",
     "question": "Does the payments platform team own the exporter after cutover?",
     "recommended": "Yes, it sits next to their invoicing service.",
     "answer": "Yes, payments platform.", "depends_on": []},
    {"id": "Q9", "category": "unknowns", "kind": "fact", "resolved_by": "agent", "status": "assumed",
     "question": "Does the queue's retention cover a weekend outage?",
     "answer": "Retention is 7 days.", "source": "queue configuration in the infra repo", "depends_on": []},
    {"id": "Q10", "category": "unknowns", "kind": "decision", "round": 3, "status": "deferred",
     "question": "Should the export later move to an API push into the ERP?",
     "recommended": "Defer — out of this change; revisit after 30 clean days.",
     "owner": "Payments platform lead", "reason": "Needs ERP vendor input; not on the route to the goal.",
     "depends_on": ["Q4"]}
  ]
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall