writing-plans

Generate implementation plans from formal specs with file mapping and task decomposition.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/steltz/skill-factory --skill writing-plans-steltz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/steltz/skill-factory/tree/main/references/superpowers/skills/writing-plans
Command: npx skills add https://github.com/steltz/skill-factory --skill writing-plans-steltz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document comprehensive implementation plans from a formal spec to guide multi-step software work, ensuring nothing is missed before coding begins.

Core Features & Use Cases

  • Map the spec to task-level work, including which files to touch, code changes, tests, docs, and release steps.
  • Ensure consistent task granularity, clear ownership, and structured commit boundaries.
  • Facilitate reproducible work that can be reviewed and handed off across teams.

Quick Start

To start planning a feature, provide your spec and run the plan generator to produce a plan at docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan from a software spec?

To create an implementation plan from a software spec, you provide the formal spec to generate a structured plan document mapping code changes, tests, and release steps. This enforces consistent task granularity and explicit file mapping for reproducible progress.

What is structured task decomposition for multi-step software work?

Structured task decomposition is breaking down a formal spec into task-level work that specifies which files to touch, code changes, tests, docs, and release steps. It ensures consistent task granularity and clear commit boundaries for reviewable progress.

When do I need a plan document before coding begins?

You need a plan document before coding begins when a formal spec exists but code remains unwritten. It documents comprehensive implementation plans covering design, testing, docs, and release steps to ensure nothing is missed during multi-step software work.

Can I use this workflow planning approach for team handoffs?

Yes, you can use this workflow planning approach for team handoffs because it enforces a standard plan header and explicit file mapping. This facilitates reproducible work that can be reviewed and handed off across teams.

What's the best way to map a spec to specific code changes and tests?

The best way to map a spec to code changes and tests is generating a plan document that enforces structured task decomposition and explicit file mapping. This ensures all design, testing, documentation, and release steps are comprehensively covered before coding.