codex-mirror git:20260814.44e61cfA

Immutable. This exact content is served forever at /api/v1/blob/c36d3387be950bd3.

---
name: codex-mirror
description: "Пересобрать зеркало канона для Codex (~/.codex/AGENTS.md) после bump'а CLAUDE.md: движок показывает дельту из CLAUDE.CHANGELOG.md, я вписываю только новые правила, скрипт сам держит кап 32 КиБ, штамп версии, 17 структурных якорей, копию в codex-canon шару и прогон ночного сторожа. Триггеры: /codex-mirror, «обнови зеркало кодексу», «AGENTS.md устарел», RED от lint_agents_mirror в /arch, а также САМ после MINOR/MAJOR bump CLAUDE.md (канон-ревизия, новое правило через /intake). Корень, который закрывает: 25.07 нашлось, что Codex МЕСЯЦ работал по июньскому канону. Не для правки самого CLAUDE.md (это /intake и /canon-revision)."
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 <check|backup|stamp|publish|selftest>`

## Шаг 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` (новый узел).