writing-plans

Generate end-to-end implementation plans from feature specs with file references and commit checkpoints.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/esteban389/workout --skill writing-plans-esteban389
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/esteban389/workout/tree/main/.agents/skills/writing-plans
Command: npx skills add https://github.com/esteban389/workout --skill writing-plans-esteban389

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing plans solves the problem of engineers starting from ambiguity by generating comprehensive, step-by-step implementation plans from a feature spec. It ensures engineers know exactly which files to touch, which tests to write, and which docs to update before coding begins.

Core Features & Use Cases

  • Generates end-to-end implementation plans from a feature spec, detailing required files, tests, docs, and reviews.
  • Breaks work into bite-sized tasks with explicit goals, test guidance, and commit checkpoints.
  • Enforces DRY, YAGNI, and TDD principles by documenting testing strategies and acceptance criteria.
  • Supports planning in a dedicated worktree and saves the plan to docs/plans/YYYY-MM-DD-<feature-name>.md.

Quick Start

Run the writing-plans skill with a feature spec to generate the full plan and save it to docs/plans/YYYY-MM-DD-<feature-name>.md.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate an implementation plan from a feature spec?

Generate an implementation plan by processing a feature spec to produce step-by-step tasks, required file references, testing strategies, and commit checkpoints. The plan is saved as a markdown file in the docs/plans directory to guide the entire coding workflow.

What is the best way to break down complex software features into deterministic milestones?

Breaking down complex software features into deterministic milestones requires structuring work into bite-sized tasks with explicit goals and test guidance. This approach documents acceptance criteria and enforces TDD principles to ensure clear, repeatable review steps.

How do I enforce TDD and DRY principles when planning software engineering tasks?

Enforce TDD and DRY principles during software engineering task planning by documenting explicit testing strategies and acceptance criteria within the generated plan. This ensures engineers write tests and avoid duplication before coding begins.

Can I use a commit-driven workflow in a dedicated worktree for feature implementation?

Yes, you can use a commit-driven workflow in a dedicated worktree for feature implementation. The generated plan structures work into bite-sized tasks with commit checkpoints, ensuring deterministic milestones and clear review steps.

Do I need a feature spec to start planning software implementation steps?

Yes, you need a feature spec to start planning software implementation steps. The plan generation solves the problem of starting from ambiguity by transforming the feature spec into explicit file references, tests, and documentation updates.

When should I not use automated step-by-step task breakdown for software projects?

Avoid using automated step-by-step task breakdown for software projects that do not require structured task decomposition or deterministic milestones. It is designed for complex tasks needing explicit file references, testing strategies, and commit-driven workflows.