writing-plans

Generate implementation plans with task lists, file touchpoints, tests, and commit guidance.

70|6|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/earchibald/vsc-superpowers --skill writing-plans-earchibald
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/earchibald/vsc-superpowers/tree/main/.agents/skills/write-plan
Command: npx skills add https://github.com/earchibald/vsc-superpowers --skill writing-plans-earchibald

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform scattered specifications and requirements into a clear, executable plan that guides implementation, testing, and documentation.

Core Features & Use Cases

  • Structured planning: converts specs into a task-by-task plan with file touchpoints, tests, and docs.
  • Save and reference: stores plans in docs/plans/YYYY-MM-DD-<feature-name>.md for versioned reference.
  • TDD-aligned workflow: emphasizes test-first steps, small commits, and incremental delivery.

Quick Start

Provide a feature spec or requirements and I will generate a complete implementation plan.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I convert a feature specification into an implementation plan?▼

To convert a feature specification into an implementation plan, provide the spec to generate a comprehensive document with task lists, file touchpoints, tests, and commit guidance for structured execution.

What is the best way to structure a TDD-aligned workflow for software engineering tasks?▼

A TDD-aligned workflow structures software engineering tasks by emphasizing test-first steps, small commits, and incremental delivery within a generated plan document for systematic implementation.

How do I break down a software development task into structured steps?▼

Task breakdown for software development transforms scattered requirements into a step-by-step plan that guides implementation, testing, and documentation through clearly defined executable tasks.

Can I generate planning docs that include file touchpoints and test guidance for bug fixes?▼

Yes, generating planning docs applies to bug fixes and feature development by producing a comprehensive plan document that specifies file touchpoints, required tests, and documentation updates.

Where are generated implementation plans stored for versioned reference?▼

Generated implementation plans are stored as versioned reference files in docs/plans/YYYY-MM-DD-<feature-name>.md to maintain structured planning history.

Does this planning approach work for research tasks that require structured steps?▼

Yes, this planning approach works for research tasks by generating comprehensive implementation plans that translate requirements into structured steps with task lists and documentation guidance.