writing-plans

Convert feature specifications into test-driven implementation plans with file paths and execution steps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a vague or complex multi-step spec into a clear, executable implementation plan that an engineer can follow without needing prior context.

Core Features & Use Cases

  • Multi-step implementation planning: Breaks work into bite-sized, test-driven tasks with explicit file creation/modification/testing guidance.
  • Context-aware handoff: Assumes minimal knowledge of the codebase and specifies exactly what to check, where to change, and how to verify.
  • Plan artifacts for delivery: Saves plans to a predictable location under docs/superpowers/plans for later execution or review.

Quick Start

Use the writing-plans skill to generate an implementation plan for your multi-step feature using the spec you already have.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn a feature specification into a test-driven implementation plan?

Implementation planning for multi-step engineering tasks breaks work into bite-sized, test-driven tasks that specify exactly what to check, where to change files, and how to verify the results.

How do I break down a complex software refactor into executable tasks?

Breaking down a complex software refactor into executable tasks involves decomposing the spec into bite-sized steps with explicit file creation, modification, and testing guidance so an engineer can execute without prior codebase context.

Can I generate an implementation plan for a new feature without prior codebase context?

Yes, you can generate an implementation plan without prior codebase context because the plan provides context-aware handoff by specifying exact file paths, code blocks, and verification commands for each execution step.

What is the best way to structure task decomposition for multi-step engineering work?

The best way to structure task decomposition for multi-step engineering work is using a structured plan format that defines exact file paths, test strategy, and command blocks for each bite-sized implementation step.

Where are generated implementation plan artifacts saved for later execution?

Generated implementation plan artifacts are saved to a predictable location under docs/superpowers/plans, ensuring the task decomposition specifications are available for later review or engineering handoff execution.