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.