execute-plan

Executes YAML implementation plans via parallel subagent clusters with verified state tracking.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/maycuatroi1/agent-skills --skill execute-plan-maycuatroi1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: execute-plan
Source: https://github.com/maycuatroi1/agent-skills/tree/main/skills/execute-plan
Command: npx skills add https://github.com/maycuatroi1/agent-skills --skill execute-plan-maycuatroi1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long implementation sessions burn context on file reads, failed edits, and test output, and plan state drifts from reality when steps are marked done without evidence. This Skill drives an existing plans/active/<slug>.yaml to completion while keeping the main session thin: subagents absorb the heavy work and return only verified results. ## Core Features & Use Cases - Frontier computation and clustering: Reads plan state via evo harness show and evo harness step --no-input, computes the ready frontier from depends_on, respects blocking steps and checkpoints, and groups steps into parallel-safe clusters with explicit serial justifications. - Subagent contract with verbatim evidence: Each subagent receives the step's what, verify, and note verbatim, is forbidden from editing plan YAML or self-marking done, and must return the exact verify command with the last 15 lines of unmodified output. - Evidence-driven state writes: The main session validates reports, re-runs only missing or invalidated checks, commits staged changes after secret scan and gitnexus detect-changes, then records status and evidence with evo harness step (never --note, which would overwrite existing notes). - Use Case: You have a 20-step migration plan under plans/active. Invoke the skill with the slug; it runs independent steps in parallel subagents, verifies each, commits, updates the YAML, runs evo harness check, and offers a /clear between clusters with the exact re-entry command. ## Quick Start Ask the agent to execute the plan for a given slug, for example: run the execute-plan skill on plans/active/deployments-control-plane.yaml and continue until all steps are done.

Frequently Asked Questions about execute-plan

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

FAQPage Schema
How do I execute a multi-step implementation plan with AI subagents?

Store the plan as YAML under plans/active with steps, depends_on, and verify commands, then invoke this skill with the plan slug. It computes the ready frontier, delegates steps to subagents, verifies their output, and writes status back after each commit.

How to run plan steps in parallel without git conflicts?

Parallel execution is safe only when steps are in different repos or create disjoint new files without committing. Steps sharing files or both committing in one repo must run serially, or use git worktree isolation with a merge afterwards.

Can I resume an interrupted plan execution session?

Yes, resuming is the normal case. The skill derives everything from plan state on entry, so a cleared session recomputes the frontier, skips steps already marked done, and continues exactly where the previous session stopped.

Why should subagents not edit the plan YAML file directly?

Concurrent read-modify-write on one YAML file loses updates, and a subagent cannot judge whether its verify survives review. Only the main session writes state via evo harness step, which validates the reparse before saving.

What happens when a plan step fails verification?

The step stays pending and the failure is recorded; it is never marked done or in_progress as consolation. Environmental blockers are reported to the user, and wrong plan premises require the user to approve amending the plan.

When should I not use subagent-based plan execution?

Do not use it to author plans, which is the create-exec-plan skill's role. It also adds overhead for trivial single-step changes where direct editing in one session is cheaper than spawning and verifying subagents.