write-plan

Generate a task-by-task implementation plan from an approved design doc.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bketelsen/ytsejam --skill write-plan-bketelsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-plan
Source: https://github.com/bketelsen/ytsejam/tree/main/contrib/skills/write-plan
Command: npx skills add https://github.com/bketelsen/ytsejam --skill write-plan-bketelsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designs and product specs often stall in a shared doc, delaying delivery and muddying responsibility. This skill translates an approved design into a concrete implementation plan and a repeatable workflow. It also sets up a temporary worktree to keep changes isolated and ready for review.

Core Features & Use Cases

  • Isolates work in a temporary git worktree off main to keep changes isolated
  • Writes a plan document to docs/plans/YYYY-MM-DD-<feature-name>.md that captures tasks, files, and milestones
  • Supports a clear, task-by-task workflow that feeds the develop skill for execution
  • Provides evidenceable handoff with commit-ready changes and baseline validation

Quick Start

Confirm the design is approved and run the write-plan flow to generate a concrete implementation plan in docs/plans

Frequently Asked Questions about write-plan

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

FAQPage Schema
How do I turn an approved design document into an executable development plan?

To turn an approved design document into an executable development plan, generate a structured markdown plan with explicit tasks and milestones, while setting up a dedicated git worktree to isolate changes. This creates a ready handoff for execution.

How do I isolate new feature changes using a git worktree before implementation?

To isolate new feature changes using a git worktree, create a temporary worktree branching off the main repository state. This keeps uncommitted modifications separate and ready for baseline validation before merging.

What is the best way to structure a task-by-task implementation plan for a new software feature?

The best way to structure a task-by-task implementation plan is to write a markdown document detailing specific files, tasks, and milestones. This structured plan provides a clear workflow feeding directly into the development phase.

Do I need a validated repository state and main branch to generate an implementation plan?

Yes, you need a validated repository state and a main branch to generate an implementation plan. The process requires a stable baseline to run gate tests and create an isolated git worktree for commit-ready changes.

Where should I store design specs and implementation plans in my repository?

You should store design specs and implementation plans inside the docs/plans/ directory. The workflow expects an approved design at docs/plans/YYYY-MM-DD-topic-design.md and outputs the corresponding plan as docs/plans/YYYY-MM-DD-feature-name.md.

Why do approved designs stall in shared docs and how can I automate the handoff?

Approved designs stall in shared docs because responsibility and execution steps remain unclear. You automate the handoff by translating the design into a concrete task-by-task plan with commit-ready changes and baseline validation.