Памятка · внутренний документ

Как устроена AI-система

Карта на одну страницу: что где лежит, что срабатывает само, куда смотреть, когда что-то пошло не так.

7 сентября 2026 · источник — живой репозиторий ~/ai-system и ~/.claude · собрано по факту, не по документации

9 КБ

Столько весит единственный файл, который агент читает при каждом запуске — ядро CLAUDE.md. На диске при этом лежит 34 ГБ.

Главный принцип системы: в голове постоянно — одна страница. Всё остальное приезжает по требованию, когда тема реально всплыла.

429 коммитов с 3 мая 2026 13 634 файла 68 проектов 341 публикация

1Пять слоёв, от жёсткого к мягкому

Система — не одна куча правил, а лестница. Чем выше слой, тем реже он меняется и тем строже действует. Нижние слои подтягиваются только когда нужны.

СТОП
Запреты — ~/.claude/NEVER.md + хук hard-rules.py
Только то, нарушение чего = потеря денег, утечка или ярость. Проверяется на каждом промпте, в любой папке, ещё до того как я начал думать. Потолок 20 пунктов, собирается скриптом, руками не правится.
ЯДРО
Правила поведения — CLAUDE.md, одна страница
Кто ты, красные линии, как я работаю, как устроена память и проекты. Без импортов и вложенных файлов: закон вычитания — добавил строку, назови что удалил.
ПАМЯТЬ
Опыт — 34 файла авто-памяти + orchestrator-memory.md
Профиль, поведенческие правила, технические справочники. Плюс операционная память: карточки активных проектов и очередь — она грузится в каждый старт сессии.
ИНСТР
Инструменты — 50 скиллов, 17 агентов, 20 интеграций
Скилл = короткая процедура «как правильно сделать X». Агент = отдельная голова с большим контекстом под узкую зону. Интеграция = мост во внешний сервис.
ДЕЛО
Работа — projects/, sandbox/, _archive/
Активное, дозревающее и мёртвое разложены по трём папкам. В projects/ — только то, что реально движется.
Зачем такая лестница

Модель надёжно держит примерно 150 инструкций за раз. Поэтому вопрос не «сколько мы помним», а «что видно в момент решения». Запреты видны всегда, справочники — только когда тема всплыла.

2Что происходит с одним твоим сообщением

От «привет, сделай X» до ссылки в чате запрос проходит через семь точек. Пять из них — автоматика, которая работает без моего участия.

3Память: три уровня, а не одна куча

Раньше память была свалкой, и из неё терялось именно важное — запреты. Теперь у каждого уровня свой режим загрузки.

УровеньГде живётЧто внутриКогда читаетсяОбъём
0 · Запреты~/.claude/NEVER.mdДословные красные линииКаждый промптдо 20
1 · Правилаmemory/rules-*.mdКак я обязан работатьПо теме34 файла
2 · Справочникиmemory/ref-*.mdИнфраструктура, стеки, доступыПо именипо требованию
Оперативкаorchestrator-memory.mdПроекты карточками + очередьКаждый старт12 КБ
Опыт проектаprojects/<X>/knowledge/Решения и грабли проектаВнутри проекта
Правило, которое чинит главную поломку памяти

Строка в индексе обязана содержать сам запрет, а не тему файла: «нельзя X» вместо «про X». Резюме теряет именно запреты — так уже были потеряны два правила, которые потом нарушились.

Что в память не попадает

Разовые замечания, структура кода, история git, копии артефактов. Фидбек сохраняется, только если меняет постоянное правило. Артефакты — указателем на реестр публикаций, не копией.

4Инструменты: скиллы, агенты, модули, мосты

50
скиллов
30 проектных + 20 глобальных
17
агентов — отдельные головы под узкие зоны
20
интеграций с внешними сервисами
15
веб-скиллов в библиотеке — вручную
Скилл — короткая процедура
«Как правильно сделать X»: публикация на домен, отчёт по канону, озвучка твоим голосом, обход антибота, паспорт проекта, разбор чужой анимации. Срабатывает сам по триггерным фразам в описании.
Агент — отдельная голова
Берёт задачу целиком и возвращает результат, не засоряя мой контекст: ресёрчер, режиссёры каналов, продюсер генераций, ревьюеры дизайна и текстов, архитектор системы, публикатор.
Модуль — переносимый пайплайн
Кусок конвейера, который подключается к проекту через его паспорт. Сейчас их всего 4 — намеренно: модуль заводится, только когда паттерн повторился.
Интеграция — мост наружу
Генерация картинок и видео, озвучка, антибот-браузер, монтаж, тренд-движок, календарь, задачи, мост на твой мак. Ключи — в защищённом хранилище, не в коде.

Что реально используется (последние 30 дней)

публикация 126× HTML-отчёт 45× брейншторм 37× чтение телеги 29× антибот 28× мак 26×

Из 50 скиллов рабочую нагрузку тянут 6-8. Остальные — редкие, но дорогие в момент, когда нужны: регистрация аккаунта, клон голоса, разбор анимации.

