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.