humanize-rlcr

---
name: humanize-rlcr
description: Start RLCR (Ralph-Loop with Codex Review) on Codex using the native Stop hook.
type: flow
user-invocable: false
disable-model-invocation: true
---

# Humanize RLCR Loop

Use this flow as the Codex entrypoint for RLCR.
Codex installs of Humanize require native hooks support and install the Humanize `Stop` hooks automatically.

## Runtime Root

The installer hydrates this skill with an absolute runtime root path:

```bash
{{HUMANIZE_RUNTIME_ROOT}}
```

All commands below assume `{{HUMANIZE_RUNTIME_ROOT}}`.

## Required Sequence

### 1. Setup

Start the loop with the setup script:

```bash
"{{HUMANIZE_RUNTIME_ROOT}}/scripts/setup-rlcr-loop.sh" $ARGUMENTS
```

If setup exits non-zero, stop and report the error.

### 2. Work Round

For each round:

1. Read current loop prompt from `.humanize/rlcr/<timestamp>/round-<N>-prompt.md` (or `finalize` prompt files when in finalize phase).
2. Implement required changes.
3. Commit changes.
4. Write required summary file:
   - Normal phase: `.humanize/rlcr/<timestamp>/round-<N>-summary.md`
   - Finalize phase: `.humanize/rlcr/<timestamp>/finalize-summary.md`
5. Stop or exit normally.
6. Let the native Humanize `Stop` hook run automatically.
7. If the hook blocks exit, follow the returned instructions exactly and continue the next round.

## What This Enforces

The native Stop-hook path enforces:

- state/schema validation (`current_round`, `max_iterations`, `review_started`, `base_branch`, etc.)
- branch consistency checks
- plan-file integrity checks (when applicable)
- incomplete Task/Todo blocking
- git-clean requirement before exit
- `--push-every-round` unpushed-commit blocking
- summary presence checks
- max-iteration handling
- full-alignment rounds (`--full-review-round`)
- strict `COMPLETE`/`STOP` marker handling
- review-phase transition guard (`.review-phase-started` marker)
- code-review gating on `[P0-9]` markers
- hard blocking on codex review failure or empty output
- open-question handling when `ask_codex_question=true`

## Critical Rules

1. Never manually edit `state.md` or `finalize-state.md`.
2. Never skip a blocked hook result by declaring completion manually.
3. Never run ad-hoc `codex exec` / `codex review` in place of the hook-managed phase transitions.
4. Always use files generated by the loop (`round-*-prompt.md`, `round-*-review-result.md`) as source of truth.

## Options

Pass these through `setup-rlcr-loop.sh`:

| Option | Description | Default |
|--------|-------------|---------|
| `path/to/plan.md` | Plan file path | Required unless `--skip-impl` |
| `--plan-file <path>` | Explicit plan path | - |
| `--track-plan-file` | Enforce tracked plan immutability | false |
| `--max N` | Maximum iterations | 42 |
| `--codex-model MODEL:EFFORT` | Codex model and effort for `codex exec` | gpt-5.5:high |
| `--codex-timeout SECONDS` | Codex timeout | 5400 |
| `--base-branch BRANCH` | Base for review phase | auto-detect |
| `--full-review-round N` | Full alignment interval | 5 |
| `--skip-impl` | Start directly in review path | false |
| `--push-every-round` | Require push each round | false |
| `--claude-answer-codex` | Let Claude answer open questions directly | false |
| `--agent-teams` | Enable agent teams mode | false |
| `--yolo` | Skip quiz and enable --claude-answer-codex | false |
| `--skip-quiz` | Skip Plan Understanding Quiz (implicit in skill mode) | false |

Review phase `codex review` runs with `gpt-5.5:high`.

## Usage

```bash
# Start with plan file
/flow:humanize-rlcr path/to/plan.md

# Review-only mode
/flow:humanize-rlcr --skip-impl
```

## Cancel

```bash
"{{HUMANIZE_RUNTIME_ROOT}}/scripts/cancel-rlcr-loop.sh"
```