writing-plans

Creates granular, task-based implementation plans with file changes and testing strategies before coding.

8|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/dxc-danny/superpowers-cn --skill writing-plans-dxc-danny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/dxc-danny/superpowers-cn/tree/main/skills/writing-plans
Command: npx skills add https://github.com/dxc-danny/superpowers-cn --skill writing-plans-dxc-danny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides engineers to create a comprehensive, granular implementation plan for a multi-step task before any code is written. It assumes developers have limited context about the codebase and emphasizes DRY, YAGNI, and TDD while documenting every required file change, testing steps, and documentation.

Core Features & Use Cases

  • Granular task breakdown: translate specs into small, verifiable steps and file changes.
  • Plan-first workflow: establish a dedicated worktree and ensure tasks are independent and testable.
  • TDD-aligned execution plan: guide developers to write failing tests first, then implement and iterate.

Quick Start

Begin by creating a granular, task-based implementation plan in a dedicated worktree based on the provided spec before touching 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 plan multi-step tasks before coding across multiple files?

To plan multi-step tasks before coding, break specifications into small, verifiable steps with precise file mappings and testing strategies. This enforces DRY, YAGNI, and TDD principles while establishing clear task boundaries and documenting required changes.

What is the best way to break down feature specifications for TDD?

The best way to break down features for TDD is creating a granular, task-based implementation plan that guides you to write failing tests first, then implement and iterate. This aligns execution with test-driven development workflows.

How do I ensure tasks are independent and testable in a worktree?

To ensure tasks are independent and testable in a worktree, establish a plan-first workflow that defines clear task boundaries before touching any code. This isolates multi-step features spanning multiple subsystems.

When do I need a granular implementation plan for multi-step features?

You need a granular implementation plan for multi-step features that span multiple files or subsystems where you have limited codebase context. It requires documenting every file change, testing step, and evidence of progress upfront.

Does plan-first task splitting work without deep codebase knowledge?

Yes, plan-first task splitting works without deep codebase knowledge because it assumes developers have limited context and emphasizes documenting every required file change and testing step before writing any code.

What are the limitations of writing detailed plans before touching any code?

A limitation of writing detailed plans before touching code is the overhead required for multi-step tasks. It enforces strict DRY, YAGNI, and TDD principles with specific checkpoints, which may not suit rapid prototyping or single-file changes.