writing-plans

Generate implementation roadmaps from specs and save them to docs/plans.

178|24|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill writing-plans-zhanlincui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/writing-plans
Command: npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill writing-plans-zhanlincui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams convert a spec or requirements document into a comprehensive, step-by-step implementation plan before coding, reducing ambiguity and rework.

Core Features & Use Cases

  • Structured planning: transform requirements into a task-by-task plan with clear deliverables, testing, and documentation.
  • Worktree-ready guidance: generates plan files and file/directory maps suitable for a dedicated worktree.
  • Commit-ready workflow: includes staged steps for tests, code, docs, and frequent commits for traceability.

Quick Start

Create an implementation plan for a feature by providing its name and a high-level spec. The plan will be saved to docs/plans/YYYY-MM-DD-<feature-name>.md and structured with a header, a Task list, test steps, and commit guidance.

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 software spec?▼

Generate an implementation plan by transforming a spec into a task-by-task roadmap. The plan outlines files to touch, tests to write, and documentation to update, saving the output to docs/plans/YYYY-MM-DD-<feature-name>.md for clear deliverables.

What is the best way to structure TDD steps and frequent commits in a feature plan?▼

Structure TDD steps and frequent commits by enforcing a consistent plan format with a header and Task N outline. This sequence integrates test-driven steps and staged commits for code, tests, and docs, ensuring full traceability and reproducibility.

Can I use this implementation plan generation approach for a dedicated Git worktree?▼

Yes, implementation plan generation supports a dedicated Git worktree environment. It produces file and directory maps directly suitable for worktree setups, ensuring isolated development and version control without context overlap.

How do I outline files to touch and tests to write before coding begins?▼

Outline files to touch and tests to write by creating a comprehensive implementation roadmap before coding. This provides engineers with zero context a bite-sized sequence of tasks, detailing exact file modifications and required test coverage.

Does plan generation work without existing dependencies or components?▼

Yes, plan generation operates without external dependencies or components. It relies solely on a provided feature spec or requirements document to produce the structured markdown plan with mapped tasks and commit guidance.

Why convert requirements into a task-by-task plan before starting development?▼

Convert requirements into a task-by-task plan to reduce ambiguity and rework before coding. This structured planning approach breaks down specs into clear deliverables, testing protocols, and documentation updates, saving plans as dated markdown files.