maestro-execute

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.