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.