unity-ralph

/unity-ralph — Persistent Verify-Fix Loop

Run a relentless verification loop that refuses to stop until the project is clean: $ARGUMENTS

Named after oh-my-claudecode's persistent execution mode. Where /unity-workflow runs the verifier once (up to 3 internal iterations), ralph runs it repeatedly until there are zero remaining issues — or until hitting the safety limit.

Configuration

Parse $ARGUMENTS for options:

Option	Default	Description
--max-iterations N	10	Maximum outer loop iterations (each runs verifier with up to 3 internal passes)
--focus <path>	all	Limit verification to a specific directory or file pattern
--no-tests	false	Skip test execution between iterations

Everything after the flags is treated as context for the verifier (e.g., "focus on the new combat system").

Loop Protocol

Initialization

1. Record the starting state: git diff --stat to capture baseline
2. Set iteration = 0, previous_issues = ""
3. If --focus was provided, note the scope restriction

Each Iteration

iteration += 1
echo "Ralph iteration {iteration}/{max}: Starting verification pass..."

1. Invoke unity-verifier agent via the Agent tool with:

   • The focus scope (if provided)
   • Context from the previous iteration's remaining issues
   • Instruction to report a structured summary at the end

2. Collect the verifier's final report — look for:

   • "No auto-fixable issues found" or equivalent → SUCCESS, exit loop
   • List of auto-fixed issues → note them
   • List of remaining issues → capture for next iteration

3. Check console via MCP read_console (if available) for compilation errors

4. Run tests via MCP run_tests (if available and --no-tests not set)

5. Progress report:

   Ralph iteration {iteration}/{max}: {fixed_count} issues fixed, {remaining_count} remaining
   

Stall Detection

After each iteration, compare current remaining issues with previous_issues: