writing-plans

Generate step-by-step implementation plans from a given spec.

1.7k|471|Updated Feb 1, 2025
One-click install
npx skills add https://github.com/revokslab/ShipFree --skill writing-plans-revokslab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/revokslab/ShipFree/tree/main/.cursor/skills/writing-plans
Command: npx skills add https://github.com/revokslab/ShipFree --skill writing-plans-revokslab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers transform a product spec or requirements into a detailed, executable plan before coding.

Core Features & Use Cases

  • Plan generation: Create comprehensive implementation plans that outline files to touch, code samples, tests, docs, and commits.
  • Task granularity: Break tasks into bite-sized steps suitable for small effort increments.
  • Guidance & references: Provide references to relevant files and standards, and suggested testing strategies.
  • Use Case: When onboarding a new feature, the Skill produces a plan that covers design, implementation, testing, and deployment steps.

Quick Start

Describe the feature to implement and its acceptance criteria, then run the Skill to generate a plan. The tool saves the output 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 spec?

To generate an implementation plan from a spec, describe your feature and acceptance criteria, and the tool outputs a step-by-step plan with file touchpoints, testing steps, and commits saved to docs/plans/YYYY-MM-DD-<feature-name>.md.

What is task breakdown for engineering documentation?

Task breakdown for engineering documentation divides feature development or refactoring into bite-sized executable steps. It outlines files to touch, code samples, tests, and commits while adhering to DRY, YAGNI, and TDD principles.

Can I use this for refactoring and documentation tasks across codebases?

Yes, you can use this for refactoring and documentation tasks across codebases. It transforms requirements into comprehensive plans covering design, implementation, testing, and deployment steps for engineers.

What's the best way to turn requirements into executable code steps?

The best way to turn requirements into executable code steps is using a planning tool that applies DRY, YAGNI, and TTD principles. It provides task granularity, suggested testing strategies, and references to relevant files.

Does the generated plan include testing strategies and file references?

Yes, the generated plan includes testing strategies and file references. It provides guidance and references to relevant files and standards, alongside detailed code samples and commit milestones.

Where are generated implementation plans saved?

Generated implementation plans are saved as markdown files in the docs/plans/ directory. The output file is automatically named using the YYYY-MM-DD-<feature-name>.md format for chronological tracking.