{"name":"execute-plan-step-by-step-prompt","description":"A prompt that has an AI coding agent carry out a written implementation plan one task at a time - test first, run the checks after every step, keep a short log of decisions, and stop only for risky or irreversible actions. Use when you already have a plan and want an agent to execute it one task at a time without drifting.","category":"coding-prompts","tags":["planning","agents","tdd"],"models":["any"],"proven":false,"passing_families":0,"model_testing":"Not yet model-tested; testing Jan 2027","url":"https://theskillvault.ai/skills/execute-plan-step-by-step-prompt","api_url":"https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt","raw_url":"https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/raw","body":"# Execute a plan step by step (prompt)\n\nThe plan did the thinking. This prompt keeps the agent on it, proves each step works, and leaves a record you can check.\n\n## When to use\n- You have a plan file or a list of tickets ready to build.\n- The agent skips steps, wanders off plan or claims work is done without running tests.\n- You want it to keep going without asking \"shall I continue?\" after each task.\n\n## Steps\n1. Save the plan in the repo, such as `docs/plan.md`.\n2. Paste the prompt below and point {{PLAN FILE}} at it.\n3. Let it run. Check `docs/plan-log.md` as it goes.\n4. Review the full diff at the end, or ask a fresh agent to review it.\n\n## Prompt\n```text\nCarry out the plan in {{PLAN FILE}}, task by task, in order.\n\nFor each task:\n1. Re-read the task and the files it touches.\n2. Write or update a test that shows the task is not done yet, and watch it fail.\n3. Make the smallest change that makes it pass.\n4. Run the project's full checks (tests, types, lint). Read the output; do not assume.\n5. Commit with a clear message.\n6. Add one line to docs/plan-log.md: task, result, and any decision you made.\n\nRules:\n- If the plan is ambiguous, decide, and log it as \"Ruling: what - why - cost if wrong\". Keep going.\n- Stop and ask me only before: deleting data, anything security-sensitive, pushing, merging, deploying or publishing, or if the plan is too broken to follow.\n- Do not add features the plan does not ask for.\n- Never say a task is done unless its checks passed in this session.\n\nWhen all tasks are done, list what changed, every ruling, and anything left open.\n```\n\n## How to adapt\n- Want a review after each task? Add \"after each commit, pause and show me the diff\".\n- No tests in the project yet? Replace step 2 with \"describe how you will check it manually\".\n\n## Gotchas\n- Keep secrets out of the plan and the log; both get committed.\n- A long plan can outrun the agent's memory. The log file is what lets it pick up again.\n\n## Portability\nWorks with any AI coding agent and any language or test runner. If you use subagents, see build-with-parallel-subagents-prompt instead.\n\n## Done when\n- Every task in the plan is committed with passing checks.\n- The log lists each task and every ruling.\n\n## Example prompt\n\"Execute docs/plan.md step by step, test first, and log your decisions.\"\n\n---\nAdapted from \"executing-plans\" in obra/superpowers (MIT, Copyright (c) 2025 Jesse Vincent). See LICENSE.txt.","files":["LICENSE.txt"],"license":"MIT","license_name":"MIT License","license_url":"https://opensource.org/license/mit","attribution":"Based on work by Jesse Vincent (obra/superpowers, executing-plans) (Copyright (c) 2025 Jesse Vincent, MIT License), https://github.com/obra/superpowers/tree/2ce8aa15d05bd57213e6f746f953aafb7ded7a8b/skills/executing-plans; adapted by TheSkillVault, https://theskillvault.ai","install":{"claude_code":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/raw' -o ~/'.claude/skills/execute-plan-step-by-step-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/files/LICENSE.txt' -o ~/'.claude/skills/execute-plan-step-by-step-prompt/LICENSE.txt'","cursor":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/raw' -o '.cursor/skills/execute-plan-step-by-step-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/files/LICENSE.txt' -o '.cursor/skills/execute-plan-step-by-step-prompt/LICENSE.txt'","agents":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/raw' -o '.agents/skills/execute-plan-step-by-step-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/execute-plan-step-by-step-prompt/files/LICENSE.txt' -o '.agents/skills/execute-plan-step-by-step-prompt/LICENSE.txt'","mcp_url":"https://theskillvault.ai/mcp","cursor_mcp_deeplink":"cursor://anysphere.cursor-deeplink/mcp/install?name=theskillvault&config=eyJ1cmwiOiJodHRwczovL3RoZXNraWxsdmF1bHQuYWkvbWNwIn0%3D","mcp_config":{"mcpServers":{"theskillvault":{"url":"https://theskillvault.ai/mcp"}}}},"bundles":[],"tested_on":[{"family":"chatgpt","name":"ChatGPT","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"claude","name":"Claude","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"gemini","name":"Gemini","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"grok","name":"Grok","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"llama","name":"Llama","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"deepseek","name":"DeepSeek","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"mistral","name":"Mistral","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"qwen","name":"Qwen","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"kimi","name":"Kimi K","outcome":null,"date":null,"source":null,"counts":false,"stale":false}],"proven_rule":{"threshold":5,"window_days":365,"computed_at":"2026-11-02T03:20:33.817Z"}}