Coding prompts · Prompt

Execute a plan step by step (prompt)

execute-plan-step-by-step-prompt

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.

Works with: Any AI Not yet model-tested; testing Jan 2027

View raw SKILL.mdInstall

Paste it into ChatGPT, Claude, Gemini or any AI chat, then tell it about your project. How it works

Install in Claude Code, Cursor or Codex (optional)

Only for AI coding tools that read skill folders. Run one line in a terminal, in your project folder. It downloads this skill's text files from TheSkillVault and nothing else; you can read them first with “View raw SKILL.md”.

Claude Code (all your projects)

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 (this project)

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'

Codex and other Agent Skills tools (this project)

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'

Or connect the whole library over MCP

Add TheSkillVault to Cursor or add this to your app's MCP settings (read-only; help):

{
  "mcpServers": {
    "theskillvault": {
      "url": "https://theskillvault.ai/mcp"
    }
  }
}

The plan did the thinking. This prompt keeps the agent on it, proves each step works, and leaves a record you can check.

When to use

  • You have a plan file or a list of tickets ready to build.
  • The agent skips steps, wanders off plan or claims work is done without running tests.
  • You want it to keep going without asking "shall I continue?" after each task.

Steps

  1. Save the plan in the repo, such as docs/plan.md.
  2. Paste the prompt below and point {{PLAN FILE}} at it.
  3. Let it run. Check docs/plan-log.md as it goes.
  4. Review the full diff at the end, or ask a fresh agent to review it.

Prompt

Carry out the plan in {{PLAN FILE}}, task by task, in order.

For each task:
1. Re-read the task and the files it touches.
2. Write or update a test that shows the task is not done yet, and watch it fail.
3. Make the smallest change that makes it pass.
4. Run the project's full checks (tests, types, lint). Read the output; do not assume.
5. Commit with a clear message.
6. Add one line to docs/plan-log.md: task, result, and any decision you made.

Rules:
- If the plan is ambiguous, decide, and log it as "Ruling: what - why - cost if wrong". Keep going.
- 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.
- Do not add features the plan does not ask for.
- Never say a task is done unless its checks passed in this session.

When all tasks are done, list what changed, every ruling, and anything left open.

How to adapt

  • Want a review after each task? Add "after each commit, pause and show me the diff".
  • No tests in the project yet? Replace step 2 with "describe how you will check it manually".

Gotchas

  • Keep secrets out of the plan and the log; both get committed.
  • A long plan can outrun the agent's memory. The log file is what lets it pick up again.

Portability

Works with any AI coding agent and any language or test runner. If you use subagents, see build-with-parallel-subagents-prompt instead.

Done when

  • Every task in the plan is committed with passing checks.
  • The log lists each task and every ruling.

Example prompt

"Execute docs/plan.md step by step, test first, and log your decisions."

---

Adapted from "executing-plans" in obra/superpowers (MIT, Copyright (c) 2025 Jesse Vincent). See LICENSE.txt.

Bundled files

Licence

Adapted from Jesse Vincent (obra/superpowers, executing-plans) (Copyright (c) 2025 Jesse Vincent), MIT License. Adapted by TheSkillVault: reduced the inline-execution process to a paste-in prompt with an original progress log; dropped subagent and harness references; added steps, adapt notes, safety stops and done-when.

Licence: MIT License. Attribution when you reuse it: 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