writing-plans

Create end-to-end implementation plans with exact file paths, sample code, tests, and bite-sized tasks.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill writing-plans-xza85hrf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Xza85hrf/claude-code-agent-kit/tree/main/.claude/skills/architecture/writing-plans
Command: npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill writing-plans-xza85hrf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans with: - Exact files to touch per task - Complete code samples - Testing approach - Bite-sized tasks (2-5 minutes each) - DRY, YAGNI, TDD, frequent commits

Assume skilled developer with zero codebase context.

Core Features & Use Cases

  • Exact files to touch per task
  • Complete code samples
  • Testing approach
  • Bite-sized tasks (2-5 minutes each)
  • DRY, YAGNI, TDD, frequent commits
  • Use Case: Plan creation for a feature start-to-finish, with step-by-step execution and commit history.

Quick Start

Ask the AI to generate a complete implementation plan for a feature and save it to docs/plans/YYYY-MM-DD-<feature-name>.md.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I create an implementation plan for a complex software feature?▼

To create an implementation plan, you define exact file paths, sample code, testing approaches, and bite-sized tasks. This ensures deterministic planning and incremental work breakdown for feature development in large codebases.

What is the best way to break down feature development into manageable tasks?▼

The best way to break down feature development is dividing work into 2-5 minute bite-sized steps with frequent commits. This structured planning approach ensures incremental progress, applies TDD best practices, and maintains DRY and YAGNI principles.

How does test-driven development planning work for large codebases?▼

Test-driven development planning works by scaffolding tests and explicit file changes before implementation. It generates structured planning metadata containing version-control steps and bite-sized tasks to ensure deterministic execution in large codebases.

Can I generate step-by-step code samples and file paths for developers with zero codebase context?▼

Yes, you can generate step-by-step plans containing complete code samples and exact files to touch per task. These plans assume a skilled developer with zero codebase context, providing explicit file changes and version-control steps for immediate execution.

Does implementation planning support TDD and frequent commit workflows?▼

Yes, implementation planning supports TDD and frequent commit workflows by enforcing DRY, YAGNI, and test scaffolding. It structures work into bite-sized tasks with explicit version-control steps, ensuring deterministic feature development and incremental progress.

When do I need a structured implementation plan for feature development?▼

You need a structured implementation plan when developing complex features in large codebases requiring deterministic planning. It provides incremental work breakdown with exact file changes, test scaffolding, and step-by-step execution guidance for zero-context developers.