system-rebuild · ревизия документации

Правила системы живые. Справочники о системе — врут.

Прочитал изнутри все 7 файлов, на которых система держится, и сверил каждое утверждение с тем, что реально лежит на диске: скиллы, агенты, модули, хуки, папки, память.

14 августа 2026 · источник: живой обход ~/ai-system + ~/.claude · проверено файловой системой, не по памяти
Что подтверждено
1:1

Ядро правил не дрейфует ни на строку

CLAUDE.md и хук hard-rules.py, который вшивается в каждый твой промпт в любой папке, совпадают дословно: 5 красных линий + 4 базовых правила. Ни одного противоречия — то есть то, что ты читаешь в ядре, и есть то, что реально видит агент на старте. Это самая важная связка в системе, и она здорова.

Красных линий: 5
Базовых правил: 4
Хуков подключено: 13
Ядро: одна страница, без импортов
Но · переворот
26

Расхождений между «что написано» и «что есть»

Все — в обвязке вокруг ядра: README.md, SKILLS.md, MODULES.md, AGENTS.md. Они описывают систему, которой больше нет: отправляют к 4 агентам и 9 скиллам, удалённым ещё в июле, называют выключенный плагин основным фреймворком и ссылаются на файлы, которых нет на диске. 12 расхождений я закрыл прямо сейчас, 14 — не документные, требуют твоего решения.

По файлу: возраст, расхождения, что сделал

ФайлНе трогалиВралСтатус
README.md80 дн.9перезаписал
.claude/SKILLS.md79 дн.4починил 2
.claude/MODULES.md79 дн.3починил 3
.claude/AGENTS.md15 дн.3починил 3
ARCHITECTURE.md38 дн.3починил 2
CLAUDE.md38 дн.1починил 1
MEMORY.md (авто-память)1починил 1
вне доков (хуки, проекты, скиллы)2твоё решение

Самое гнилое — README.md: последняя правка 26 мая. Он до сих пор представляет систему как «6 субагентов и 20 скиллов с superpowers как основным фреймворком». Реальность: 16 агентов, 30 локальных скиллов + 19 глобальных, superpowers выключен с 16 июля.

26 расхождений: что уже закрыто, что нет

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

12 починил в этой сессии — чисто текст в доках, откат одной командой git checkout  ·  14 открытых: это уже не текст, а решения про файлы и структуру — трогать без твоего «да» не буду.

Что починил прямо сейчас

Только правки текста в семи md — ничего не удалял, не двигал, не запускал. Все файлы были чистыми в git, так что откат в одну команду.

14 открытых — нужен твой ответ

Ответь по каждому пункту одним сообщением — доделаю пачкой без дальнейших вопросов.

Корневая причина, а не 26 симптомов

Все расхождения одного сорта: дока держит список того, что и так лежит на диске. Список скиллов, список агентов, список проектов, список модулей. Любой такой список гниёт в момент, когда что-то архивируется, — и гниёт молча, потому что никто не сверяет. Поэтому я не «обновил списки», а вынес их из док: там, где раньше был перечень, теперь команда ls и правило. Живой список должен быть в одном месте — на диске, а для проектов в orchestrator-memory.md. Это и есть твоё правило вычитания, применённое к самой документации.

Честные оговорки

Читал 7 ядровых файлов и делал инвентаризацию структуры. Всего в репозитории 3060 md — per-project CLAUDE.md, STATUS.md и knowledge/ я не проверял, там расхождения тоже почти наверняка есть, это отдельный заход по проектам.

Телеметрию (cockpit.db) не открывал — значит реальную частоту вызова каждого скилла не мерил. Мои 5 «толстых» скиллов — по объёму текста, а не по бесполезности. Кто из 49 скиллов реально мёртв, скажет только база, и это следующий шаг, если дашь добро.

Про 14 открытых пунктов: цифра «нарушено правило» — не то же самое, что «вредит». Часть, вроде картинок в корне, косметика. Приоритет расставил бы так: битая активация модуля и 17 проектов без .meta.json ломают кокпит на самом деле, остальное — про порядок.

Источник: живой обход файловой системы ~/ai-system и ~/.claude, 14.08.2026 · правки в md сделаны и не закоммичены — смотри git diff, откат git checkout <файл>