writing-plans

Generates detailed multi-step implementation plans with TDD tasks from feature specifications.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/marcocpt/trae_skills --skill writing-plans-marcocpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/marcocpt/trae_skills/tree/main/writing-plans
Command: npx skills add https://github.com/marcocpt/trae_skills --skill writing-plans-marcocpt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature specification into working code often fails because engineers (or AI agents) lack codebase context and jump into coding without a structured approach. This Skill converts a spec into a complete, step-by-step implementation plan with exact file paths, real code, test commands, and commit points, so implementation can proceed without ambiguity. ## Core Features & Use Cases - Spec-to-Plan Conversion: Transforms a requirements document into a plan saved at docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md with goal, architecture, and tech stack headers. - Fine-Grained TDD Task Breakdown: Splits work into 2-5 minute steps following the write-failing-test, verify-failure, implement, verify-pass, commit cycle, with checkbox tracking. - Placeholder-Free Enforcement and Self-Check: Forbids TODOs and vague steps, then runs a self-review for spec coverage, placeholder scanning, and type/name consistency across tasks. - Use Case: After brainstorming a new API feature, use this Skill to produce a plan where each task lists exact files to create or modify, complete test and implementation code, pytest commands with expected output, and git commit commands, ready for subagent-driven or inline execution. ## Quick Start Ask the AI to use the writing-plans skill to create an implementation plan from your feature specification document.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I write an implementation plan from a feature specification?

Start with a plan header stating the goal, architecture, and tech stack, then list the files to create or modify with their responsibilities. Break the work into tasks where each step is a 2-5 minute action: write a failing test, run it, implement minimal code, verify it passes, and commit.

How to break a coding task into TDD steps for an AI agent?

Use the red-green-commit cycle as individual steps: write the failing test with actual test code, run it with an exact command and expected failure, write the minimal implementation code, rerun the test expecting a pass, then commit with a specific git command. Each step must include real code, not descriptions.

What makes an implementation plan unusable for engineers?

Plans fail when they contain placeholders like TODO or 'add appropriate error handling', reference undefined types or functions, or describe what to do without showing the code. Every step needs exact file paths, complete code blocks, and precise commands with expected output.

When should a specification be split into multiple implementation plans?

Split the spec when it covers multiple independent subsystems. Each plan should independently produce working, testable software, so one plan per subsystem keeps tasks focused and deliverables verifiable.

How do I verify an implementation plan covers the full specification?

Perform a self-check after writing: walk through every spec section and confirm a task implements it, scan for placeholder patterns, and verify type and method names stay consistent across tasks. Fix issues inline and add tasks for any uncovered requirements.