writing-plans

Plans multi-step software tasks with file paths, tests, and commit messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, reproducible plan for implementing complex requirements by detailing which files to touch, exact steps, tests, and acceptance criteria before coding begins.

Core Features & Use Cases

  • Bite-sized Task Breakdown: Each task is 2-5 minutes and testable.
  • TDD-aligned Tasks: Each task starts with a failing test and ends with a passing test.
  • Artifact-Driven Planning: Includes exact file paths, sample code, and commit messages.
  • Milestone Grouping: Optional milestones to organize large plans and track progress.

Quick Start

Create a new plan by naming the feature and writing bite-sized tasks with explicit file paths, tests, and commit steps.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I break down a complex software feature into test-driven implementation steps?

Test-driven implementation steps break complex features into 2-5 minute tasks, each starting with a failing test and ending with a passing test. This ensures every code change is verifiable and guides incremental development with clear commit messages.

What is the best way to create an implementation plan with exact file paths and tests?

An implementation plan with exact file paths and tests details which files to modify, sample code, and acceptance criteria before coding begins. This artifact-driven approach provides a reproducible structure for multi-step software tasks.

Can I use milestone grouping to track progress on large system redesigns?

Milestone grouping tracks progress on large system redesigns by organizing detailed task plans into optional milestones. This allows developers to monitor complex feature development phases and verify completion of major structural changes.

Does test-driven planning work for spec-driven development and documentation tasks?

Test-driven planning works for spec-driven development and documentation tasks by detailing exact steps, tests, and acceptance criteria before coding begins. It produces a task-based plan that guides implementation with clear artifact references.

How do I structure commit messages and acceptance criteria for multi-step software tasks?

Commit messages and acceptance criteria for multi-step software tasks are structured within bite-sized task breakdowns. Each task specifies exact file paths, tests, and commit steps, ensuring reproducible implementation and clear milestones.

When should I not use a detailed task-based plan for software engineering?

A detailed task-based plan for software engineering should not be used for simple modifications that do not require multi-step implementation or test alignment. It is designed for complex feature development where precise planning and documentation are required before coding.