# writing-plans

> Claude/Codex skill by [@obra](https://omgskills.com/library/obra/index.md) · 301k stars · 303k installs · Updated 2026-10-10

Use when you have a spec or requirements for a multi-step task, before touching code

Tags: ai, brainstorming, coding, obra, sdlc, skills, subagent-driven-development, superpowers

## Install

```sh
git clone https://github.com/obra/superpowers /tmp/superpowers && ln -s /tmp/superpowers/skills/writing-plans ~/.claude/skills/writing-plans
```

## From README

Writing Plans Overview Write implementation plans for an engineer who has not seen this codebase or this spec. Assume they write idiomatic code in the project's language once they know the exact interface and the exact test, and that they will make a reasonable choice wherever the plan leaves one open. What they cannot know is what you decided: which files, which names and signatures, which values from the spec, which tests prove each task. Document those. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits. Announce at start: "I'm using the writing-plans skill to create the implementation plan." Context: If working in an isolated worktree, it should have been created via the superpowers:using-git-worktrees skill at execution time.

## Links

- HTML page: https://omgskills.com/library/obra/superpowers/writing-plans/
- GitHub: https://github.com/obra/superpowers
- Author: [@obra](https://omgskills.com/library/obra/index.md)

## More from this repo

- [systematic-debugging](https://omgskills.com/library/obra/superpowers/systematic-debugging/index.md) — Used when encountering any bug, test failure, or unexpected behavior, before proposing fixes
   - [@obra](https://omgskills.com/library/obra/index.md) · 317k stars
- [executing-plans](https://omgskills.com/library/obra/superpowers/executing-plans/index.md) — Used when executing an implementation plan in the current session as the implementer yourself — your human partner...
   - [@obra](https://omgskills.com/library/obra/index.md) · 308k stars
- [subagent-driven-development](https://omgskills.com/library/obra/superpowers/subagent-driven-development/index.md) — Used when executing implementation plans with independent tasks in the current session
   - [@obra](https://omgskills.com/library/obra/index.md) · 308k stars