writing-plans

Convert approved design documents into executable, test-first implementation tasks with file paths and commit messages.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Berkay2002/skills --skill writing-plans-berkay2002
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Berkay2002/skills/tree/main/skills/writing-plans
Command: npx skills add https://github.com/Berkay2002/skills --skill writing-plans-berkay2002

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts approved design documents and requirements into clear, test-first implementation plans so engineers with no repository context can execute changes reliably. Eliminates ambiguity about which files to touch, what tests to write, and how to commit incremental progress.

Core Features & Use Cases

  • TDD-focused task breakdown: Each task is a small failing-test → implement → pass → commit cycle, written as individual 2–5 minute actions.
  • Exact actionable details: Every step names exact file paths, test code, commands to run, expected outputs, and commit messages.
  • Use cases: Preparing feature work from a design doc, onboarding contributors for a refactor, or converting a spec into an execution checklist for a sprint.

Quick Start

Ask the assistant to read the approved design doc under docs/plans/ and produce a saved implementation plan at docs/plans/YYYY-MM-DD-<feature-name>-implementation-plan.md with step-by-step, test-first tasks.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I convert a design doc into an implementation plan with TDD steps?

Converting a design doc into an implementation plan involves breaking down approved specs into small, test-first tasks. Each step defines exact file paths, failing tests, minimal implementations, test commands, expected outputs, and commit messages for reliable execution.

What is the best way to break down feature development into small test-driven tasks?

The best way to break down feature development is creating a cycle of failing-test to implement to pass to commit actions. This method ensures each 2–5 minute incremental step provides exact file paths and commit guidance, eliminating ambiguity for engineers without repository context.

Can I generate a step-by-step implementation checklist from a spec for sprint planning?

Yes, you can generate a step-by-step implementation checklist from a spec for sprint planning. The process converts requirements into precise, executable actions that include exact test code, commands to run, and expected outputs, serving as a reliable execution checklist for the team.

How do I prepare exact file paths and commit messages for a code refactor?

To prepare exact file paths and commit messages for a code refactor, you translate the approved design document into actionable, test-first tasks. Every generated step explicitly names the target files and provides structured commit messages for incremental progress tracking.

Does this approach work for onboarding contributors to execute changes without repository context?

Yes, this approach works for onboarding contributors by providing exact actionable details. It eliminates ambiguity about which files to touch and how to commit incremental progress, allowing engineers with no repository context to reliably execute refactors or feature work.