---
stable_id: skills/obra-writing-plans
type: skills
title: obra-writing-plans
summary: >-
  ---

  name: writing-plans

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

  ---

  # Writing Plans

  ## Overview

  Write comprehensive implementation plans assuming the engineer has zero
  context for our codebase and questionable taste. Document everything they need
  to know: which files to touch for each task, code, testing, docs they might
  need to check, how to test it. Give them the whole plan as bite-sized tasks.
  DRY. YAGNI. TDD. Frequent commits.

  Assume they are a skilled developer, but know almost nothing about our toolset
  or problem domain. Assume they don't know good test design very well.

  **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.
tags:
  - obra
  - source-obra-superpowers
source_url: https://raw.githubusercontent.com/obra/superpowers/main/skills/writing-plans/SKILL.md
license: ""
upstream_ref: https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md
github_stars: 101712
github_forks: 8129
github_is_organization: false
retrieved_at: 2026-06-11T08:33:18.244Z
content_sha256: 4fd4627d2c02367879c0307d7249270bed633317ff9be82e926a6d57bf5d331b
---
