Writing Plans

Overview

Write comprehensive step-by-step plans that break complex tasks into small, actionable steps. Each step should be clear enough to execute without additional context.

Announce at start: "I'm using the writing-plans skill to create the implementation plan."

Save plans to: plans/<date>-<topic>.md in user's workspace

Bite-Sized Task Granularity

Each step is one small action:

• "Search for relevant information about X"
• "Create the outline document"
• "Write the introduction section"
• "Review and refine the content"
• "Send the result to user"

Bad examples (too vague):

• "Do the research" - too broad
• "Write the document" - needs breakdown
• "Handle the data" - unclear

Plan Document Header

Every plan MUST start with this header:

# [Task Name] Plan

**Goal:** [One sentence describing what this accomplishes]

**Approach:** [2-3 sentences about how we'll do it]

**Output:** [What will be delivered]

---

Task Structure

### Task N: [Component Name]

**Files involved:**
- Create: `exact/path/to/file.ext`
- Read: `exact/path/to/source.ext`
- Output: `exact/path/to/result.ext`

**Step 1: [Action]**
[Clear description of what to do]

**Step 2: [Action]**
[Clear description of what to do]

**Step 3: Verify**
[How to check this task is complete]

Remember

• Exact file paths always
• Clear descriptions (not "do the thing")
• Include verification steps
• Break large tasks into smaller ones
• Keep it simple - don't over-complicate

Execution Handoff

After saving the plan, offer execution choice:

"Plan complete and saved to plans/<filename>.md. Ready to start execution?"

If user confirms:

• Use executing-plans skill to work through tasks
• Execute tasks one by one
• Report progress after each task