writing-plans

Generate implementation plans with file paths, code samples, tests, and verification steps.

Updated Jul 14, 2025
One-click install
npx skills add https://github.com/woodrowpearson/mids-hero-web --skill writing-plans-woodrowpearson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/woodrowpearson/mids-hero-web/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/woodrowpearson/mids-hero-web --skill writing-plans-woodrowpearson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill empowers teams to convert design into executable work by producing comprehensive, step-by-step implementation plans for engineers who may have little context about the codebase. It ensures all necessary details—file paths, code snippets, tests, and documentation—are captured in a single, reproducible plan.

Core Features & Use Cases

  • Deterministic planning: Produce bite-sized tasks with exact file locations, required changes, and concrete code examples.
  • Verification-driven: Include testing steps and acceptance criteria to verify each task.
  • Documentation-ready: Generate references to docs and commit histories, enabling traceability across the project.

Quick Start

Announce at start: "I'm using the writing-plans skill to create the implementation plan." Then, generate a plan document saved at docs/plans/YYYY-MM-DD-<feature-name>.md, containing a header, task sections, and step-by-step actions.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate implementation plans for software features with exact file paths and code samples?

To generate implementation plans, this skill produces detailed, actionable documents containing exact file locations, required code changes, concrete samples, and verification steps. It enforces TDD, DRY principles, frequent commits, and saves the plan to docs/plans/YYYY-MM-DD-<feature-name>.md.

What is the best way to create a step-by-step engineering plan for developers with minimal codebase context?

The best way to create an engineering plan for developers lacking context is generating bite-sized, deterministic tasks with exact file paths, code snippets, and testing steps. This ensures all necessary implementation details are captured in a single, reproducible markdown document.

How do I write a software implementation plan that enforces TDD and DRY principles?

Writing an implementation plan that enforces TDD and DRY principles involves generating step-by-step tasks that include required code changes, concrete examples, and verification testing steps. The plan also references documentation and commit histories to ensure project traceability.

Does this implementation planning skill work for teams that have already completed design but need execution steps?

Yes, this implementation planning skill works for teams that have completed design but need execution steps. It converts design into executable work by producing comprehensive plans detailing file paths, code snippets, tests, and documentation for engineers with minimal context.

How do I include verification and acceptance criteria when documenting code implementation plans?

To include verification and acceptance criteria when documenting code implementation plans, the skill generates verification-driven tasks. Each task section contains step-by-step actions, required testing steps, and acceptance criteria to verify the implementation across the repository.

Why does my software implementation plan need exact file paths and frequent commit references?

Your software implementation plan needs exact file paths and frequent commit references to ensure deterministic planning and traceability. These elements allow engineers with minimal context to accurately implement, test, and document features while maintaining DRY principles across the repository.