maestro-execute

Execute plan.json tasks in parallel waves with CSV-driven state.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-execute
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro-execute
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/maestro-execute
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-execute

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maestro-execute automates the execution of phased implementation plans by turning plan.json task definitions into a CSV-driven, wave-executed workflow so teams can complete multi-step engineering phases reliably and faster. It eliminates manual coordination of sequential dependencies, hand-off context, and per-task verification by running agents or CLIs in controlled parallel waves with resume and checkpoint support.

Core Features & Use Cases

  • Wave-based Parallel Execution: Pre-computed waves from plan.json drive parallel task runs within each wave while preserving strict wave ordering and cross-wave context propagation.
  • CSV Source of Truth: tasks.csv acts as the canonical master state for task status, findings, modified files, and test results enabling breakpoint resume and deterministic merges.
  • Robust Failure & Resume Handling: Detects completed tasks, marks dependent tasks as skipped on failure, supports auto-commit, retry limits, blocked-task prompts, and append-only discovery logging for auditability.
  • Use Case: Run an execution session for Phase 3 of a codebase roadmap to spawn agents that implement, verify, and commit each task while producing a context.md execution report and discoveries.ndjson board.

Quick Start

Execute maestro-execute for the desired phase with concurrency and auto-commit options to run wave-by-wave parallel task execution and generate the results and context report.

Frequently Asked Questions about maestro-execute

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

FAQPage Schema
How do I automate parallel task execution from a phased implementation plan?

Automate parallel task execution by converting plan.json definitions into a CSV-driven workflow, running tasks in pre-computed waves while preserving strict ordering and propagating cross-wave context.

What is wave-based execution for multi-agent task orchestration?

Wave-based execution groups independent tasks into parallel runs within each wave while maintaining strict wave ordering, allowing multiple agents or CLIs to execute concurrently before advancing to the next wave.

How does CSV state management handle task resume and checkpoint recovery?

CSV state management uses tasks.csv as the canonical master state for task status, findings, and modified files, enabling breakpoint resume by detecting completed tasks and skipping dependent tasks on failure.

Can I control concurrency limits and auto-commit during multi-agent execution?

Concurrency limits and auto-commit support are configurable execution options that control parallel task runs and automate git commits per task during wave-by-wave execution sessions.

What happens to dependent tasks when a parallel execution task fails?

When a task fails, the execution pipeline marks dependent tasks as skipped, applies retry limits, prompts for blocked tasks, and logs failures to an append-only discovery board for auditability.

Do I need plan.json to start CSV-driven task execution?

Yes, plan.json provides the pre-computed wave definitions and task structures that the execution pipeline reads to build tasks.csv, which then serves as the source of truth for state management.