writing-plans

Create Markdown implementation plans with files, tests, docs, and milestones from specs.

588|41|Updated May 13, 2026
One-click install
npx skills add https://github.com/zai-org/Synapse --skill writing-plans-zai-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/zai-org/Synapse/tree/main/.setup/skills/clawhub/skills/writing-plans
Command: npx skills add https://github.com/zai-org/Synapse --skill writing-plans-zai-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing and structuring a complex feature plan from a spec, ensuring clear milestones, responsibilities, and documentation before coding begins.

Core Features & Use Cases

  • Create a detailed implementation plan from a spec, listing required files, tests, docs, and milestones.
  • Facilitate TDD/DRY approaches by outlining test cases and minimal code changes in a reproducible plan.
  • Use Case: A feature with multiple components can be broken into tasks and commits with exact paths.

Quick Start

Draft an implementation plan for a feature from its spec, then save it to docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan from a software specification?

An implementation plan breaks down a spec into required files, tests, docs, and milestones. It outlines steps using DRY and TDD principles, producing a reusable Markdown plan with exact file paths and commands for multi-step software tasks.

What is the best way to plan multi-step software engineering tasks?

Planning multi-step software tasks involves detailing required files, tests, docs, and milestones from a spec. This ensures clear responsibilities and documentation by outlining steps with exact file paths and commands, keeping DRY and TDD principles.

Can I apply TDD and DRY principles when structuring a feature plan?

Yes, you can apply TDD and DRY principles when structuring a feature plan by outlining test cases and minimal code changes. The plan breaks features into tasks and commits with exact paths, producing a reproducible Markdown document.

Do I need an existing specification to generate a project implementation plan?

Yes, you need an existing specification to generate a project implementation plan. The process applies to projects where a spec exists but codebase context is limited, detailing files, tests, docs, and milestones to satisfy requirements.

How do I break down a complex feature into tasks and commits with exact paths?

You break down a complex feature into tasks and commits by creating a detailed implementation plan from its spec. This plan outlines required files, tests, and milestones, saving the structure to a reusable Markdown document with exact paths.

When should I not use a detailed implementation plan for a coding project?

You should not use a detailed implementation plan when no spec exists or when full codebase context is already available. This approach is designed for projects where a spec exists but codebase context is limited, requiring detailed file and milestone outlining.