writing-plans

Generate implementation plans from specs and export them to Markdown files.

Updated Jan 7, 2026
One-click install
npx skills add https://github.com/miles990/claude-starter-kit --skill writing-plans-miles990
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/miles990/claude-starter-kit/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/miles990/claude-starter-kit --skill writing-plans-miles990

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn a concise spec or requirements into a detailed, executable implementation plan before coding, reducing ambiguity and rework.

Core Features & Use Cases

  • Plan generation from a formal spec or user story.
  • Task breakdown into bite-sized steps with clear ownership and acceptance criteria.
  • Plan export to docs/plans/YYYY-MM-DD-<feature-name>.md for archival and review.

Quick Start

Provide a clear feature description or user story to generate a plan. The resulting Plan Document will be saved to docs/plans/YYYY-MM-DD-<feature-name>.md and ready for execution.

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 spec into an implementation plan before coding?

To turn a spec into an implementation plan, provide a clear feature description or user story to generate a comprehensive plan. It breaks down multi-step tasks into bite-sized steps with acceptance criteria and exports a standardized markdown file for archival.

What is the best way to break down multi-step development tasks for a team?

The best way to break down multi-step development tasks is generating a plan that outlines bite-sized steps with clear ownership and acceptance criteria. This reduces ambiguity and rework by validating the blueprint before coding starts.

How does plan generation handle test and documentation outlining from requirements?

Plan generation from requirements handles test and documentation outlining by integrating them directly into the task breakdown. It produces a validated blueprint that ensures engineers account for TDD and docs during implementation.

Do I need a formal spec to generate a task breakdown?

You do not need a formal spec to generate a task breakdown; a clear feature description or user story is sufficient. The tool processes concise requirements to produce a detailed, executable plan for your engineering team.

Can I export implementation plans for version control and archival?

You can export implementation plans for version control and archival by saving them as standardized markdown files. The plan is automatically exported to docs/plans/YYYY-MM-DD-feature-name.md for review and execution tracking.

Why generate a plan before starting implementation on a new feature?

You generate a plan before starting implementation to reduce ambiguity and rework by validating a complete blueprint. It enables engineers to start coding with clearly defined ownership, bite-sized steps, and acceptance criteria.