writing-plans

Generate structured implementation plans from feature specs with bite-sized tasks.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/hongmaple0820/agent-academy --skill writing-plans-hongmaple0820
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/hongmaple0820/agent-academy/tree/main/skills/documentation/writing-plans
Command: npx skills add https://github.com/hongmaple0820/agent-academy --skill writing-plans-hongmaple0820

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. Frequent commits.

Core Features & Use Cases

  • Generate a complete implementation plan that details required files, tests, docs, and verification steps.
  • Enforce best practices like DRY, YAGNI, and TDD to ensure clean, maintainable handoffs.
  • Save plans to a predictable location within the repo (docs/plans/YYYY-MM-DD-<feature-name>.md) for traceability and reuse.

Quick Start

Ask it to generate a complete implementation plan for a given feature, following the plan document header and task structure.

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 for developers?

To generate an implementation plan from a feature spec, you provide the feature requirements to get a structured document with required files, tests, documentation, and verification steps. This ensures developers with zero codebase context can execute tasks.

What is the best way to break down multi-step software tasks into bite-sized commits?

The best way to break down multi-step software tasks into bite-sized commits is creating an end-to-end plan enforcing DRY and YAGNI principles. This guides tests, code, docs, and frequent commits for maintainable handoffs.

How does TDD fit into writing implementation plans across a codebase?

TDD fits into implementation plans by enforcing test-driven development practices within the generated task breakdown. The plan structures bite-sized tasks to guide tests, code, and documentation sequentially across the codebase.

Can I save generated implementation plans to a specific predictable location within my repo?

Yes, you can save generated implementation plans to a predictable location within your repository. Plans are saved as markdown files in the docs/plans directory using a YYYY-MM-DD-feature-name format for traceability and reuse.

Does an implementation plan document need a specific header and task structure?

Yes, an implementation plan document needs a specific header and task structure to satisfy formatting requirements. It uses a plan document header and breaks down work into bite-sized tasks detailing required files and verification steps.