Writing Plans

协作类

Use when you have a spec or requirements to implement a multi-step task, before touching any code.

Quick Start

Understand in 30 Seconds

Write comprehensive implementation plans assuming engineers have zero context about the codebase. Document everything they need to know.

When to Use

• Have specification document to implement
• Multi-step tasks need decomposition
• Need clear implementation guidance for other developers

Quick Example

Task Structure:

### Task N: [Component Name]

**Files:**
- Create: `exact/path/to/file.py`

- [ ] **Step 1: Write failing test**

---

Complete Guide

Core Principle

Write comprehensive implementation plans assuming engineers have zero context about the codebase and questionable taste.

Task Granularity

Each step is one action (2-5 minutes):

• "Write failing test" - step
• "Run it to ensure failure" - step
• "Implement minimal code to pass test" - step
• "Run test to ensure pass" - step
• "Commit" - step

Remember

• Always use exact file paths
• Include complete code in plan
• Exact commands and expected output
• DRY, YAGNI, TDD, frequent commits

Related Skills

Prerequisite Skills

• brainstorming - Brainstorming to form design

Follow-up Skills

• executing-plans - Execute plans
• subagent-driven-development - Subagent-driven development