---

name: writing-plans description: AI agent creates structured implementation plans with task breakdown, dependency mapping, risk assessment, and file-level detail. Use when planning features, projects, or complex implementations.

Writing Plans

Quick Start

1. Summarize - Executive summary with goals, non-goals, background
2. Design - High-level approach, architecture diagram, key decisions
3. Break Down - Tasks in 2-4 hour chunks with file locations
4. Map Dependencies - Identify critical path and parallel opportunities
5. Assess Risks - Likelihood x Impact matrix with mitigations
6. Estimate - Three-point estimation with buffers

Features

Common Patterns

Copy# Plan Structure
# Plan: [Feature Name]

## Metadata
- Status: Draft | Approved | In Progress
- Estimated Duration: [X days]
- Priority: P0 | P1 | P2

## Goals & Non-Goals
Goals: [What this WILL accomplish]
Non-Goals: [What this will NOT address]

## Design Overview
[High-level approach, architecture diagram]

## Implementation Tasks

### Phase 1: [Foundation] - [X days]
#### Task 1.1: [Name]
- Description: [What]
- Estimate: [X hours]
- Files: `src/file.ts:45-60`
- Dependencies: None
- Acceptance Criteria:
  - [ ] [Criterion 1]
  - [ ] [Criterion 2]

## Risks & Mitigations
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [Risk] | High | High | [Strategy] |

Copy# Dependency Diagram
           [START]
              |
   +----------+----------+
   |          |          |
[Task 1]  [Task 2]  [Task 3]  <- Parallel
   |          |          |
   +-----+----+          |
         |               |
      [Task 4]      [Task 5]
         |               |
         +-------+-------+
                 |
            [Task 6]      <- Integration
                 |
            [COMPLETE]

Critical Path: 1 -> 4 -> 6 (determines min duration)

Copy# Effort Estimation
Three-Point: (Optimistic + 4*MostLikely + Pessimistic) / 6

Example - OAuth Implementation:
- Optimistic: 4 hours (works first try)
- Most Likely: 8 hours (normal dev)
- Pessimistic: 16 hours (issues)
Estimate = (4 + 32 + 16) / 6 = 8.7 hours

Buffers:
- Individual tasks: 20%
- Phase total: 30%
- Project total: 40%

Best Practices

Related Skills

• executing-plans - Follow plans systematically
• thinking-sequentially - Structure reasoning for plans
• brainstorming-ideas - Generate options for plans
• verifying-before-completion - Validate plan completion