execute-plan

Imported from zak-keown/moe (plugins/moe/.pi/skills/execute-plan/SKILL.md). Install upstream with npx skills add zak-keown/moe --skill execute-plan. Copyright stays with the author.

Executing Plans

Overview

Load plan, review critically, execute all tasks, report when complete.

Announce at start: "I'm using the execute-plan skill to implement this plan."

At this depth: execute-plan runs a plan produced by write-plan, which fires only at the feature depth defined in brainstorming (patch / change / feature). A patch or a change never reaches this skill.

Note: Tell your human partner that Moe works much better with access to subagents (Claude Code, Codex CLI, Codex App, Copilot CLI, and Gemini CLI all qualify; see the per-platform tool refs in ../using-moe/references/). If subagents are available, use sdd instead of this skill.

The Process

Step 1: Load and Review Plan

1. Ensure an isolated workspace: use use-worktrees to create one or verify the existing one
2. Read plan file
3. Review critically - identify any questions or concerns about the plan
4. If concerns: Raise them with your human partner before starting
5. If no concerns: Create todos for the plan items and proceed

Step 2: Execute Tasks

For each task:

1. Mark as in_progress
2. Follow each step exactly (plan has bite-sized steps)
3. Run verifications as specified
4. Mark as completed

Step 3: Complete Development

After all tasks complete and verified:

• Announce: "I'm using the finish-branch skill to complete this work."
• REQUIRED SUB-SKILL: Use finish-branch
• Follow that skill to verify tests, present options, execute choice

When to Stop and Ask for Help

STOP executing immediately when:

• Hit a blocker (missing dependency, test fails, instruction unclear)
• Plan has critical gaps preventing starting
• You don't understand an instruction
• Verification fails repeatedly

Ask for clarification rather than guessing.

When to Revisit Earlier Steps

Return to Review (Step 1) when:

• Partner updates the plan based on your feedback
• Fundamental approach needs rethinking

Don't force through blockers - stop and ask.

Remember

• Review plan critically first
• Follow plan steps exactly
• Don't skip verifications
• Reference skills when plan says to
• Stop when blocked, don't guess
• Never start implementation on main/master branch without explicit user consent