loop-maestro

Coordinate multi-phase projects using Ralph Loop phases, hats, and local JSON state.

1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/chipoto69/claude-skills --skill loop-maestro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-maestro
Source: https://github.com/chipoto69/claude-skills/tree/main/loop-maestro
Command: npx skills add https://github.com/chipoto69/claude-skills --skill loop-maestro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about loop-maestro

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

FAQPage Schema
How do I coordinate multi-phase projects with deterministic gates and role assignment?

Coordinate multi-phase projects by decomposing work into specialized roles like architect and tester, using a YAML project plan and local JSON state file to enforce deterministic phase gates and track progress promises for auditability.

What is hat-based workflow orchestration for software project management?

Hat-based workflow orchestration splits multi-phase initiatives into specialized roles such as architect, implementer, tester, and reviewer, reducing coordination noise by applying deterministic completion gates and iterative re-planning to keep project plans honest.

Do I need jq installed to run phase planning and progress tracking scripts?

Yes, jq is a required dependency for processing the local JSON state file used for progress tracking, dependency management, and event auditability during multi-phase project orchestration.

How do I bootstrap a new orchestration project from a YAML plan or preset?

Run the initialization script to create the orchestration directory and state, then load or define phases in project-plan.yaml and use the prompt generation script to start phase execution via the Claude loop runner with completion promises.

Can I track phase status and advance phases manually during a multi-phase workflow?

Yes, you can monitor progress and advance phases using dedicated status and advance-phase scripts, which interact with the local JSON state file to log events and enforce deterministic gating between project phases.

When should I avoid using a deterministic gating approach for project orchestration?

Avoid deterministic gating for simple, single-step tasks that lack distinct design, implementation, testing, and documentation phases, as the overhead of YAML plan management and JSON state tracking adds coordination noise without benefit.