writing-plans

Generate granular implementation plans with file paths, code snippets, and test steps.

Updated May 28, 2026
One-click install
npx skills add https://github.com/kyo0221/claude-config --skill writing-plans-kyo0221
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/kyo0221/claude-config/tree/main/skills/writing-plans
Command: npx skills add https://github.com/kyo0221/claude-config --skill writing-plans-kyo0221

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork and inconsistency that arises when engineers implement multi-step software features with minimal context about the existing codebase. It ensures every implementation plan is comprehensive, actionable, and free of ambiguous placeholders, reducing rework and accelerating development timelines.

Core Features & Use Cases

  • Granular Task Breakdown: Splits specs into 2-5 minute actionable steps with exact file paths, complete code snippets, test commands, and commit messages for each individual task.
  • Best Practice Enforcement: Automatically embeds DRY, YAGNI, TDD, and frequent commit guidelines into every plan to maintain consistent code quality across the team.
  • Built-in Validation: Includes a self-review checklist to catch spec coverage gaps, placeholder text, and type inconsistencies before the plan is handed off for execution.
  • Use Case: For example, when building a new user notification system, this Skill generates a full plan with individual test, implementation, and commit steps for each component, so any engineer can execute it without prior context of the codebase.

Quick Start

Use the writing-plans skill to generate a complete, actionable implementation plan for your new feature spec before writing any code.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate an implementation plan from feature specs?

To generate an implementation plan from feature specs, you provide the spec to a planning tool that breaks it down into 2-5 minute actionable steps with exact file paths, complete code snippets, and test validation commands. This eliminates guesswork by ensuring every task is granular and actionable.

What is task decomposition in software engineering?

Task decomposition in software engineering is splitting a multi-step feature spec into granular, actionable steps that include exact file paths, complete code snippets, and commit messages. It reduces implementation errors by eliminating ambiguous placeholders and ensuring any engineer can execute the plan.

How do I enforce TDD best practices in development workflows?

You enforce TDD best practices in development workflows by generating implementation plans that automatically embed DRY, YAGNI, and frequent commit guidelines into every task. This ensures consistent code quality by structuring individual test, implementation, and commit steps for each component.

Can I use code planning for refactoring or bug fixes with minimal codebase knowledge?

Yes, you can use code planning for refactoring or bug fixes with minimal codebase knowledge because it generates context-agnostic implementation plans. These plans provide exact file paths and complete code snippets, allowing any engineer to execute multi-step tasks without prior context.

What is the best way to validate spec coverage before executing an implementation plan?

The best way to validate spec coverage before executing an implementation plan is to use a built-in self-review checklist. This catches spec coverage gaps, placeholder text, and type inconsistencies, ensuring the plan is comprehensive and free of ambiguous placeholders before handoff.

Why does implementation planning reduce rework in software engineering?

Implementation planning reduces rework in software engineering by eliminating guesswork and inconsistency when engineers implement multi-step features. It ensures plans are comprehensive, actionable, and free of ambiguous placeholders, which accelerates development timelines and reduces errors.