ralph-wiggum-v2

```

/ralph-wiggum-v2:ralph-loop --project "diablo-starcraft" --completion-promise "DIABLO_STARCRAFT_COMPLETE"

```

Autonomous TDD development loop that uses parallel agent swarms to review code, discover issues, and fix them with test-first methodology until convergence criteria are met.

Phase 1: Discovery & Initialization

1. Locate or create state file: {project}/.ralph/state.json
2. Locate or create categories file: {project}/.ralph/categories.json
3. Bootstrap categories from codebase structure if empty

Phase 2: Parallel Agent Review Swarm

Spawn 3-5 parallel agents with:

• Random category (weighted toward lowest scores)
• Random subcategory within that category
• Random review style (never same as last 3 used)
• Unique focus area (no overlap between agents)

Phase 3: TDD Implementation Cycle

For each finding:

1. Write failing test first
2. Implement minimal fix
3. Verify test passes
4. Update state

Phase 4: Category Evolution

After each iteration:

1. Merge new discoveries
2. Recalculate scores
3. Meta-review (every 5 iterations)

Phase 5: Convergence Detection

Complete when:

• 10 consecutive clean iterations
• All category scores >= 95/100
• All tests passing
• Game runs without crashes

---

```json

{

"project": "diablo-starcraft",

"iteration": 0,

"consecutiveCleanIterations": 0,

"requiredCleanIterations": 10,

"completionPromise": "DIABLO_STARCRAFT_COMPLETE",

"categories": {},

"discoveryLog": [],

"lastReviewStyles": [],

"agentHistory": [],

"startedAt": "",

"lastUpdated": ""

}

```

```json

{

"categories": {

"": {

"score": 50,

"maxScore": 100,

"subcategories": {

"": {

"score": 50,

"issues": [],

"lastReviewed": null,

"reviewCount": 0

}

},

"discoveredAt": 0,

"lastUpdated": ""

}

}

}

```

---

Code Quality

| Style | Focus |

|-------|-------|

| NITPICKER | Formatting, naming, tiny inconsistencies |

| REFACTORER | Duplication, abstraction opportunities |

| DRY_ENFORCER | Copy-paste code, repeated patterns |

| TYPE_ZEALOT | Type safety, any usage, casting |

| SOLID_ADHERENT | SOLID principle violations |

| API_PURIST | Interface design, contracts, signatures |

Reliability

| Style | Focus |

|-------|-------|

| DEBUGGER | Logic errors, off-by-one, wrong operators |

| EDGE_CASE_HUNTER | Boundary conditions, null/undefined |

| ERROR_HANDLER | Missing try/catch, unhandled promises |

| STATE_MACHINE_ANALYST | Invalid state transitions |

| CONCURRENCY_EXPERT | Race conditions, async bugs |

| MEMORY_LEAK_HUNTER | Listeners not removed, growing arrays |

Performance

| Style | Focus |

|-------|-------|

| PERFORMANCE_HAWK | O(n²), unnecessary renders, hot paths |

| ALLOCATION_AUDITOR | Object churn, GC pressure |

| RENDER_OPTIMIZER | DOM thrashing, layout thrashing |

Security

| Style | Focus |

|-------|-------|

| SECURITY_AUDITOR | XSS, injection, unsafe operations |

| INPUT_VALIDATOR | Unsanitized user input |

Architecture

| Style | Focus |

|-------|-------|

| ARCHITECT | Coupling, cohesion, separation of concerns |

| DEPENDENCY_AUDITOR | Circular deps, tight coupling |

| LAYER_GUARDIAN | Layer violations, wrong abstractions |

Testing

| Style | Focus |

|-------|-------|

| TEST_SKEPTIC | Coverage gaps, weak assertions |

| MUTATION_TESTER | Tests that always pass |

| INTEGRATION_ANALYST | Unit vs integration gaps |

Game-Specific

| Style | Focus |

|-------|-------|

| DIABLO_VETERAN | ARPG conventions, loot, skills, combat feel |

| STARCRAFT_FAN | Faction identity, unit feel, SC universe |

| GAME_FEEL_EXPERT | Juice, polish, responsiveness |

| BALANCE_DESIGNER | Numbers, progression, fairness |

| PLAYER_PSYCHOLOGY | Motivation, reward loops |

| SPEEDRUNNER | Exploits, sequence breaks |

| COMPLETIONIST | Missing edge cases in content |

| FIRST_TIME_USER | Onboarding, confusion points |

Meta

| Style | Focus |

|-------|-------|

| FRESH_EYES | What would confuse a new developer? |

| DOCUMENTATION_STICKLER | Missing/wrong comments |

| FUTURE_MAINTAINER | Technical debt accumulation |

---

```json

{

"agentId": "",

"category": "",

"subcategory": "",

"reviewStyle": "