ITERATION N:
    |
    +---> Detect Task Phase
    |         |
    |         +---> Research? --> Gemini (search/megacontext)
    |         +---> Media?    --> Gemini (imagen/veo)
    |         +---> Iterate?  --> Codex (yolo/full-auto)
    |         +---> Decide?   --> LLM Council (consensus)
    |         +---> Reason?   --> Claude (agents)
    |
    +---> Execute with Optimal Model
    |
    +---> Check Completion Promise
    |         |
    |         +---> Found? --> EXIT SUCCESS
    |         +---> Not found? --> CONTINUE
    |
    +---> ITERATION N+1 (until max)

/ralph-multimodel "Build REST API, research best practices, implement, test, fix failures until all pass"

CODEX_MODE=sandbox /ralph-multimodel "Experiment with auth refactoring, verify tests"

USE_COUNCIL=true /ralph-multimodel "Design authentication architecture with consensus"

MAX_ITERATIONS=100 /ralph-multimodel "Complete feature X with documentation, Output <promise>DONE</promise> when finished"

bash scripts/multi-model/ralph-multimodel.sh "<task>" "<loop_id>"

# Environment options:
MAX_ITERATIONS=30        # Maximum loop iterations
COMPLETION_PROMISE=DONE  # Text signaling completion
USE_COUNCIL=false        # Use LLM Council for decisions
CODEX_MODE=full-auto     # Codex mode: yolo, full-auto, sandbox

META-LOOP INTEGRATION:
    |
    +---> PROPOSE (auditors detect issues)
    |         |
    |         +---> Ralph Multi-Model for implementation
    |
    +---> TEST (frozen eval harness)
    |
    +---> COMPARE (baseline vs candidate)
    |
    +---> COMMIT (if improved)
    |
    +---> MONITOR (7-day window)
    |
    +---> ROLLBACK (if regressed)

/ralph-multimodel "Build user dashboard:
1. Research React dashboard best practices (Gemini)
2. Generate UI mockup (Gemini Media)
3. Implement frontend components (Claude)
4. Build backend API (Codex yolo)
5. Write tests (Claude)
6. Fix all failing tests (Codex full-auto)
Output <promise>ALL_TESTS_PASS</promise> when done"

MAX_ITERATIONS=50 CODEX_MODE=sandbox /ralph-multimodel "
Refactor auth system:
1. Analyze entire codebase architecture (Gemini megacontext)
2. Identify all auth touchpoints
3. Implement new JWT pattern in sandbox (Codex)
4. Run tests and fix failures
Output <promise>REFACTOR_COMPLETE</promise> when all tests pass"

USE_COUNCIL=true /ralph-multimodel "
Decide database strategy:
1. Research PostgreSQL vs MongoDB for our use case (Gemini)
2. Get multi-model consensus on approach (Council)
3. Document decision
Output <promise>DECISION_MADE</promise>"