writing-plans

Generate detailed TDD implementation plans from software specs.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/xxih/ai-harness-zh --skill writing-plans-xxih
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/xxih/ai-harness-zh/tree/main/references/translations/superpowers/skills/writing-plans
Command: npx skills add https://github.com/xxih/ai-harness-zh --skill writing-plans-xxih

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a spec or requirement exists but engineers lack context, this Skill converts high-level requirements into a clear, step-by-step implementation plan that any competent developer can follow without prior domain knowledge. It eliminates ambiguous instructions, placeholder tasks, and missing test details so work can be executed reliably and reviewed consistently.

Core Features & Use Cases

  • Standardized plan header and metadata: enforces a consistent plan document with goal, architecture, tech stack, and file paths.
  • File-level breakouts and tiny actionable steps: specifies exact files to create or modify, test code, commands to run, expected outputs, and commit steps.
  • TDD-first task structure and self-checks: structures each task as write failing test -> implement -> verify -> commit and provides a checklist to detect placeholders and mismatches with the spec.
  • Execution options: supports subagent-driven or inline execution workflows and advises on using isolated worktrees and where to save plans.
  • Use case: converting a multi-component feature spec into a series of small, test-driven tasks saved under docs/superpowers/plans for subagent implementation.

Quick Start

Create an implementation plan from the provided spec and save it to 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 generate an implementation plan from a software spec?

To generate an implementation plan from a software spec, provide the feature requirements to produce a detailed, executable document with exact file-level changes, test code, commands, and commit instructions. This breakdown eliminates ambiguous instructions and ensures reliable execution.

How do I break down feature development into atomic TDD steps?

Breaking down feature development into atomic TDD steps involves structuring each task sequentially as write failing test, implement code, verify execution, and commit. This ensures precise file modifications and creates a self-check checklist to detect placeholders and mismatches with the spec.

Can I use subagent execution workflows with implementation plans?

Yes, you can use subagent execution workflows with implementation plans by supporting subagent-driven or inline execution options. The generated plans advise on using isolated worktrees and saving the documents under docs/superpowers/plans for reliable subagent implementation.

What is the best way to standardize engineering docs for task breakdown?

The best way to standardize engineering docs for task breakdown is to enforce a consistent plan document header containing the goal, architecture, tech stack, and file paths. This metadata provides essential context so any developer can execute the work without prior domain knowledge.

Does this implementation planning approach work for multi-component features?

Yes, this implementation planning approach works for multi-component features by converting complex specs into a series of small, test-driven tasks. It specifies exact files to create or modify and maps out runnable test steps with expected outputs for consistent review.