--- name: codex-mirror description: > Rebuild the canon mirror for Codex (~/.codex/AGENTS.md) after a CLAUDE.md version bump: the engine shows the delta from the changelog, the operator writes in only the new rules, and the script enforces the size cap, version stamp, structural anchors, a copy into the shared folder, and the nightly-linter run. Trigger on "/codex-mirror", "update the codex mirror", "AGENTS.md is stale", or a RED flag from the mirror linter. license: MIT --- # codex-mirror — зеркало общего канона для Codex Боль (найдена 25.07.2026): CLAUDE.md пережил ревизию v2 22.07, а `~/.codex/AGENTS.md` тихо остался июньским — **Codex месяц работал по устаревшим правилам**, и сверщик того времени ослеп на той же ревизии. Лечение: зеркало **версионное** (сравниваем версии, не форму), сторож кричит ночью, а этот скилл — дешёвая кнопка «пересобрать», чтобы крик не превращался в вечернюю ручную работу. Роли (АК-47): **скрипт** двигает байты и всё проверяет; **я** пишу только текст новых правил. Руками не перепечатывать файл и не считать байты на глаз. Движок: `python %USERPROFILE%\.claude\scripts\codex_mirror.py ` ## Шаг 0 — RECALL + рамки - Память: [[canon-versioning-and-drift-watchdog]] (класс «сторож умер молча вместе с объектом»), [[codex-cli-install]], [[any-llm-vault-actor]], [[claude-md-compression-contract]]. - Зеркало = **канон-правка** → только машина Антона в живой сессии; ведомые receive-only ([[machine-governance-leader-follower]]). - Кап 32 КиБ жёсткий (DR 29.06: «lost in the middle» — раздутый файл ХУЖЕ пустого). Зеркало = выжимка + указатели, НЕ копия CLAUDE.md. ## Шаг 1 — Что именно устарело ``` python %USERPROFILE%\.claude\scripts\codex_mirror.py check ``` Печатает версии обеих сторон, остаток до капа и **дельту из `CLAUDE.CHANGELOG.md`** — ровно те записи, что появились после версии зеркала. Это и есть список работы; читать целиком CLAUDE.md не нужно. - `VERDICT: OK` → выходим, делать нечего. - `PATCH lag only` → зелёно по дизайну; вписываем, только если микро-правка меняет ПОВЕДЕНИЕ (пороги, гейты), а не формулировку. - `REBUILD` → идём дальше. ## Шаг 2 — Страховка ``` python %USERPROFILE%\.claude\scripts\codex_mirror.py backup ``` Снапшот в `~/.codex/_backup/AGENTS.md.pre-<версия>-<дата-время>`. Откат = скопировать обратно. ## Шаг 3 — Вписать дельту (единственный шаг, где думаю я) Для каждой записи дельты: 1. Найти в зеркале **соответствующий §** (нумерация зеркала = нумерация CLAUDE.md, поэтому §8.4 канона живёт в §8.4 зеркала). 2. Вписать правило в стиле зеркала: жирный `**§X.Y ...**` + суть в 1-3 предложения + указатель на канон в волте. Тела не копировать. 3. Правило про людей/внешку (Библия) — одной строкой с указателем; правило про harness Claude (скиллы/хуки) — переводить в **принцип**, у Codex этих механизмов нет. 4. Если правило целиком про меня-Codex (роль ревьюера, грабли Windows, защищённые зоны) — его дом **CODEX-БЛОК C1-C6**, не §-часть. ⚠️ **Запас до капа мизерный** (на 26.07 — 37 байт). Новое влезает только в обмен: ужать самый раздутый абзац ТОЙ ЖЕ §-секции, не резать ТОП-20 и не выкидывать целые правила. Не влезает даже так → это сигнал на полную ревизию зеркала (как 25.07: 137 КБ → 32.7 КБ), а не на «чуть-чуть за кап». ## Шаг 4 — Штамп + публикация ``` python %USERPROFILE%\.claude\scripts\codex_mirror.py stamp python %USERPROFILE%\.claude\scripts\codex_mirror.py publish ``` `stamp` переписывает строку `> MIRRORS: ...` из ЖИВОГО канона (версия, дата, md5, хост) — руками её не трогать. `publish` — гейты (кап · штамп vs канон · 17 якорей `## §0..§10` + `### C1..C6`), потом копия в `$IMPORTS_ROOT\codex-canon\`, md5-сверка и прогон `lint_agents_mirror.py`. Любой FAIL = ничего не скопировано, чиним и повторяем. ## Шаг 5 — Доказательство и дома - Живой прогон Codex: `codex exec -s read-only --skip-git-repo-check "процитируй §<новый номер> из своих инструкций"` — читает ли он новое правило на самом деле. - Сторонние глаза по правилу /tt: `secondop.py t3 --ritual tt` (Codex сам как ломатель) — если менялся движок, а не только текст зеркала. - Узел с Codex, но не хаб: там же прогнать `lint_agents_mirror.py` локально (строка в `codex-onboard-checklist.md`). - Правило поменяло КОНТРАКТ коллаборации (что Codex может/не может) → обновить `~/.codex/CODEX-COLLABORATION.md` + копию в шаре, а не только зеркало. ## Границы и принятые ограничения - ⛔ Не менять этим скиллом CLAUDE.md (это `/intake` для правила и `/canon-revision` для структуры); зеркало едет ЗА каноном, никогда впереди. - ⛔ Не запускать на чужих машинах: канон пересобирает только хаб Антона. - **Принято:** правка тела зеркала БЕЗ смены штампа сторожем не ловится (governance receive-only держит эту дыру закрытой организационно). Второго сторожа не строим — [[gate-implement-critical-only]]. - Кап и якоря — истина в коде движка (`CAP`, `ANCHORS`); расхождение кода с этим текстом = баг кода. - Родня: `/arch` (ночная рельса, где живёт сторож) · `/secondop` (Codex как ревьюер) · `/canon-revision` (ревизия самого канона) · `/follower-onboard` (новый узел). --- ## About & contact Built and battle-tested at **Palo Alto AI Research Lab** — a fleet of Claude Code machines running 24/7 as a second brain and synthetic cofounder. Every skill here survived real production use before publication. - 📦 All 101 skills: https://github.com/tonydzi/second-brain-starter-kit - 👤 Author: **Anton Dziatkovskii** — Telegram [@tonydzi](https://t.me/tonydzi) · WhatsApp [+1 341 222 9178](https://wa.me/13412229178) · X [@Tony_Stef_](https://x.com/Tony_Stef_) - 🧪 **Engineers: want to test-drive this setup?** Message me — I hand out free starter seeds to engineers who test and report back. Custom skill requests welcome.