Writing Plans

Generate granular implementation plans with TDD steps and exact commands.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fz42net/superpowers-skills --skill writing-plans-fz42net
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Writing Plans
Source: https://github.com/fz42net/superpowers-skills/tree/main/skills/collaboration/writing-plans
Command: npx skills add https://github.com/fz42net/superpowers-skills --skill writing-plans-fz42net

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Handoffs to engineers (especially those new to a codebase) often lack sufficient detail, leading to confusion, incorrect implementations, and delays. This skill creates highly granular, self-contained implementation plans.

Core Features & Use Cases

  • Zero-Context Assumption: Plans are written for engineers with no prior codebase knowledge.
  • Bite-Sized Tasks: Each step is a single, actionable item (2-5 minutes), including TDD steps (write failing test, implement, run tests, commit).
  • Comprehensive Detail: Specifies exact file paths, complete code snippets, and precise commands with expected outputs.
  • Standardized Format: Ensures plans are consistent and easy to follow, including a mandatory header.
  • Execution Handoff: Offers options for subagent-driven or parallel session execution once the plan is complete.
  • Use Case: After a design is approved, you use this skill to generate a step-by-step implementation plan for a new feature. This plan includes every detail, from writing the first failing test to the final commit, ensuring any developer can execute it flawlessly.

Quick Start

  1. Announce: "I'm using the Writing Plans skill to create the implementation plan."
  2. The AI will generate a plan in docs/plans/YYYY-MM-DD-<feature-name>.md.
  3. The plan will include a header, followed by bite-sized tasks, each with:
    • Files to create/modify/test
    • Step-by-step instructions (e.g., "Write the failing test", "Run test", "Write minimal implementation", "Run test", "Commit")
    • Exact code snippets and commands.
  4. Once complete, the AI will offer options for plan execution (subagent or parallel session).