claude-execute-phase

Executes lane-based phase plans with worktree-isolated Claude teammates and gated auto-merges.

2|1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Consiliency/agent-harness --skill claude-execute-phase-consiliency
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-execute-phase
Source: https://github.com/Consiliency/agent-harness/tree/main/skills-src/claude/claude-execute-phase
Command: npx skills add https://github.com/Consiliency/agent-harness --skill claude-execute-phase-consiliency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Executing a multi-lane phase plan by hand means manually dispatching agents, tracking lane dependencies, verifying gates, and merging work without clobbering parallel changes. This Skill automates that entire loop: it parses a plan doc produced by claude-plan-phase, dispatches worktree-isolated Claude teammates per lane in DAG order, verifies gates, and auto-merges on green with retry-once failure handling. ## Core Features & Use Cases - DAG-ordered lane dispatch: Parses the plan's Lane Index, topologically sorts lanes, and dispatches ready lanes in parallel waves capped by EXECUTE_MAX_PARALLEL_LANES, each in its own git worktree. - Model-tier routing and retry escalation: Assigns fast/strong/frontier Claude models per lane complexity and escalates tiers on retry, halting all lanes after a second failure. - Merge safety audits: Runs pre-merge destructiveness checks, cross-lane file-touch audits, parent-tree leakage detection, and post-merge import smoke tests before any merge lands. - Resumable state machine: Persists lane and gate state to a JSON state file so interrupted phases resume with --resume. - Use Case: After running /claude-plan-phase to produce plans/phase-plan-v2-p1.md, invoke this Skill to execute all lanes full-auto, merging each into the target branch as its verification gates go green. ## Quick Start Run /claude-execute-phase with the path to your plan doc (or let it auto-detect plans/phase-plan-<VERSION>-<PHASE_ALIAS>.md) on a clean working tree to dispatch and merge all lanes automatically.

Frequently Asked Questions about claude-execute-phase

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

FAQPage Schema
How do I execute a phase plan with parallel Claude agents?▼

Run /claude-execute-phase after claude-plan-phase has produced a plan doc. It parses the lane DAG, dispatches one worktree-isolated teammate per lane in dependency order, verifies each lane's gates, and auto-merges on green with retry-once on failure.

How does lane model selection work in claude-execute-phase?▼

Each lane is assigned a model tier (fast, strong, or frontier) based on rules like contract-authoring, migrations, or mechanical wiring. On first failure the tier escalates one level, and thinking-level guidance is conveyed in the teammate brief.

Can I resume an interrupted phase execution?▼

Yes. Lane and gate state is persisted to .claude/claude-execute-phase-state.json after every transition. Passing --resume skips lanes already merged and continues the remaining dispatch loop from the saved state.

What happens when a lane fails verification twice?▼

The first failure triggers a retry with an escalated model tier and a failure-context brief. A second failure halts the entire dispatch loop, surfaces the failure to the user, and leaves already-merged lanes intact.

Why does claude-execute-phase refuse to merge into main?▼

A merge-target safety gate stops execution before any dispatch if the resolved merge target is main or a protected branch. You must check out or create a dedicated feature branch first so lane merges never mutate a protected branch directly.

When should I not use claude-execute-phase?▼

Skip it when no plan doc exists yet (run claude-plan-phase first), when you want human checkpoints between lanes, or when the plan's DAG has cycles or overlapping owned files. Those plan defects must be fixed before dispatch.