🗂 Четыре поста серии закончились одинаково: где-то появлялось правило. «Пиши только в эту папку». «Сначала прочитай память, потом отвечай». Сегодня — про файл, в котором эти правила живут.
📌 Начну с того, что все знают, но мало кто закладывает в работу — нейросеть не помнит вчерашнюю сессию, не сохраняет контекст между сессиями. Каждый запуск — новый сотрудник: быстрый, дотошный и без малейшего представления о том, как у нас принято и где что лежит.
👋 В компании такого человека ведёт сосед по столу: «спроси у Коли, он в курсе». Коли у агента нет. Есть файл, который любой агент читает на старте каждой сессии. Для Claude это CLAUDE.md, Codex ищет AGENTS.md. Этот файл я называю манифестом.
🧩 Небольшой лайфхак — если делаете своё пространство независимым от того, какой агент работает, то можно манифест писать в AGENTS.md, а рядом положить файл CLAUDE.md, в котором одна строка: «Прочитай AGENTS.md». Так любой агент получит одинаковые инструкции на старте.
🚦 Корневой манифест начинается с протокола старта сессии. У меня он озаглавлен «обязательно, без исключений» и состоит из пяти шагов:
- определить среду и базовый путь
- прочитать указатель памяти
- понять, какой домен затронут
- прочитать манифест этого домена
- и только теперь действовать
🗺 Следующее по важности — маршрутизация. Корневой манифест не устанавливает правила внутри доменов. Это стрелка: контент — туда, память — туда, клиентские проекты — туда.
📁 Сами правила лежат в доменных манифестах, рядом с данными. «Работаем в контенте» — агент подтягивает манифест контент-завода: где голос канала, кто имеет право писать в календарь, что нельзя публиковать без моей команды. Правила других проектов в этот момент не открываются — не нужны и только съедят контекстное окно.
⚠️ А теперь то, чего нет в гайдах. Манифест не пишется заранее. Почти каждая строка в нём — след промаха.
🩹 Лучше всего это видно в разделе Known issues. Там просто перечислены грабли: симлинк может быть не поднят, диск монтируется не туда, где его ждёшь, у локальной модели контекст по умолчанию мал. Ничего из этого не проектировалось. Всё дописано после того, как на каждой строке уже потеряли по полчаса.
💡 Инструкция, написанная до работы, — это гипотеза. Рабочей она становится, когда её дописывают после каждого сбоя.
🧭 Если строить своё — писать всё сразу не нужно. Пяти блоков достаточно, чтобы агент перестал быть слепым: кто вы и чем занимаетесь · принципы, которые действуют везде · карта доменов · протокол старта сессии · таблица маршрутизации. Остальное дописывается по ходу, само.
- кто вы и чем занимаетесь
- принципы, которые действуют везде
- карта доменов
- протокол старта сессии
- таблица маршрутизации
🎯 Тот тикет из прошлого поста — про задублированную секцию — до сих пор открыт: файл, который агент читает первым, между делом не правят.
На этом серия про цифровой слой закрывается. Но всё, что я показывал — память, dev hub, манифесты, — существует ради работы. Самый обкатанный пример такой работы у меня — контент-завод: конвейер, через который я провёл и этот пост, от идеи до вашей ленты. Разбирать?
Дискуссия