writing-plans

Use when design is complete and you need detailed implementation tasks for engineers with minimal codebase familiarity. Creates comprehensive guides with exact file paths, code examples, and verification steps.

Task Granularity: Each step represents 2-5 minutes of work, breaking down features into atomic actions like writing failing tests, implementing solutions, and committing changes.

Documentation Standard: Plans follow a mandatory header format including goal, architecture, and tech stack, followed by numbered tasks with file locations, code snippets, and exact command sequences.

```markdown

# Feature Name

[One sentence: what this accomplishes]

[How this fits in the system]

• [Libraries/frameworks used]

1. [Task name]

File: path/to/file.ts

[What to do]

Code:

```typescript

[Exact code or snippet]

```

Verify:

```bash

[Commands to run]

```

Commit: [commit message]

2. [Next task...]

```

• DRY - Don't Repeat Yourself
• YAGNI - You Aren't Gonna Need It
• TDD - Test-Driven Development
• Frequent commits - One task, one commit

After completion, offer two implementation paths:

1. Subagent-Driven — Dispatch fresh agents per task with reviews within the current session
2. Parallel Session — Guide toward separate sessions using the executing-plans skill

• Design phase is complete
• Need step-by-step implementation guide
• Working with engineers unfamiliar with codebase
• Breaking down complex features
• Ensuring consistent implementation approach

• Exact file paths (no vague locations)
• Complete code snippets (not pseudocode)
• Verification commands
• Expected outputs
• Commit messages for each step
• Dependencies between tasks
• Edge cases to handle

Save to: docs/plans/YYYY-MM-DD-.md