# Why write a plan when the agent could just start?

Canonical URL: https://bestskillsforclaude.com/en/skills/writing-plans
Language: en
Skill: writing-plans
Publisher: Jesse Vincent (obra) (https://github.com/obra)
Source: https://github.com/obra/superpowers
License as stated by the publisher: MIT
Runtime: Claude Code and other supported coding agents
Category: Planning and teamwork
Last reviewed: 2026-08-05

Because the plan is the only part of the work that survives a lost context.

## Short answer
The writing-plans skill produces detailed task breakdowns before implementation, so the work has a checkable structure rather than living inside one conversation. It is the single most useful planning skill for long tasks, because a written plan is what lets a new session, or a different agent, continue without starting over.

Best for: Multi step work, anything spanning sessions, and tasks you might hand to someone else.
Skip it if: The change is small enough to finish in one sitting and describe in one sentence.

## What to remember
- A plan is the recovery mechanism when context is lost, which happens constantly on long work.
- Steps without a definition of done are wishes, not steps.
- Reviewing a plan is far cheaper than reviewing a finished implementation.
- It is the natural bridge between brainstorming and subagent driven development.

## What it changes in practice
Long agent tasks fail in a specific way: the conversation grows, earlier decisions fall out of context, and the agent starts contradicting work it did an hour ago. A plan on disk is immune to that, because it is re-read rather than remembered.
It also makes disagreement cheap. Arguing about a plan takes minutes, while arguing about a finished implementation costs whatever it took to build.

## Where it disappoints
Plans go stale. A plan that no longer matches the code is worse than none, because it is trusted, so update it when reality diverges.
Over planning is real too. Small work does not need a document, and producing one is procedure for its own sake.

## Install and first run
1. Install superpowers from obra/superpowers, published under MIT.
2. Insist that each step names a file or a component and a way to tell that it is done.
3. Keep the plan in the repository, so it is reviewable and survives the session.

## Questions
### Where should the plan live?
In the repository, so it can be reviewed, versioned and re-read by another session or another agent.

### What makes a step good?
A named target and a way to tell it is finished. Without that, progress cannot be checked.

### When is planning too much?
When the task fits in one sitting and one sentence. Then the plan is ceremony.

## Sources
- obra/superpowers on GitHub: https://github.com/obra/superpowers
- Agent skills directory listing: https://skills.sh

## Other languages
- Spanish: https://bestskillsforclaude.com/es/skills/writing-plans
- Brazilian Portuguese: https://bestskillsforclaude.com/pt-br/skills/writing-plans
- Japanese: https://bestskillsforclaude.com/ja/skills/writing-plans