writing-plans

Convert project specs into step-by-step implementation plans with file paths, tests, and commits.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts a project specification into a complete, executable implementation plan, eliminating ambiguity and documenting every required file touchpoint, test, and commit.

Core Features & Use Cases

  • Comprehensive Plan Generation: Produces a full, step-by-step plan covering code, tests, docs, and reviews.
  • Task Granularity: Breaks work into bite-sized tasks (2-5 minutes per step) with clear success criteria.
  • Context-Driven: Assumes zero knowledge of the codebase and enforces DRY, YAGNI, and TDD best practices.

Quick Start

Use the writing-plans skill to create a plan for implementing a new feature, including the file changes, tests, docs, and commit messages.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I convert a project spec into an actionable implementation plan?

To convert a project spec into an implementation plan, provide the specification to generate a comprehensive, step-by-step plan. This covers exact file paths, tests, documentation, and deterministic commit messages.

How do I break down engineering tasks for developers with zero codebase context?

To break down engineering tasks with zero codebase context, generate a plan that assumes no prior knowledge. It enforces DRY, YAGNI, and TDD practices while specifying exact file paths and commands.

What is the best way to generate TDD commit messages and test steps from a specification?

The best way to generate TDD commit messages and test steps is using a planning process that enforces test-driven development practices. It outputs bite-sized tasks with deterministic commit messages and clear success criteria.

Does this implementation plan generator enforce DRY and YAGNI best practices?

Yes, this implementation plan generator enforces DRY and YAGNI best practices. It assumes zero knowledge of the codebase and integrates these principles directly into the generated task breakdown and documentation.

Can I use this to plan exact file paths and commands for a new feature?

Yes, you can use this to plan exact file paths and commands for a new feature. The generated plan documents every required file touchpoint, test change, and command execution step needed for implementation.

How granular are the task breakdown steps in the generated implementation plan?

The task breakdown steps in the generated implementation plan are highly granular, splitting work into bite-sized tasks of two to five minutes each with clear success criteria for every step.