# Humanize

Iterative development with AI review.

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

## Install

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

## Description

Iterative development with AI review. Provides RLCR (Ralph-Loop with Codex Review) for implementation planning and code review loops.

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

# Humanize - Iterative Development with AI Review

Humanize creates a feedback loop where AI implements your plan while another AI independently reviews the work, ensuring quality through continuous refinement.

## Runtime Root

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

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

All command examples below use `{{HUMANIZE_RUNTIME_ROOT}}`.

## Core Philosophy

**Iteration over Perfection**: Instead of expecting perfect output in one shot, Humanize leverages an iterative feedback loop where:
- AI implements your plan
- Another AI independently reviews progress
- Issues are caught and addressed early
- Work continues until all acceptance criteria are met

## Available Workflows

### 1. RLCR Loop - Iterative Development with Review

The RLCR (Ralph-Loop with Codex Review) loop has two phases:

**Phase 1: Implementation**
- AI works on the implementation plan
- AI writes a summary of work completed
- Codex reviews the summary for completeness and correctness
- If issues found → feedback loop continues
- If Codex outputs "COMPLETE" → enters Review Phase

**Phase 2: Code Review**
- `codex review --base <branch>` checks code quality
- Issues marked with `[P0-9]` severity markers
- If issues found → AI fixes them and continues
- If no issues → loop completes with Finalize Phase
- On Codex CLI `0.114.0+` with `codex_hooks` enabled, Humanize installs a native `Stop` hook so exit gating runs automatically

### 2. Generate Plan - Structured Plan from Draft

Transforms a rough draft document into a structured implementation plan with:
- Clear goal description
- Acceptance criteria in AC-X format with TDD-style positive/negative tests
- Path boundaries (upper/lower bounds, allowed choices)
- Feasibility hints and conceptual approach
- Dependencies and milestone sequencing

## Commands Reference

### Start RLCR Loop

```bash
# With a plan file
"{{HUMANIZE_RUNTIME_ROOT}}/scripts/setup-rlcr-loop.sh" path/to/plan.md

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