Planning Agent Skill

Planning Skill

Umbrella skill for the planning lifecycle. Routes to the correct reference based on the intent requested: write a spec, resolve ambiguities before planning, create a file-backed plan, validate a plan, manage plan lifecycle, pause a session, or resume from handoff artifacts.

Routing

Detect the user's intent and load the appropriate reference file:

| Intent | Trigger phrases | Reference |

|--------|----------------|-----------|

| Spec | "write spec", "user stories", "define requirements", "scope this", "acceptance criteria", "define scope", "spec out" | ${CLAUDE_SKILL_DIR}/references/spec.md |

| Pre-plan | "discuss ambiguities", "resolve gray areas", "clarify before planning", "assumptions mode", "before we plan", "pre-planning discussion" | ${CLAUDE_SKILL_DIR}/references/pre-plan.md |

| Interview | depth-first decision-tree, one question at a time, recommendation per question. Triggers: "interview me", "grill me", "depth-first review", "depth-first interview", "not sure", "i'm not sure", "where do i start", "want clarity on", "need clarity on", "what am i missing", "poke holes in", "challenge my assumptions", "think this through with me", "lots of moving parts", "many decisions" | ${CLAUDE_SKILL_DIR}/references/depth-first-interview.md |

| Plan-files | "create plan", "task plan", "working memory", "persistent plan", "file-backed planning" | ${CLAUDE_SKILL_DIR}/references/plan-files.md (+ ${CLAUDE_SKILL_DIR}/references/executor-ready-plan-template.md when the plan will be executed by subagents (SDD)) |

| Check | "check plan", "validate plan", "plan checker", "review plan", "is this plan ready", "pre-execution check" | ${CLAUDE_SKILL_DIR}/references/check.md |

| Manage | "list plans", "show plan", "complete plan", "plan status", "manage plans" | ${CLAUDE_SKILL_DIR}/references/manage.md |

| Pause | "pause", "save progress", "handoff", "stopping for now", "end session", "session handoff", "wrap up session" | ${CLAUDE_SKILL_DIR}/references/pause.md |

| Resume | "resume", "continue", "pick up where I left off", "what was I doing", "continue work", "where did I leave off", "what's next" | ${CLAUDE_SKILL_DIR}/references/resume.md |

Reference Loading Table

| Signal | Load These Files | Why |

|---|---|---|

| "write spec", "user stories", "define requirements", "scope this", "acceptance criteria", "define scope", "spec out" | spec.md | Spec |

| "discuss ambiguities", "resolve gray areas", "clarify before planning", "assumptions mode", "before we plan", "pre-planning discussion" | pre-plan.md | Pre-plan |

| "interview me", "grill me", "depth-first review", "depth-first interview", "not sure", "i'm not sure", "where do i start", "want clarity on", "need clarity on", "what am i missing", "poke holes in", "challenge my assumptions", "think this through with me", "lots of moving parts", "many decisions" | depth-first-interview.md | Interview |

| "create plan", "task plan", "working memory", "persistent plan", "file-backed planning" | plan-files.md (+ executor-ready-plan-template.md when plan targets SDD execution) | Plan-files |

| "check plan", "validate plan", "plan checker", "review plan", "is this plan ready", "pre-execution check" | check.md | Check |

| "list plans", "show plan", "complete plan", "plan status", "manage plans" | manage.md | Manage |

| "pause", "save progress", "handoff", "stopping for now", "end session", "session handoff", "wrap up session" | pause.md | Pause |

| "resume", "continue", "pick up where I left off", "what was I doing", "continue work", "where did I leave off", "what's next" | resume.md | Resume |

Instructions

• Identify the user's planning task from their message
• Load the matching reference file from the table above
• Follow the instructions in that reference file exactly