What is the primary benefit of the Writing Plans skill?

It ensures that complex tasks are thought through before coding starts, enforcing best practices like TDD and reducing errors by providing bite-sized, executable steps.

How does it handle Test-Driven Development?

Every task includes steps to write a failing test, verify the failure, write minimal code to pass, and verify the success before committing.

Can this skill be used with other Claude Code subagents?

Yes, it includes a specific handoff mechanism to trigger subagent-driven development or parallel execution sessions once a plan is finalized.

Where are the generated plans saved?

Plans are saved as Markdown files in the 'docs/plans/' directory, following a standardized date-and-feature-name naming convention.

What principles does this skill follow?

It strictly follows TDD (Test-Driven Development), DRY (Don't Repeat Yourself), YAGNI (You Ain't Gonna Need It), and frequent commit patterns.

TDD Implementation Planner

Name: TDD Implementation Planner
Author: claudiodearaujo

byclaudiodearaujo

•

Productivity & Workflow

Generates granular, test-driven implementation plans for complex development tasks to ensure high-quality code execution.

The Writing Plans skill is designed to bridge the gap between high-level requirements and production-ready code by creating exhaustive, step-by-step implementation roadmaps. It operates on the principle that even a developer with zero codebase context can succeed if given a precise, bite-sized plan. By enforcing Test-Driven Development (TDD), DRY, and YAGNI principles, it breaks down features into 2-5 minute tasks—complete with exact file paths, failing test definitions, and shell commands. This skill is essential for maintaining architectural integrity and providing clear instructions for both human developers and AI subagents.

Key Features

011 GitHub stars

02Automatic documentation of plans in Markdown format

03Automated generation of granular 2-5 minute micro-tasks

04Standardized implementation headers with goals and tech stack

05Strict TDD workflow integration (Fail-Pass-Commit cycles)

06Integrated handoff for subagent-driven or parallel session execution

Use Cases

01Documenting technical debt resolution or refactoring plans before execution

02Providing clear instructions for AI subagents in a multi-step workflow

03Scaffolding complex new features with strict test coverage requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro writing-plans

For use in Claude.ai and ChatGPT

Download Skill