writing-plans

Generate implementation plans from feature specs with testable tasks.

1|Updated May 28, 2026
One-click install
npx skills add https://github.com/amoutiers/maxi-superpowers --skill writing-plans-amoutiers
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/amoutiers/maxi-superpowers/tree/main/skills/writing-plans
Command: npx skills add https://github.com/amoutiers/maxi-superpowers --skill writing-plans-amoutiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert a specification or requirements into a comprehensive, task-based plan that guides implementation end-to-end, leaving engineers with a clear road map.

Core Features & Use Cases

  • Decompose a spec into bite-sized tasks with explicit file touchpoints, tests, docs, and commit history.
  • Enforce DRY, YAGNI, and TDD principles across planning, execution, and review.
  • Provide a reusable, auditable plan structure that can be reused across projects and teams.

Quick Start

Provide a detailed implementation plan for a feature by outlining required files, tests, and the commit sequence.

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 spec into an actionable implementation plan?▼

To turn a feature spec into an implementation plan, decompose requirements into bite-sized, testable tasks with explicit file touchpoints, tests, and commit history. This provides a clear roadmap guiding end-to-end execution while preserving DRY and TDD principles.

What is test-driven planning in software engineering?▼

Test-driven planning is decomposing feature specifications into task-based roadmaps where each task defines explicit tests and interfaces before implementation. It ensures plans are auditable and bite-sized, enforcing TDD, DRY, and YAGNI principles across execution and review.

How do I break down work into testable tasks for an existing codebase?▼

Break down work for an existing codebase by mapping specification requirements to specific file touchpoints and interfaces. Create a project-wide plan header that outlines the required tests, documentation, and commit sequence for each isolated task.

Does spec-to-plan task decomposition work for both new features and existing codebases?▼

Yes, task decomposition from a spec works for both new features and existing codebases. It generates a comprehensive, reusable plan structure by mapping required file changes, tests, and documentation across diverse engineering teams.

What's the best way to enforce DRY and YAGNI principles during project planning?▼

The best way to enforce DRY and YAGNI principles during planning is to use a structured plan layout that decomposes specifications into isolated, testable tasks. This prevents over-engineering by defining strict file touchpoints and test interfaces upfront.

Can I generate a commit sequence and documentation map from a feature specification?▼

Yes, you can generate a commit sequence and documentation map from a feature specification. Decomposing the spec into a comprehensive plan provides explicit commit history and file touchpoints for each task, leaving engineers with a clear roadmap.