writing-plans

Translate sparse specs into step-by-step implementation plans with TDD guidance.

47|8|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/huangwb8/skills --skill writing-plans-huangwb8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/huangwb8/skills/tree/main/awesome-code/agents/writing-plans
Command: npx skills add https://github.com/huangwb8/skills --skill writing-plans-huangwb8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translating a sparse spec into a concrete, step-by-step implementation plan is time-consuming and error-prone.

Core Features & Use Cases

  • Comprehensive implementation plans: Document every task, files touched, tests to write, and docs to consult.
  • Bite-sized task generation: Break work into small, measurable steps suitable for rapid iterations.
  • TDD-driven workflow: Emphasize red/green/refactor cycles and frequent commits to ensure quality.

Quick Start

Save the generated implementation plan to docs/plans/YYYY-MM-DD-writing-plans.md

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 sparse specification into a step-by-step implementation plan?

To turn a sparse specification into an implementation plan, you translate the spec into a concrete sequence of tasks. This process details files to touch, tests to write, and documentation steps, breaking work into small, measurable steps for rapid iterations.

How does test-driven development fit into engineering a feature from zero context?

Test-driven development fits into feature engineering by emphasizing red, green, and refactor cycles alongside frequent commits. This TDD-driven workflow ensures quality is maintained while executing the bite-sized tasks generated from your specification.

What is the best way to document files to touch and tests to write for a new feature?

The best way to document files to touch and tests to write is generating a comprehensive implementation plan. This standardized plan documentation captures every task and consultation step, saving the output under docs/plans with a dated markdown format.

Can I use structured planning for task management without manually outlining every step?

Yes, structured planning automates task management by generating bite-sized steps from a sparse spec. It satisfies requirements for standardized plan documentation and TDD guidance without manually outlining each file modification or test cycle.

When do I need standardized plan documentation saved under docs/plans?

You need standardized plan documentation saved under docs/plans when engineering a feature from zero context. This ensures every file touched, test written, and documentation step is recorded for structured planning and rapid iteration.