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_midway.json

View on GitHub
{
  "subject": "Replace the nightly invoice export cron job with a queue-driven exporter (mid-grilling, after round 1)",
  "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 \u2014 keep the CSV schema frozen for this change.",
      "answer": "Yes, frozen.",
      "depends_on": []
    },
    {
      "id": "Q4",
      "category": "success",
      "kind": "decision",
      "status": "open",
      "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.",
      "depends_on": [
        "Q1"
      ]
    },
    {
      "id": "Q5",
      "category": "failure_modes",
      "kind": "decision",
      "status": "open",
      "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.",
      "depends_on": [
        "Q1",
        "Q2"
      ]
    },
    {
      "id": "Q6",
      "category": "reversibility",
      "kind": "decision",
      "status": "open",
      "question": "Do we keep the cron job runnable for two weeks as a fallback?",
      "recommended": "Yes, disabled but deployable, removed after 14 clean days.",
      "depends_on": [
        "Q3"
      ]
    },
    {
      "id": "Q7",
      "category": "sequencing",
      "kind": "decision",
      "status": "open",
      "question": "Run old and new exporters in parallel for a week and diff the files before cutover?",
      "recommended": "Yes \u2014 shadow-run for 7 nights, cut over after 7 identical diffs.",
      "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",
      "status": "open",
      "question": "Should the export later move to an API push into the ERP?",
      "recommended": "Defer \u2014 out of this change; revisit after 30 clean days.",
      "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