skill-planner

This skill activates when:

• Task status allows planning (not_started, researched)
• /plan command is invoked
• Implementation approach needs to be formalized

1. Context Gathering

Collect all relevant information:

• Task description and requirements
• Research reports (if available)
• Related codebase context
• Dependencies and constraints

2. Scope Analysis

Determine implementation scope:

• Files to create/modify
• Dependencies to add
• Integration points
• Testing requirements

3. Phase Decomposition

Break work into logical phases:

• Each phase: 1-3 hours of work
• Each phase: Independently verifiable
• Each phase: Clear deliverables
• Typically: 2-5 phases total

4. Risk Assessment

Identify potential issues:

• Technical risks
• Dependency risks
• Integration risks
• Mitigation strategies

```

1. Receive task context
2. Load research reports if available
3. Analyze codebase for integration points
4. Decompose into phases
5. Define steps for each phase
6. Identify risks and mitigations
7. Create plan document
8. Return results

```

Create plan at .claude/specs/{N}_{SLUG}/plans/implementation-{NNN}.md:

```markdown

# Implementation Plan: Task #{N}

Task: {title}

Version: {NNN}

Created: {date}

Language: {language}

{Summary of approach}

Phase 1: {Name}

Estimated effort: {hours}

Status: [NOT STARTED]

Objectives:

1. {Objective}

Files to modify:

• path/to/file - {changes}

Steps:

1. {Step with detail}
2. {Step with detail}

Verification:

• {How to verify completion}

---

Phase 2: {Name}

{Same structure}

• {Dependency}

| Risk | Impact | Mitigation |

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

| {Risk} | {Level} | {Strategy} |

• [ ] {Criterion}

```

```json

{

"status": "completed",

"summary": "Plan created with N phases",

"artifacts": [

{

"path": ".claude/specs/{N}_{SLUG}/plans/implementation-001.md",

"type": "plan",

"description": "Implementation plan"

}

],

"phases": [

{"name": "Phase 1", "effort": "2 hours"},

{"name": "Phase 2", "effort": "1 hour"}

],

"total_effort": "3 hours"

}

```