# Humanize Rlcr

Start RLCR (Ralph-Loop with Codex Review) on Codex using the native Stop hook.

- Repository: https://github.com/PolyArch/humanize (1577 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-08-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add PolyArch/humanize --skill humanize-rlcr -g -a claude-code -y`
Codex: `npx skills add PolyArch/humanize --skill humanize-rlcr -g -a codex -y`
Cursor: `npx skills add PolyArch/humanize --skill humanize-rlcr -g -a cursor -y`
Gemini CLI: `npx skills add PolyArch/humanize --skill humanize-rlcr -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add PolyArch/humanize`

## Description

Start RLCR (Ralph-Loop with Codex Review) on Codex using the native Stop hook.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/PolyArch/humanize/blob/HEAD/skills/humanize-rlcr/SKILL.md