5Проекты: конверт вместо шаблона

Каждый проект — папка. Обязательны только два элемента, остальное заводится, когда реально понадобилось — пустые папки из шаблона запрещены.

projects/<name>/
├── .meta.json     ← паспорт: тип, статус, приоритет, модули
├── STATUS.md      ← живой статус (обязателен)
├── artifacts/     ← опубликованное + реестр (обязателен)
├── CLAUDE.md      ← правила этого проекта (по необходимости)
├── knowledge/     ← накопленный опыт (по необходимости)
└── comms/         ← отчёты агентов, привязка чатов
20
внутренних — сама система и конвейеры
15
личных — каналы, трейдинг, инструменты
7
клиентских
4
партнёрских

36 проектов в статусе active, 9 на паузе. Плюс 24 наработки в песочнице — они ещё не проекты, дозреют и переедут.

Три папки — три состояния

projects/ — только то, что движется. sandbox/ — замёрзшее и экспериментальное. _archive/ — мёртвое, лежит для истории и не трогается. Проект перестал двигаться — уезжает вниз, а не висит в активных.

6Что срабатывает само, без команды

Автоматика живёт в двух местах. Одна работает в любой папке на машине, вторая — только внутри системы.

МоментЧто срабатываетЗачем
Каждый промптПроверка красных линийЗапреты попадают в контекст раньше задачи
Каждый промптЛог + детектор паттерновЛовит, что ты просишь по 3-й раз — кандидат в автоматику
Старт сессииЗагрузка оперативной памятиПроекты, очередь, инбокс, состояние git
Перед инструментомПодтверждение с телефонаНезнакомая команда ждёт твоего тапа в Telegram
Перед записью в памятьПроверка на дубльНе плодить второй файл про то же самое
Конец ответаКонтроль доставкиНе отдать результат текстом там, где нужна страница
Конец сессииТелеметрия кокпитаЧто делали, сколько, чем — в базу дашборда
Почему это важнее, чем кажется

Хук — единственный способ сделать правило обязательным. Инструкция в файле может потеряться в длинном контексте, хук — нет: он исполняется машиной, а не мной.

7Твои команды

Короткие слова, за которыми стоит целая процедура. Их не надо помнить дословно — они ловятся по смыслу.

СкажешьЧто произойдёт
«сохрани»Обновляются статусы тронутых проектов → всё уезжает в git → ты получаешь готовое стартовое сообщение для следующей сессии
«итоги недели»Разбор недели с инверсией на вычитание: не «что добавить», а что убрать
«продолжи проект X»Заход в проект + паспорт на человеческом языке: за 3 минуты возвращает в контекст после перерыва
«зафиксируй мысль»Идея улетает в правильное место сама — без вопросов «куда положить»
«опубликуй»Страница уезжает на поддомен, регистрируется в реестре, в чат — одна ссылка
«стоп»Прерывание = стоп. Не «доделаю и покажу»

8Доставка результата

Правило одно: то, что ты смотришь — это страница по ссылке. То, что ты редактируешь — это файл по пути. Ответ на вопрос — просто ответ, без артефакта.

Страница на домене
Отчёт, план, дашборд, КП, спека, инвентаризация, результат прогона. Один поддомен на проект, артефакты — папками внутри. Всё пишется в реестр публикаций: 341 запись по 44 проектам.
Так больше не отдаётся
Markdown-файл «посмотри сам», стена текста в чат, «вот 5 вариантов, выбери», статус-нарратив вместо видимого результата. И промежуточные отчёты о фазах — тоже нет.
Личное — не на публичный URL

Профиль, память системы, финансы, пароли, доступы, переписка — только файлом или текстом в чат. Поддомены открыты интернету. Сомнение «это личное?» решается в пользу «не публикуем». Эта страница написана по этому правилу: в ней устройство системы, но ни одного ключа, адреса или имени клиента.

9Если что-то пошло не так

Навигация по симптому — куда смотреть в первую очередь.

СимптомГде причина
Агент забыл правило, которое ты давалПравило не в памяти или в индексе записано темой, а не запретом
Сделал не то, что просилВопрос приняли за задачу, либо подменили запрос своей повесткой
Собрал самопал вместо готового решенияБыл буквальный способ — надо было взять его дословно
Не помнит, на чём остановилисьНе было «сохрани» — статус проекта не обновился
Долбит одно и то же второй часНарушен лимит: 2 попытки одним способом, дальше меняем угол
Потерялась опубликованная ссылкаРеестр публикаций проекта — там все URL с датами

10Честные оговорки: где система провисает сейчас

Памятка без этой секции была бы рекламой. Вот что не сходится на 7 сентября.

Закон, который держит всё это в форме

Система растёт только через вычитание. Добавляешь правило, файл, скилл — обязан назвать, что убираешь взамен. Новый скилл или агент заводится, только если паттерн повторился 3 раза. Переусложнение — болезнь, простота важнее полноты.

Собрано по живому состоянию репозитория ~/ai-system · 7 сентября 2026
Внутренний документ. Индексация закрыта.