Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions skills/writing-plans/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,15 @@ Assume they are a skilled developer, but know almost nothing about our toolset o

If the spec covers multiple independent subsystems, it should have been broken into sub-project specs during brainstorming. If it wasn't, suggest breaking this into separate plans — one per subsystem. Each plan should produce working, testable software on its own.

## Context Gathering

Gather only the context needed to write the plan — don't explore the entire codebase.

- **Always read:** The spec/requirements document
- **Read selectively:** Only files directly referenced by the spec or that you'll need to modify
- **Don't:** Launch broad codebase exploration agents, read unrelated modules, or list entire directories
- **Rule of thumb:** If you need more than ~5 targeted file reads before writing, you're probably over-gathering. The plan should document what the *implementer* needs, not require the *planner* to have read everything first.

## File Structure

Before defining tasks, map out which files will be created or modified and what each one is responsible for. This is where decomposition decisions get locked in.
Expand Down