humanize
By polyarch
Run AI-driven iterative development loops where Claude implements structured plans from drafts while Codex independently reviews progress, enforces quality via RLCR cycles, automates Git commits, and fixes GitHub PR comments until approval.
Component Overview
Install
npx claudepluginhub polyarch/humanize --plugin humanizeComponent Details
Commands (6)
Cancel active PR loop
Cancel active RLCR loop
Generate implementation plan from draft document
Refine an annotated implementation plan and generate a QA ledger
Start PR review loop with bot monitoring
Start iterative loop with Codex review
Agents (4)
Selects required BitLesson entries for a specific sub-task. Use before execution for every task or sub-task.
Checks if a draft document is relevant to the current repository. Use when validating draft content for gen-plan command.
Checks plan relevance and compliance before RLCR loop. Use when validating plan files for start-rlcr-loop command.
Analyzes a plan and generates multiple-choice technical comprehension questions to verify user understanding before RLCR loop. Use when validating user readiness for start-rlcr-loop command.
Skills (5)
Consult Codex as an independent expert. Sends a question or task to codex exec and returns the response.
Generate a structured implementation plan from a draft document. Validates input, checks relevance, analyzes for issues, and generates a complete plan.md with acceptance criteria.
Refine an annotated implementation plan into a comment-free plan and a QA ledger while preserving the gen-plan schema.
Start RLCR (Ralph-Loop with Codex Review) with hook-equivalent enforcement from skill mode by reusing the existing stop-hook logic.
Iterative development with AI review. Provides RLCR (Ralph-Loop with Codex Review) for implementation planning and code review loops, plus PR review automation with bot monitoring.
Hooks (1)
README
Humanize
Current Version: 1.15.4
Derived from the GAAC (GitHub-as-a-Context) project.
A Claude Code plugin that provides iterative development with independent AI review. Build with confidence through continuous feedback loops.
What is RLCR?
RLCR stands for Ralph-Loop with Codex Review, inspired by the official ralph-loop plugin and enhanced with independent Codex review. The name also reads as Reinforcement Learning with Code Review -- reflecting the iterative cycle where AI-generated code is continuously refined through external review feedback.
Core Concepts
- Iteration over Perfection -- Instead of expecting perfect output in one shot, Humanize leverages continuous feedback loops where issues are caught early and refined incrementally.
- One Build + One Review -- Claude implements, Codex independently reviews. No blind spots.
- Ralph Loop with Swarm Mode -- Iterative refinement continues until all acceptance criteria are met. Optionally parallelize with Agent Teams.
- Begin with the End in Mind -- Before the loop starts, Humanize verifies that you understand the plan you are about to execute. The human must remain the architect. (Details)
How It Works
The loop has two phases: Implementation (Claude works, Codex reviews summaries) and Code Review (Codex checks code quality with severity markers). Issues feed back into implementation until resolved.
Install
# Add PolyArch marketplace
/plugin marketplace add PolyArch/humanize
# If you want to use development branch for experimental features
/plugin marketplace add PolyArch/humanize#dev
# Then install humanize plugin
/plugin install humanize@PolyArch
Requires codex CLI for review. See the full Installation Guide for prerequisites and alternative setup options.
Quick Start
-
Generate a plan from your draft:
/humanize:gen-plan --input draft.md --output docs/plan.md -
Refine an annotated plan before implementation when reviewers add
CMT:...ENDCMTcomments:/humanize:refine-plan --input docs/plan.md -
Run the loop:
/humanize:start-rlcr-loop docs/plan.md -
Monitor progress:
source <path/to/humanize>/scripts/humanize.sh humanize monitor rlcr
Monitor Dashboard
Documentation
- Usage Guide -- Commands, options, environment variables
- Install for Claude Code -- Full installation instructions
- Install for Codex -- Codex skill runtime setup
- Install for Kimi -- Kimi CLI skill setup
- Configuration -- Shared config hierarchy and override rules
- Bitter Lesson Workflow -- Project memory, selector routing, and delta validation
License
MIT
Similar Plugins
fullstack-dev-skills
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
No model invocation
Executes directly as bash, bypassing the AI model