Refactor: Change loop directory from .humanize-loop.local to .humanize/rlcr

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "humanize",
       "source": "./",
       "description": "Humanize - An iterative development plugin that uses Codex to review Claude's work. Creates a feedback loop where Claude implements plans and Codex independently reviews progress, ensuring quality through continuous refinement.",
-      "version": "1.1.3"
+      "version": "1.1.4"
     }
   ]
 }

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "humanize",
   "description": "Humanize - An iterative development plugin that uses Codex to review Claude's work. Creates a feedback loop where Claude implements plans and Codex independently reviews progress, ensuring quality through continuous refinement.",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "author": {
     "name": "humania-org"
   },

.claude/CLAUDE.md

@@ -3,6 +3,5 @@ This is a Claude Code plugin that provides iterative development with Codex revi
 
 # Humanize Project Rules
 - Everything about this project, including but not limited to implementations, comments, tests and documentations should be in English. No Emoji or CJK char is allowed.
-- **MANDATORY**: Every commit MUST include a version bump in `.claude-plugin/plugin.json` and `README.md` (the "Current Version" line). This applies to ALL commits without exception - bug fixes, features, documentation changes, etc. Increment the patch version (e.g., 1.0.0 -> 1.0.1) for each commit.
-- Every `git push` or `git commit` MUST confirm with user first, MUST NOT commit or push to remote without check with user.
+- If under `main` branch, every commit MUST include a version bump in `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` and `README.md` (the "Current Version" line). If not under `main` branch, please make sure that the current branch's `version` in those three files has a incremental update compared to that of `main` branch. The `version` must be identical in those three files.
 - Version number must be in format of `X.Y.Z` where X/Y/Z is numeric number. Version MUST NOT include anything other than `X.Y.Z`. For example, a good version is `9.732.42`; Bad version examples (MUST NOT USE): `3.22.7-alpha` (extra "-alpha" string), `9.77.2 (2026-01-07)` (useless date/timestamp).

.gitignore

@@ -1,8 +1,8 @@
 # Scratchpad
 temp
 
-# Humanize loop state directory (used by start-rlcr-loop)
-.humanize-loop.local/
+# Humanize state directories (used by start-rlcr-loop)
+.humanize*
 
 # Python cache
 __pycache__/

README.md

@@ -1,6 +1,6 @@
 # Humanize
 
