Skills

Humanize Rlcr

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

Install

npx skills add PolyArch/humanize --skill humanize-rlcr -g -a claude-code -y
Repository
PolyArch/humanize1.6k
Category
Engineering
Updated
2mo ago
License
See repository
Context cost
Lightabout 876 tokens
Runs scripts
No, instructions only

What it does

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

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:

{{HUMANIZE_RUNTIME_ROOT}}

All commands below assume {{HUMANIZE_RUNTIME_ROOT}}.

Required Sequence

1. Setup

Start the loop with the setup script:

"{{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

Read the whole SKILL.md on GitHub

More in Engineering