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

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:

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

Usage

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

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

Cancel

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