Skills DirectoryCurated open-source Skills from GitHub
English

writing-planscommit 8ca22dbSKILL.md · Task Breakdown

Writing Plans

Turns a spec or requirements into an implementation plan of bite-sized TDD tasks, each naming exact files, interfaces and tests.

npx skills add obra/superpowers --skill writing-plans
Permissions
  • read-repo
  • write-files
  • shell
  • network
Compatible with
Claude Code, Codex, Cursor, Gemini CLI, OpenCode
GitHub
310.3k
Source
Community · Jesse Vincent
Status
Scan passed
License
MIT
Category
Task Breakdown
Repository
github.com/obra/superpowers/skills/writing-plans

Core rule

Every step must let the implementer write exactly one reasonable thing, with no line that decides nothing and no code the signature and tests already determine.

Execution Phases

  1. Phase 01Check scope

    If the spec covers several independent subsystems, suggest one plan per subsystem, each producing working, testable software.

  2. Phase 02Map file structure

    List which files will be created or modified and what each is responsible for, splitting by responsibility and following existing patterns.

  3. Phase 03Write the tasks

    Using the required header and task template, give each task its files, interfaces and TDD steps: failing test, run, minimal code, run, commit.

  4. Phase 04Self-review

    Check the plan against the spec for coverage, step clarity, type consistency, Review Focus and proportion, and fix issues inline.

  5. Phase 05Hand off

    Save to docs/superpowers/plans/, ask the user to review it and choose between Subagent-driven and Native execution.

Permissions (summarised from SKILL.md)

CapabilityNeededDetails
File writesLimitedWrites only the plan document, by default under docs/superpowers/plans/; no code changes.
Command executionNot requiredTest and commit commands are written into the plan, not run by this skill.
Network outboundNot requiredWorks only from the local spec and codebase; no network access.

SKILL.md frontmatter (YAML)

SKILL.md frontmatter (YAML)commit 8ca22db
---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code
---

Related skills

A rule scan cannot catch every risk. Read this skill's SKILL.md and check its permissions before installing.
Markdown version GitHub