loop-maestro

What problem does it solve?

This Skill enables teams to orchestrate complex, multi-phase initiatives by decomposing work into Ralph Loop phases and hats, reducing coordination noise and keeping plans honest through iterative re-planning and explicit progress gates.

Core Features & Use Cases

• Hat-based, multi-phase orchestration: Split work into architect, implementer, tester, reviewer, and other specialized roles to streamline collaboration.
• Deterministic gating and progress tracking: Define gates and completion promises per phase; track status in a local JSON state with events for auditability.
• Plan-driven execution from presets or custom plans: Use a YAML project plan or presets to rapidly bootstrap new initiatives and repeat proven patterns.

Quick Start

Initialize a new orchestration and bring it to life:

• Run the initialization script to create the orchestration directory and state:
  bash ~/.claude/skills/loop-maestro/scripts/init-project.sh "<Project Name>"
• Define or load phases in .claude/orchestration/project-plan.yaml (you can start from the included template) and generate phase prompts: bash ~/.claude/skills/loop-maestro/scripts/create-phase-prompt.sh <phase-id>
• Start the first phase by passing the generated prompt to the Claude loop runner: /ralph-loop "$(cat .claude/orchestration/prompts/<phase-id>-phase.md)" --completion-promise "<PHASE_COMPLETE>" --max-iterations 25
• Monitor progress and advance phases with status.sh and advance-phase.sh as needed.