WritingPlans

Generate implementation plans with file paths, code examples, and test commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/vdemeester/home --skill writingplans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: WritingPlans
Source: https://github.com/vdemeester/home/tree/main/dots/.config/claude/skills/WritingPlans
Command: npx skills add https://github.com/vdemeester/home --skill writingplans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables drafting implementation plans broken into small, testable tasks with clear file paths, code examples, and tests.

Core Features & Use Cases

  • Plan Decomposition: Split features into 2-5 minute tasks.
  • Documentation & Tests: Include code examples, test commands, and verification steps.

Quick Start

Outline a plan for a feature with 3 tasks and start implementing them step-by-step.

Frequently Asked Questions about WritingPlans

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

FAQPage Schema
How do I break down a complex feature into smaller, testable tasks?

Breaking down features into smaller tasks involves decomposing requirements into 2-5 minute implementable steps with explicit file paths, code examples, and test commands. This approach applies test-driven development principles, ensuring each task is independently testable and verifiable before moving to the next.

What should an implementation plan include for multi-step features?

A comprehensive implementation plan includes task-by-task breakdowns with clear file paths, code examples, test commands, and verification steps. It applies DRY, YAGNI, and TDD principles, enables frequent commits, and announces the full plan at the start so stakeholders understand the scope and sequence.

How do I ensure my design plan follows test-driven development principles?

Test-driven planning structures tasks so tests are written first, then implementation follows. Each task in your plan should specify the test command upfront, verification steps, and expected outcomes, ensuring the design is testable and implementation stays focused on requirements.

Can I use implementation planning for user stories and requirements documents?

Yes, implementation planning applies directly to requirements and user stories that require multi-step design. It transforms high-level requirements into bite-sized, actionable tasks with explicit file changes, code examples, and test coverage.

What's the benefit of planning features with explicit file paths and code examples?

Explicit file paths and code examples in your plan reduce ambiguity, enable parallel work, and allow developers to start implementation immediately without design rework. This specificity also catches architectural issues early and keeps commits small and reviewable.

How frequently should I commit when following a task breakdown plan?

Commit frequently after completing each small task in your plan. This keeps commits atomic, reviewable, and reversible. Frequent commits also track progress clearly and align with the task-breakdown structure, making it easier to identify where issues occurred.