ralph

---
name: ralph
description: >
  PRD-loop persistence mode: iterate BUILD until verifier passes or max blocked attempts.
  Triggers ralph keep going keywords and /ohc-ralph. Deactivate via stop ralph.
allowed-tools: Read Write Bash
---

# Ralph persistence

Operate with **`scripts/ralph.js`** and session state files.

## Lifecycle

1. **Activate** via keyword `"ralph"`, `"keep going"`, or `/ohc-ralph`. On first run without an active PRD, the script initializes `.ohc/state/sessions/<id>/prd.json` from the current task narrative.
2. **Loop** — execute BUILD iteration; verifier runs tests; persist `RESULT`-style narrative in worker notes where applicable.
3. **Advance** — on success mark story done and move to next `prd.stories[]` entry; on repeated block update `attempt_count`; hard-stop after `stopOnBlocked` (keyword-map default **3**).
4. **Deactivate** — user says `"stop ralph"` or `"ralph stop"` (clears active skill flag in `.ohc/state/active-skills.json`).

## State files

- `.ohc/state/ralph-state.json` — active session id, story index, iteration counters
- `.ohc/state/sessions/<id>/prd.json` — `{ goal, stories:[{title,status,attempt_count}], ... }` per `scripts/ralph.js`

## Guardrails

- Do not claim DONE without verifier-aligned evidence.
- If stories are ambiguous, widen them only after syncing with **`writing-plans`** or user OK.