name: plan-driven-implementation
description: Execute attached plan documents in this repo while keeping existing TodoWrite items synced. Use when the user says to implement an attached .plan.md as specified, not edit the plan file, avoid recreating todos, and work through the plan end to end.
Plan-Driven Implementation
When to use
Use this skill when the user provides or references an attached plan document and asks to implement it directly.
Common signals:
- "Implement the plan as specified"
- "Do NOT edit the plan file itself"
- "The todos already exist"
- "Mark them as in_progress as you work"
- "Don't stop until you complete all todos"
Workflow
- Read the attached plan and inspect the current code surface it touches.
- Do not edit the plan file unless the user explicitly changes that instruction.
- Do not recreate TodoWrite items that already exist.
- Mark the first relevant existing todo
in_progressbefore substantial implementation work. - Keep exactly one todo
in_progressat a time. - As each plan section is finished, mark that todo
completedand move the next one toin_progress. - Implement the plan in the same order unless the code forces a small reordering.
- Validate before finishing: run focused checks first, then broader non-E2E validation if the change touches shared paths.
- Run
ReadLintson the files you changed after substantive edits.
Repo-specific guardrails
- Use
uv runfor pytest and other Python commands - Do not start the FastAPI server, systemd service, E2E tests, or live
curlrequests unless the user explicitly asks - Treat existing uncommitted user changes as real context; work with them instead of reverting them
- If the plan affects auth, routes, or deployment docs, include a coordination note in the final response if another surface still needs follow-up
Final response checklist
- Summarize the implemented outcome, not the plan text
- List the validation you actually ran
- Call out anything you could not validate
- Mention any required coordination or natural next step only if it remains outside the requested scope