writing-plans

Generates detailed multi-task implementation plans with TDD steps from feature specifications.

3|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/KingMichaelPark/dotfiles --skill writing-plans-kingmichaelpark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/KingMichaelPark/dotfiles/tree/main/ai/.agents/skills/writing-plans
Command: npx skills add https://github.com/KingMichaelPark/dotfiles --skill writing-plans-kingmichaelpark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature spec into code without a plan leads to missed requirements, inconsistent types across tasks, and vague steps that stall implementation. This Skill converts a spec or requirements document into a complete, bite-sized implementation plan that an engineer with zero codebase context can execute task by task. ## Core Features & Use Cases - Structured Plan Generation: Produces a plan document with a required header, global constraints, file structure mapping, and tasks broken into 2-5 minute steps following TDD (failing test, minimal implementation, commit). - Placeholder Prevention: Enforces exact file paths, complete code blocks, and exact commands with expected output, banning TODOs and vague instructions. - Self-Review and Handoff: Runs a spec-coverage, placeholder, and type-consistency checklist, then offers subagent-driven or inline execution of the saved plan. - Use Case: Given a spec for a new API endpoint, generate a dated plan file in docs/superpowers/plans/ with checkboxed tasks covering tests, implementation, and commits, ready for task-by-task execution. ## Quick Start Use the writing-plans skill to turn this feature spec into a step-by-step TDD implementation plan saved under docs/superpowers/plans/.

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 spec?

Start with a plan header stating the goal, architecture, and tech stack, then map the file structure and decompose work into tasks. Each task contains bite-sized TDD steps: write a failing test, run it, implement minimal code, verify it passes, and commit.

How detailed should tasks be in a software implementation plan?

Each step should be one action taking 2-5 minutes, such as writing a single failing test or committing. Every step must include exact file paths, complete code blocks, and exact commands with expected output, with no placeholders like TODO or TBD.

When should a spec be split into multiple implementation plans?

Split when the spec covers multiple independent subsystems. Each plan should produce working, testable software on its own, so one plan per subsystem keeps tasks reviewable and independently deliverable.

What are common mistakes when writing implementation plans?

Common failures include placeholder text like 'add error handling', references to undefined functions, inconsistent type or method names across tasks, and steps that describe what to do without showing the actual code.

How is a finished implementation plan executed?

After saving the plan, choose subagent-driven execution, which dispatches a fresh subagent per task with review between tasks, or inline execution, which runs tasks in the current session in batches with checkpoints.