Can Claude execute the plans it writes?

Yes, once a plan is saved, the skill provides options to hand off the execution to a subagent or a parallel session using specialized execution sub-skills.

Why use 'Writing Plans' instead of direct coding?

Using a plan prevents 'scope creep,' ensures YAGNI (You Ain't Gonna Need It) principles are followed, and provides a clear audit trail for complex architectural changes.

How does this skill improve code quality?

It enforces strict Test-Driven Development (TDD) by requiring a failing test to be written and verified before any functional code is implemented.

Where are the implementation plans stored?

Plans are automatically saved to your project's local directory under 'docs/plans/' with a timestamped and feature-specific filename.

What does the Writing Plans skill do?

It generates a highly detailed Markdown document that outlines every step required to implement a feature, including specific tests, file paths, and git commit points before the coding begins.

Writing Plans for Claude Code

Name: Writing Plans for Claude Code
Author: claudiodearaujo

byclaudiodearaujo

•

Productivity & Workflow

Generates granular, TDD-focused implementation plans to guide complex coding tasks with precision and documentation.

The Writing Plans skill enables Claude to act as a technical architect, drafting comprehensive step-by-step roadmaps before any code is modified. By enforcing Test-Driven Development (TDD) and the YAGNI principle, it ensures that every feature is built with high reliability and minimal waste. Each plan is documented in a standardized Markdown format within your repository, featuring bite-sized tasks that include exact file paths, shell commands, and expected test outputs, making it perfect for complex refactoring or feature additions that require a systematic approach.

Key Features

01Mandatory Test-Driven Development (TDD) workflow integration

02Automated saving of plans to the docs/plans/ directory

03Handoff support for subagent-driven or parallel execution sessions

04Bite-sized task granularity (2-5 minute actions per step)

051 GitHub stars

06Standardized implementation plan generation in Markdown

Use Cases

01Onboarding developers or AI agents to projects with limited context

02Architecting complex features that require multi-file modifications

03Standardizing coding workflows for team-wide consistency and review

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