Bridge .claude/CLAUDE.md to AGENTS.md for Codex CLI

Codex CLI reads AGENTS.md for project instructions, not
.claude/CLAUDE.md.  When AGENTS.md is absent, copy from
.claude/CLAUDE.md (or root CLAUDE.md) and add it to
.git/info/exclude so the agent doesn't commit the copy.

Author: moodmosaic

lib/drivers/codex-cli.sh

@@ -60,6 +60,21 @@ agent_settings() {
 cli_auth_credentials_store = "file"
 TOML
 
+    # Codex reads AGENTS.md for project instructions, not
+    # .claude/CLAUDE.md.  Bridge the gap when AGENTS.md is absent.
+    if [ ! -f "${_workspace}/AGENTS.md" ]; then
+        local _src=""
+        [ -f "${_workspace}/.claude/CLAUDE.md" ] \
+            && _src="${_workspace}/.claude/CLAUDE.md"
+        [ -z "$_src" ] && [ -f "${_workspace}/CLAUDE.md" ] \
+            && _src="${_workspace}/CLAUDE.md"
+        if [ -n "$_src" ]; then
+            cp "$_src" "${_workspace}/AGENTS.md"
+            mkdir -p "${_workspace}/.git/info"
+            echo "AGENTS.md" >> "${_workspace}/.git/info/exclude"
+        fi
+    fi
+
     if [ -n "${OPENAI_API_KEY:-}" ]; then
         CODEX_HOME="$codex_home" \
             printenv OPENAI_API_KEY \

tests/test_drivers.sh

@@ -800,7 +800,7 @@ echo ""
 echo "=== 31. Codex driver — agent_settings ==="
 
 CWORK="$TMPDIR/codex-workspace"
-mkdir -p "$CWORK"
+mkdir -p "$CWORK/.git/info"
 _test_home="$TMPDIR/fakehome"
 mkdir -p "$_test_home"
 HOME="$_test_home" agent_settings "$CWORK"
@@ -812,6 +812,42 @@ assert_eq "codex config.toml created" "true" \
 assert_contains "codex config has file store" "file" \
     "$(cat "$_test_home/.codex/config.toml")"
 
+# 31b. AGENTS.md bridge: .claude/CLAUDE.md copied when no AGENTS.md.
+CWORK_B="$TMPDIR/codex-bridge"
+mkdir -p "$CWORK_B/.claude" "$CWORK_B/.git/info"
+echo "# Project rules" > "$CWORK_B/.claude/CLAUDE.md"
+HOME="$_test_home" agent_settings "$CWORK_B"
+assert_eq "AGENTS.md created from .claude/CLAUDE.md" "true" \
+    "$([ -f "$CWORK_B/AGENTS.md" ] && echo true || echo false)"
+assert_eq "AGENTS.md content matches" "# Project rules" \
+    "$(cat "$CWORK_B/AGENTS.md")"
+assert_contains "AGENTS.md in git exclude" "AGENTS.md" \
+    "$(cat "$CWORK_B/.git/info/exclude")"
+
+# 31c. AGENTS.md bridge: CLAUDE.md at root used as fallback.
+CWORK_C="$TMPDIR/codex-bridge-root"
+mkdir -p "$CWORK_C/.git/info"
+echo "# Root rules" > "$CWORK_C/CLAUDE.md"
+HOME="$_test_home" agent_settings "$CWORK_C"
+assert_eq "AGENTS.md from root CLAUDE.md" "# Root rules" \
+    "$(cat "$CWORK_C/AGENTS.md")"
+
+# 31d. AGENTS.md bridge: existing AGENTS.md not overwritten.
+CWORK_D="$TMPDIR/codex-bridge-existing"
+mkdir -p "$CWORK_D/.claude" "$CWORK_D/.git/info"
+echo "# Codex rules" > "$CWORK_D/AGENTS.md"
+echo "# Claude rules" > "$CWORK_D/.claude/CLAUDE.md"
+HOME="$_test_home" agent_settings "$CWORK_D"
+assert_eq "existing AGENTS.md preserved" "# Codex rules" \
+    "$(cat "$CWORK_D/AGENTS.md")"
+
+# 31e. AGENTS.md bridge: no CLAUDE.md at all, no AGENTS.md created.
+CWORK_E="$TMPDIR/codex-bridge-none"
+mkdir -p "$CWORK_E/.git/info"
+HOME="$_test_home" agent_settings "$CWORK_E"
+assert_eq "no AGENTS.md without CLAUDE.md" "false" \
+    "$([ -f "$CWORK_E/AGENTS.md" ] && echo true || echo false)"
+
 # ============================================================
 echo ""
 echo "=== 32. Codex driver — agent_extract_stats ==="