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.