superpowers-writing-plans

Generate dated Markdown implementation plans with testable tasks from specs.

2|1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-writing-plans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-writing-plans
Source: https://github.com/aldoborrero/agent-kit/tree/main/skills/superpowers/writing-plans
Command: npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-writing-plans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans multi-step engineering tasks from a clear spec or requirements to produce actionable tasks, ensuring nothing is missed before coding.

Core Features & Use Cases

  • Generates bite-sized, task-level plans that identify touched files, code, tests, and docs.
  • Enforces DRY, YAGNI, and TDD principles while outlining clear milestones and commits.
  • Saves the final plan to a dated, feature-named Markdown document at docs/plans/YYYY-MM-DD-<feature-name>.md.

Quick Start

Provide a feature spec and run this skill to generate a complete implementation plan saved to docs/plans/YYYY-MM-DD-<feature-name>.md.

Frequently Asked Questions about superpowers-writing-plans

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

FAQPage Schema
How do I generate an implementation plan from a feature spec?

To generate an implementation plan from a feature spec, provide your high-level requirements to produce a structured task breakdown saved as a dated Markdown document in the docs/plans directory. This plan outlines bite-sized, testable steps for engineers.

What is the best way to break down multi-step engineering tasks for TDD?

Breaking down multi-step engineering tasks for TDD involves splitting high-level requirements into bite-sized, testable steps that identify touched files, code, tests, and docs. This structured task breakdown enforces DRY, YAGNI, and TDD principles while outlining clear milestones and commits.

Does this plan generation workflow require any specific dependencies or components?

This plan generation workflow requires no external dependencies or components. It operates using a frontmatter-based YAML Skill entry to process your feature spec and output the final versioned plan delivery directly to your filesystem.

How does the generated implementation plan get saved and versioned?

The generated implementation plan gets saved and versioned by writing the final Markdown document to docs/plans with a date stamp and feature name. This creates a dated, feature-named file at docs/plans/YYYY-MM-DD-<feature-name>.md for versioned plan delivery.

Can I use this task planning approach for projects starting from high-level requirements?

Yes, you can use this task planning approach for projects starting from high-level requirements. It applies specifically to projects needing bite-sized, testable steps, documentation, and versioned plan delivery before the actual coding begins.

Why should I use a dedicated workflow for implementation plan generation instead of manual outlining?

Using a dedicated workflow for implementation plan generation ensures nothing is missed before coding by systematically enforcing DRY, YAGNI, and TDD principles. It transforms a clear spec into actionable tasks with identified touched files, tests, and clear milestones for frequent commits.