writing-plans

Generates detailed multi-task implementation plans with TDD steps from specs before coding.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/kxnzee/multi-repo-specs --skill writing-plans-kxnzee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/kxnzee/multi-repo-specs/tree/main/extensions/superpowers/skills/writing-plans
Command: npx skills add https://github.com/kxnzee/multi-repo-specs --skill writing-plans-kxnzee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often start coding from a spec without a concrete plan, leading to missed requirements, vague tasks, and inconsistent implementations. This Skill turns a spec or requirements document into a complete, bite-sized implementation plan that an engineer with zero codebase context can follow task by task. ## Core Features & Use Cases - Structured Plan Generation: Produces a plan document with goal, architecture, tech stack, global constraints, and per-task file lists, interfaces, and checkbox steps. - TDD Task Decomposition: Breaks work into right-sized tasks where each step is a 2-5 minute action: write failing test, verify failure, implement, verify pass, commit. - Placeholder-Free Enforcement: Forbids TODOs and vague steps, requiring exact file paths, complete code blocks, and exact commands with expected output. - Self-Review and Handoff: Includes a spec-coverage, placeholder, and type-consistency self-review, plus an execution handoff to subagent-driven or inline execution workflows. - Use Case: Given a feature spec for a new API endpoint, produce a dated plan file in docs/superpowers/plans/ with tasks covering tests, implementation, and commits, ready for an executor agent. ## Quick Start Ask the agent to use the writing-plans skill to create an implementation plan from your spec before writing any code.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I write an implementation plan from a spec before coding?▼

Provide the spec or requirements and invoke the writing-plans skill before touching code. It produces a plan document with a goal, architecture, global constraints, and tasks broken into test-first steps with exact file paths, code, and commit commands.

How granular should tasks be in a software implementation plan?▼

Each step should be a single 2-5 minute action such as writing a failing test, running it, implementing minimal code, verifying it passes, and committing. Tasks are right-sized so each ends with an independently testable deliverable a reviewer could approve or reject.

Where are generated implementation plans saved?▼

Plans are saved to docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md by default. User preferences or a calling workflow's supplied output path override this default location.

Can a plan cover multiple subsystems in one document?▼

No. If the spec spans multiple independent subsystems, the skill suggests splitting it into separate plans, one per subsystem, so each plan produces working, testable software on its own.

What happens after the implementation plan is finished?▼

For standalone plans, the skill offers an execution handoff: subagent-driven development with a fresh subagent per task and reviews, or inline execution with batch checkpoints. When called by another workflow, it returns to the caller without starting execution.