Does this skill support Test-Driven Development (TDD)?

Yes, it is built around TDD. Every task includes writing a failing test, running it to verify failure, implementing minimal code, and then verifying the pass.

How does this skill help with AI subagents?

It provides a clear handoff. Once a plan is written, it offers two execution paths: subagent-driven development within the same session or parallel execution in a new session.

Where are the generated plans stored?

Plans are automatically saved to the `docs/plans/` directory using a timestamped naming convention (YYYY-MM-DD-feature-name.md).

Why are tasks limited to 2-5 minutes?

Granular tasks reduce the surface area for errors, make it easier to revert mistakes, and allow for frequent, meaningful git commits.

What is a Writing Plan in Claude Code?

A Writing Plan is a structured markdown document that breaks down a software feature into tiny, testable tasks. It serves as a roadmap for an engineer or an AI subagent to follow with zero prior context.

Implementation Writing Plans

Name: Implementation Writing Plans
Author: franroa

byfranroa

0•

Productivity & Workflow

Generates granular, step-by-step implementation roadmaps with exact file paths and test-driven tasks for seamless execution.

The Writing Plans skill streamlines the transition from design to development by creating hyper-detailed task lists for Claude or human engineers. It assumes zero prior codebase context, providing exact file paths, complete code snippets, and specific terminal commands for every step. By enforcing Test-Driven Development (TDD) and bite-sized tasks (2-5 minutes each), it ensures high-quality code delivery and simplifies handoffs to autonomous subagents or new team members.

Key Features

010 GitHub stars

02Generates 2-5 minute bite-sized tasks to maintain high momentum and easy debugging.

03Provides exact file paths and line-specific instructions to eliminate ambiguity.

04Enforces a strict TDD workflow with explicit steps for failing tests and minimal implementation.

05Includes full shell commands with expected outputs for instant verification.

06Standardizes plan documentation with structured headers and automated file saving to docs/plans/.

Use Cases

01Onboarding developers to a new project by providing a crystal-clear path to contribution.

02Preparing structured task lists for autonomous AI subagents to execute in isolated worktrees.

03Breaking down complex features into incremental, safe Git commits for better PR reviews.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi writing-plans

For use in Claude.ai and ChatGPT

Download Skill