Where are the implementation plans saved?

Plans are automatically saved as Markdown files within your project repository under the 'docs/plans/' directory, timestamped for version control.

What is the Writing Plans skill?

It is a specialized capability for Claude Code that helps developers create highly detailed, step-by-step implementation plans before they start writing code.

What is 'Bite-Sized Task Granularity'?

The skill breaks down complex work into very small actions that take roughly 2-5 minutes each, making the development process predictable and easy for AI subagents to execute.

How does it support Test-Driven Development (TDD)?

Every task in the generated plan includes specific steps for writing a failing test, running it to confirm failure, implementing the minimal code, and verifying the pass.

Can I execute these plans automatically after they are written?

Yes, once the plan is saved, the skill offers options to either dispatch subagents for each task or open a parallel session for batch execution.

Writing Plans

Name: Writing Plans
Author: AhmedElhadarey

byAhmedElhadarey

•

Productivity & Workflow

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

The Writing Plans skill streamlines the transition from requirements to implementation by creating detailed, bite-sized development roadmaps. It enforces industry best practices like Test-Driven Development (TDD), DRY, and YAGNI, producing comprehensive plan documents that specify exact file paths, code snippets, and terminal commands. Designed for complex features or multi-step tasks, it ensures that every code change is deliberate, tested, and documented before execution begins, providing a clear handoff for subagents or manual development.

Key Features

01Exact Technical Guidance: Provides specific file paths, code blocks, and CLI commands to minimize ambiguity.

02Execution Handoff: Offers subagent-driven or parallel session execution options for flexible development workflows.

03Bite-Sized Action Items: Breaks down complex features into 2-5 minute tasks for rapid, focused iteration.

042 GitHub stars

05Standardized Documentation: Automatically saves structured plans to docs/plans/ for version control and review.

06TDD-Enforced Task Structure: Includes explicit steps for failing tests, implementation, and verification.

Use Cases

01Architecting a new feature from a requirement specification before writing any production code.

02Onboarding a subagent or new developer to a complex codebase with clear, step-by-step instructions.

03Managing large-scale refactorings while ensuring constant test coverage and frequent git commits.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ahmedelhadarey/gilfoyle writing-plans

For use in Claude.ai and ChatGPT

Key Features

01Exact Technical Guidance: Provides specific file paths, code blocks, and CLI commands to minimize ambiguity.

02Execution Handoff: Offers subagent-driven or parallel session execution options for flexible development workflows.

03Bite-Sized Action Items: Breaks down complex features into 2-5 minute tasks for rapid, focused iteration.

042 GitHub stars

05Standardized Documentation: Automatically saves structured plans to docs/plans/ for version control and review.

06TDD-Enforced Task Structure: Includes explicit steps for failing tests, implementation, and verification.

Use Cases

01Architecting a new feature from a requirement specification before writing any production code.

02Onboarding a subagent or new developer to a complex codebase with clear, step-by-step instructions.

03Managing large-scale refactorings while ensuring constant test coverage and frequent git commits.