writing-plans

Generates numbered, task-by-task implementation plans with verification commands from feature specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a feature spec or ticket into an executable implementation plan is error-prone: tasks end up too large, verification steps are vague, and the implementer (often a smaller AI model with no conversation history) gets stuck on ambiguity. This Skill produces a structured plan.md where every task has a Files manifest, literal verification commands, and exact expected outputs. ## Core Features & Use Cases - Task decomposition by layer: Splits work into Types, Data, Domain, UI, and Route tasks so storage, domain logic, and components never share a task, matching a Next.js App Router repo structure. - Contract-based steps with red-green verification: Each step carries an exact command (npx tsc --noEmit, npm run lint, npx playwright test) and its literal expected output, using compiler errors as the red signal since the repo has no unit-test runner. - Multi-pass review: Runs self-review, an independent coverage check, an adversarial critique for non-trivial plans, and a plan-document review via parallel subagents before saving. - Plan amendment and maintenance: Supports extending existing plans while preserving completed tasks byte-for-byte, with log.txt as append-only resumption state. - Use Case: Given features/005.record-expense.md, produce doc/features/005-record-expense/plan.md with 7 ordered tasks, each independently executable by a fresh implementer agent. ## Quick Start Ask the AI to write an implementation plan for features/005.record-expense.md and save it as plan.md in the feature's doc folder.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I write an implementation plan from a feature spec?

Provide the spec path (e.g. features/005.record-expense.md) and the skill decomposes it into numbered tasks, each with a Files manifest, contract steps, and exact verification commands. The plan is saved to doc/features/<NNN>-<slug>/plan.md.

How do I break a feature into tasks for an AI coding agent?

Split work by layer — types, storage, domain logic, UI components, routes — with 3-8 steps per task. Each task must be self-contained with literal names, error strings, and expected command outputs, since the implementing agent sees only that one task.

Can I verify code changes without a unit test runner?

Yes. Use the TypeScript compiler as the red signal: write the call site first, run npx tsc --noEmit, and expect a specific error like TS2305 or TS2307. After implementing, re-run for exit 0, and use Playwright specs for behavior the compiler cannot see.

When should I amend an existing plan instead of writing a new one?

Amend when requirements change for a feature that already has a plan.md. Read plan.md and log.txt first, preserve completed tasks byte-for-byte, append new tasks continuing the numbering, and add a dated amendment note explaining what changed and why.

What are the limitations of this planning skill?

It never writes production code or executes the plan — its only output is the plan document. It also does not write requirements, acceptance criteria, or Gherkin specs; those are inputs produced by a separate spec stage.