writing-plans

Generate step-by-step Markdown implementation plans from feature specs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bearhedge/APE-YOLO --skill writing-plans-bearhedge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/bearhedge/APE-YOLO/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/bearhedge/APE-YOLO --skill writing-plans-bearhedge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates comprehensive, execution-ready implementation plans from a feature spec, ensuring engineers know exactly which files to touch, what to implement, test, and document, with step-by-step guidance.

Core Features & Use Cases

  • Plan generation: Produces end-to-end task breakdowns including file touchpoints, tests, docs, and commit steps.
  • Style & discipline: Enforces DRY, YAGNI, and TDD principles with concise rationale for each task.
  • Project scoping: Works from minimal specs to produce a complete workplan suitable for pull requests and handoffs.
  • Use Case: When given a feature idea like "add user invitation flow," it outputs a plan detailing frontend, backend, tests, docs, and migration steps.

Quick Start

Run the writing-plans skill with a feature specification and save the plan to docs/plans/YYYY-MM-DD-<feature-name>.md, then review and commit the plan.

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 before coding?

To generate an implementation plan from a feature spec, you input the specification to produce a structured Markdown breakdown of tasks, file touchpoints, tests, and documentation steps for execution-ready development.

What is the best way to structure step-by-step implementation plans for software engineering tasks?

The best way to structure implementation plans is to enforce DRY, YAGNI, and TDD principles, creating an end-to-end task breakdown that includes file touchpoints, testing requirements, documentation, and version-control commit guidance.

Does this planning approach work with minimal feature specs and unknown codebase context?

Yes, this planning approach works with minimal feature specs and unknown codebase context by generating comprehensive, auditable workplans suitable for pull requests and team handoffs without requiring prior project knowledge.

How do I include testing and documentation requirements in my development workplan?

To include testing and documentation in your development workplan, the generated plan details specific test cases, required documentation updates, and migration steps alongside the core implementation tasks for each feature.

Can I automatically save generated implementation plans to my project directory?

Yes, you can save generated implementation plans directly to your project directory using the standard path docs/plans/YYYY-MM-DD-<feature-name>.md, ensuring consistent headers and version-controlled tracking for each feature.

When do I need a structured implementation plan for a new software feature?

You need a structured implementation plan when starting a new software feature like a user invitation flow, ensuring engineers know exactly which frontend, backend, and migration files to touch before writing code.