-**Current Version: 1.1.3**
+**Current Version: 1.1.4**
 
 > Derived from the [GAAC (GitHub-as-a-Context)](https://github.com/SihaoLiu/gaac) project.
 
@@ -72,17 +72,17 @@ Your plan file should contain:
 
 ### Step 3: Monitor Progress
 
-All iteration artifacts are saved in `.humanize-loop.local/<timestamp>/`:
+All iteration artifacts are saved in `.humanize/rlcr/<timestamp>/`:
 
 ```bash
 # View current round
-cat .humanize-loop.local/*/state.md
+cat .humanize/rlcr/*/state.md
 
 # View Claude's latest summary
-cat .humanize-loop.local/*/round-*-summary.md | tail -50
+cat .humanize/rlcr/*/round-*-summary.md | tail -50
 
 # View Codex's review feedback
-cat .humanize-loop.local/*/round-*-review-result.md | tail -50
+cat .humanize/rlcr/*/round-*-review-result.md | tail -50
 ```
 
 **Real-time Monitoring Dashboard** (Recommended):
@@ -113,7 +113,7 @@ This provides a real-time dashboard showing:
 
 **The loop is fully interruptible** - you can exit Claude Code at any time and resume later:
 
-- **Loop state**: Controlled solely by the presence of `state.md` in the current loop directory (newest timestamp in `.humanize-loop.local/`)
+- **Loop state**: Controlled solely by the presence of `state.md` in the current loop directory (newest timestamp in `.humanize/rlcr/`)
 - **Resume**: Simply restart Claude Code in the same directory - the loop continues automatically
 - **Cancel**: Rename `state.md` to `cancel-state.md` to stop the loop permanently
 
@@ -122,7 +122,7 @@ This provides a real-time dashboard showing:
 /humanize:cancel-rlcr-loop
 
 # Or manually rename state file (find newest loop directory first)
-LOOP_DIR=$(ls -1d .humanize-loop.local/*/ | sort -r | head -1)
+LOOP_DIR=$(ls -1d .humanize/rlcr/*/ | sort -r | head -1)
 mv "${LOOP_DIR}state.md" "${LOOP_DIR}cancel-state.md"
 ```
 
@@ -241,7 +241,7 @@ humanize/
 
 ## State Directory Structure
 
-When loop is active, creates: `.humanize-loop.local/<TIMESTAMP>/`
+When loop is active, creates: `.humanize/rlcr/<TIMESTAMP>/`
 
 **Files Created**:
 - `state.md` - Current round, config (YAML frontmatter). Presence indicates active loop.

commands/cancel-rlcr-loop.md

@@ -1,6 +1,6 @@
 ---
 description: "Cancel active RLCR loop"
-allowed-tools: ["Bash(ls -1d .humanize-loop.local/*/)", "Bash(mv .humanize-loop.local/*/state.md .humanize-loop.local/*/cancel-state.md)", "Bash(cat .humanize-loop.local/*/state.md)", "Read"]
+allowed-tools: ["Bash(ls -1d .humanize/rlcr/*/)", "Bash(mv .humanize/rlcr/*/state.md .humanize/rlcr/*/cancel-state.md)", "Bash(cat .humanize/rlcr/*/state.md)", "Read"]
 hide-from-slash-command-tool: "true"
 ---
 
@@ -11,7 +11,7 @@ To cancel the active loop:
 1. Find the current loop directory (newest timestamp):
 
 ```bash
-LOOP_DIR=$(ls -1d .humanize-loop.local/*/ 2>/dev/null | sort -r | head -1)
+LOOP_DIR=$(ls -1d .humanize/rlcr/*/ 2>/dev/null | sort -r | head -1)
 echo "Loop dir: ${LOOP_DIR:-NONE}"
 ```
 

hooks/lib/loop-common.sh

@@ -146,10 +146,10 @@ is_state_file_path() {
     echo "$path_lower" | grep -qE 'state\.md$'
 }
 
-# Check if a path is inside .humanize-loop.local directory
+# Check if a path is inside .humanize/rlcr directory
 is_in_humanize_loop_dir() {
     local path="$1"
-    echo "$path" | grep -q '\.humanize-loop\.local/'
+    echo "$path" | grep -q '\.humanize/rlcr/'
 }
 
 # Check if a shell command attempts to modify a file matching the given pattern

hooks/loop-bash-validator.sh

@@ -34,7 +34,7 @@ COMMAND_LOWER=$(to_lower "$COMMAND")
 # ========================================
 
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 ACTIVE_LOOP_DIR=$(find_active_loop "$LOOP_BASE_DIR")
 
 # If no active loop, allow all commands
@@ -80,7 +80,7 @@ fi
 # Plan backup is read-only - protects plan integrity during loop
 # Use command_modifies_file helper for consistent pattern matching
 
-if command_modifies_file "$COMMAND_LOWER" "\.humanize-loop\.local(/[^/]+)?/plan\.md"; then
+if command_modifies_file "$COMMAND_LOWER" "\.humanize/rlcr(/[^/]+)?/plan\.md"; then
     FALLBACK="Writing to plan.md backup is not allowed during RLCR loop."
     REASON=$(load_and_render_safe "$TEMPLATE_DIR" "block/plan-backup-protected.md" "$FALLBACK")
     echo "$REASON" >&2

hooks/loop-codex-stop-hook.sh

@@ -5,7 +5,7 @@
 # Intercepts Claude's exit attempts and uses Codex to review work.
 # If Codex doesn't confirm completion, blocks exit and feeds review back.
 #
-# State directory: .humanize-loop.local/<timestamp>/
+# State directory: .humanize/rlcr/<timestamp>/
 # State file: state.md (current_round, max_iterations, codex config)
 # Summary file: round-N-summary.md (Claude's work summary)
 # Review prompt: round-N-review-prompt.md (prompt sent to Codex)
@@ -41,7 +41,7 @@ HOOK_INPUT=$(cat)
 # ========================================
 
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 
 # Source shared loop functions and template loader
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
@@ -354,17 +354,17 @@ if command -v git &>/dev/null && git rev-parse --git-dir &>/dev/null 2>&1; then
         # Check for special cases in untracked files
         UNTRACKED=$(echo "$GIT_STATUS" | grep '^??' || true)
 
-        # Check if .humanize-loop.local is untracked
-        if echo "$UNTRACKED" | grep -q '\.humanize-loop\.local'; then
+        # Check if .humanize* directories are untracked (includes .humanize/ and any legacy .humanize-* dirs)
+        if echo "$UNTRACKED" | grep -q '\.humanize'; then
             HUMANIZE_LOCAL_NOTE=$(load_template "$TEMPLATE_DIR" "block/git-not-clean-humanize-local.md" 2>/dev/null)
             if [[ -z "$HUMANIZE_LOCAL_NOTE" ]]; then
-                HUMANIZE_LOCAL_NOTE="Note: .humanize-loop.local/ is intentionally untracked."
+                HUMANIZE_LOCAL_NOTE="Note: .humanize* directories are intentionally untracked."
             fi
             SPECIAL_NOTES="$SPECIAL_NOTES$HUMANIZE_LOCAL_NOTE"
         fi
 
         # Check for other untracked files (potential artifacts)
-        OTHER_UNTRACKED=$(echo "$UNTRACKED" | grep -v '\.humanize-loop\.local' || true)
+        OTHER_UNTRACKED=$(echo "$UNTRACKED" | grep -v '\.humanize' || true)
         if [[ -n "$OTHER_UNTRACKED" ]]; then
             UNTRACKED_NOTE=$(load_template "$TEMPLATE_DIR" "block/git-not-clean-untracked.md" 2>/dev/null)
             if [[ -z "$UNTRACKED_NOTE" ]]; then
@@ -855,7 +855,7 @@ if [[ "$LAST_LINE_TRIMMED" == "STOP" ]]; then
         echo "Codex detected development stagnation during Full Alignment Check (Round $CURRENT_ROUND)." >&2
         echo "The loop has been stopped to prevent further unproductive iterations." >&2
         echo "" >&2
-        echo "Review the historical round files in .humanize-loop.local/$(basename "$LOOP_DIR")/ to understand what went wrong." >&2
+        echo "Review the historical round files in .humanize/rlcr/$(basename "$LOOP_DIR")/ to understand what went wrong." >&2
         echo "Consider:" >&2
         echo "  - Revisiting the original plan for clarity" >&2
         echo "  - Breaking down the task into smaller pieces" >&2

hooks/loop-edit-validator.sh

@@ -44,7 +44,7 @@ if is_round_file_type "$FILE_PATH_LOWER" "prompt"; then
 fi
 
 # ========================================
-# Check if File is in .humanize-loop.local
+# Check if File is in .humanize/rlcr
 # ========================================
 
 if ! is_in_humanize_loop_dir "$FILE_PATH"; then
@@ -56,7 +56,7 @@ fi
 # ========================================
 
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 ACTIVE_LOOP_DIR=$(find_active_loop "$LOOP_BASE_DIR")
 
 if [[ -z "$ACTIVE_LOOP_DIR" ]]; then
@@ -80,7 +80,7 @@ fi
 
 FILENAME=$(basename "$FILE_PATH")
 if [[ "$FILENAME" == "plan.md" ]]; then
-    if [[ "$FILE_PATH" == *"/.humanize-loop.local/"* ]]; then
+    if [[ "$FILE_PATH" == *"/.humanize/rlcr/"* ]]; then
         FALLBACK="Editing plan.md backup is not allowed during RLCR loop."
         REASON=$(load_and_render_safe "$TEMPLATE_DIR" "block/plan-backup-protected.md" "$FALLBACK")
         echo "$REASON" >&2
@@ -104,9 +104,9 @@ fi
 
 if is_round_file_type "$FILE_PATH_LOWER" "summary"; then
     # Extract filename from path (portable - works in bash and zsh)
-    CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize-loop\.local/[^/]*/\(.*\)$|\1|p')
+    CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize/rlcr/[^/]*/\(.*\)$|\1|p')
     if [[ -z "$CLAUDE_FILENAME" ]]; then
-        CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize-loop\.local/\(.*\)$|\1|p')
+        CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize/rlcr/\(.*\)$|\1|p')
     fi
 
     if [[ -n "$CLAUDE_FILENAME" ]]; then

hooks/loop-plan-file-validator.sh

@@ -20,7 +20,7 @@ source "$SCRIPT_DIR/lib/loop-common.sh"
 INPUT=$(cat)
 
 # Find active loop using shared function
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 LOOP_DIR=$(find_active_loop "$LOOP_BASE_DIR")
 
 # If no active loop, allow exit

hooks/loop-read-validator.sh

@@ -4,7 +4,7 @@
 #
 # Blocks Claude from reading:
 # - Wrong round's prompt/summary files (outdated information)
-# - Round files from wrong locations (not in .humanize-loop.local/)
+# - Round files from wrong locations (not in .humanize/rlcr/)
 # - Round files from old session directories
 # - Todos files (should use native TodoWrite instead)
 #
@@ -54,7 +54,7 @@ IN_HUMANIZE_LOOP_DIR=$(is_in_humanize_loop_dir "$FILE_PATH" && echo "true" || ec
 # ========================================
 
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 ACTIVE_LOOP_DIR=$(find_active_loop "$LOOP_BASE_DIR")
 
 if [[ -z "$ACTIVE_LOOP_DIR" ]]; then

hooks/loop-write-validator.sh

@@ -6,7 +6,7 @@
 # - Todos files (should use native TodoWrite instead)
 # - Prompt files (read-only, generated by Codex)
 # - Wrong round number summary files
-# - Summary files outside .humanize-loop.local/
+# - Summary files outside .humanize/rlcr/
 # - Goal tracker after Round 0
 #
 
@@ -51,13 +51,13 @@ fi
 IS_SUMMARY_FILE=$(is_round_file_type "$FILE_PATH_LOWER" "summary" && echo "true" || echo "false")
 IN_HUMANIZE_LOOP_DIR=$(is_in_humanize_loop_dir "$FILE_PATH" && echo "true" || echo "false")
 
-# If not a summary file and not in .humanize-loop.local, allow normally
+# If not a summary file and not in .humanize/rlcr, allow normally
 if [[ "$IS_SUMMARY_FILE" == "false" ]] && [[ "$IN_HUMANIZE_LOOP_DIR" == "false" ]]; then
     exit 0
 fi
 
-# For state.md, goal-tracker.md, and plan.md in .humanize-loop.local, we need further validation
-# For other files in .humanize-loop.local that aren't summaries, allow them
+# For state.md, goal-tracker.md, and plan.md in .humanize/rlcr, we need further validation
+# For other files in .humanize/rlcr that aren't summaries, allow them
 FILENAME=$(basename "$FILE_PATH")
 IS_PLAN_BACKUP=$([[ "$FILENAME" == "plan.md" ]] && echo "true" || echo "false")
 if [[ "$IN_HUMANIZE_LOOP_DIR" == "true" ]] && [[ "$IS_SUMMARY_FILE" == "false" ]]; then
@@ -71,7 +71,7 @@ fi
 # ========================================
 
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-LOOP_BASE_DIR="$PROJECT_ROOT/.humanize-loop.local"
+LOOP_BASE_DIR="$PROJECT_ROOT/.humanize/rlcr"
 ACTIVE_LOOP_DIR=$(find_active_loop "$LOOP_BASE_DIR")
 
 if [[ -z "$ACTIVE_LOOP_DIR" ]]; then
@@ -94,7 +94,7 @@ fi
 # ========================================
 
 if [[ "$IS_PLAN_BACKUP" == "true" ]]; then
-    if [[ "$FILE_PATH" == *"/.humanize-loop.local/"* ]]; then
+    if [[ "$FILE_PATH" == *"/.humanize/rlcr/"* ]]; then
         FALLBACK="Writing to plan.md backup is not allowed during RLCR loop."
         REASON=$(load_and_render_safe "$TEMPLATE_DIR" "block/plan-backup-protected.md" "$FALLBACK")
         echo "$REASON" >&2
@@ -113,7 +113,7 @@ if is_goal_tracker_path "$FILE_PATH_LOWER" && [[ "$CURRENT_ROUND" -gt 0 ]]; then
 fi
 
 # ========================================
-# Block Summary Files Outside .humanize-loop.local
+# Block Summary Files Outside .humanize/rlcr
 # ========================================
 
 if [[ "$IS_SUMMARY_FILE" == "true" ]] && [[ "$IN_HUMANIZE_LOOP_DIR" == "false" ]]; then
@@ -130,9 +130,9 @@ fi
 # Extract Path Components (portable - works in bash and zsh)
 # ========================================
 
-CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize-loop\.local/[^/]*/\(.*\)$|\1|p')
+CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize/rlcr/[^/]*/\(.*\)$|\1|p')
 if [[ -z "$CLAUDE_FILENAME" ]]; then
-    CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize-loop\.local/\(.*\)$|\1|p')
+    CLAUDE_FILENAME=$(echo "$FILE_PATH" | sed -n 's|.*\.humanize/rlcr/\(.*\)$|\1|p')
 fi
 if [[ -z "$CLAUDE_FILENAME" ]]; then
     exit 0

prompt-template/block/git-not-clean-humanize-local.md

@@ -1,8 +1,8 @@
 
-**Special Case - .humanize-loop.local detected**:
-The `.humanize-loop.local/` directory is created by humanize:start-rlcr-loop and should NOT be committed.
+**Special Case - .humanize directory detected**:
+The `.humanize/` directory is created by humanize:start-rlcr-loop and should NOT be committed.
 Please add it to .gitignore:
 ```bash
-echo '.humanize*local*' >> .gitignore
+echo '.humanize*' >> .gitignore
 git add .gitignore
 ```

prompt-template/codex/full-alignment-review.md

@@ -60,16 +60,16 @@ Critical blockers: [list if any]
 
 To implement the original plan at @{{PLAN_FILE}}, we have completed **{{COMPLETED_ITERATIONS}} iterations** (Round 0 to Round {{CURRENT_ROUND}}).
 
-The project's `.humanize-loop.local/{{LOOP_TIMESTAMP}}/` directory contains the history of each round's iteration:
+The project's `.humanize/rlcr/{{LOOP_TIMESTAMP}}/` directory contains the history of each round's iteration:
 - Round input prompts: `round-N-prompt.md`
 - Round output summaries: `round-N-summary.md`
 - Round review prompts: `round-N-review-prompt.md`
 - Round review results: `round-N-review-result.md`
 
 **How to Access Historical Files**: Read the historical review results and summaries using file paths like:
-- `@.humanize-loop.local/{{LOOP_TIMESTAMP}}/round-{{PREV_ROUND}}-review-result.md` (previous round)
-- `@.humanize-loop.local/{{LOOP_TIMESTAMP}}/round-{{PREV_PREV_ROUND}}-review-result.md` (2 rounds ago)
-- `@.humanize-loop.local/{{LOOP_TIMESTAMP}}/round-{{PREV_ROUND}}-summary.md` (previous summary)
+- `@.humanize/rlcr/{{LOOP_TIMESTAMP}}/round-{{PREV_ROUND}}-review-result.md` (previous round)
+- `@.humanize/rlcr/{{LOOP_TIMESTAMP}}/round-{{PREV_PREV_ROUND}}-review-result.md` (2 rounds ago)
+- `@.humanize/rlcr/{{LOOP_TIMESTAMP}}/round-{{PREV_ROUND}}-summary.md` (previous summary)
 
 **Your Task**: Review the historical review results, especially the **last 5 rounds** of development progress and review outcomes, to determine if the development has stalled.
 

scripts/humanize.sh

@@ -3,17 +3,17 @@
 # Part of rc.d configuration
 # Compatible with both bash and zsh
 
-# Monitor the latest Codex run log from .humanize-loop.local
+# Monitor the latest Codex run log from .humanize/rlcr
 # Automatically switches to newer logs when they appear
 # Features a fixed status bar at the top showing session info
 _humanize_monitor_codex() {
-    local loop_dir=".humanize-loop.local"
+    local loop_dir=".humanize/rlcr"
     local current_file=""
     local current_session_dir=""
     local check_interval=2  # seconds between checking for new files
     local status_bar_height=10  # number of lines for status bar (goal tracker + git status)
 
-    # Check if .humanize-loop.local exists
+    # Check if .humanize/rlcr exists
     if [[ ! -d "$loop_dir" ]]; then
         echo "Error: $loop_dir directory not found in current directory"
         echo "Are you in a project with an active humanize loop?"
@@ -54,7 +54,7 @@ _humanize_monitor_codex() {
         local sanitized_project=$(echo "$project_root" | sed 's/[^a-zA-Z0-9._-]/-/g' | sed 's/--*/-/g')
         local project_cache_dir="$cache_base/$sanitized_project"
 
-        # First, find valid session timestamps from local .humanize-loop.local
+        # First, find valid session timestamps from local .humanize/rlcr
         for session_dir in "$loop_dir"/*; do
             # Skip if glob didn't match anything
             [[ ! -e "$session_dir" ]] && continue
@@ -532,7 +532,7 @@ humanize() {
                 *)
                     echo "Usage: humanize monitor rlcr-loop"
                     echo ""
-                    echo "Monitor the latest RLCR loop log from .humanize-loop.local"
+                    echo "Monitor the latest RLCR loop log from .humanize/rlcr"
                     echo "Features:"
                     echo "  - Fixed status bar showing session info, round progress, model config"
                     echo "  - Goal tracker summary: Ultimate Goal, AC progress, task status"