На этой неделе у меня случился честный стресс-тест агентской архитектуры. Заблокировали аккаунт Anthropic, вместе с ним отвалился привычный Claude Code. Утро, рабочие задачи, миграция DWH, витрины, дашборды, документация, треды. Хороший момент, чтобы пересмотреть жизненные решения.
Я открыл Codex и продолжил работать. Другой агент не знает мой стек, структуру репозитория, рабочие запреты, маршруты к DWH, правила PR и почему в расчетах нельзя верить памяти без проверки источника. Всё это ему нужно дать через файлы проекта.
У меня это давно собрано в каскад.
▫️ AGENTS.md
Главный контракт проекта. Кто я, как со мной работать, где лежат скиллы, что можно делать автономно, что требует подтверждения.
Раньше в моём гайде эта роль была завязана на
CLAUDE.md, потому что я писал его под Claude Code. После переезда я вынес рамку в AGENTS.md: агент может быть другим, но входной контракт проекта остаётся тем же.▫️ SKILL.md
Повторяемые процессы: PR в DWH, сверка витрин через QueryPad, документация в Confluence, Core Layer, миграция на Trino, Redash/ECharts-виджеты.
Когда я прошу подготовить PR, агент не «вспоминает по памяти» из истории чата. Он читает скилл: узкий scope, diff против master, порядок
dwh test, что нельзя трогать бонусом и как разбирать фейлы.▫️ MEMORY.md
Индекс того, что важно между сессиями: статусы проектов, решения, обратная связь, ссылки на источники. Память не заменяет проверку. Она показывает, куда смотреть.
Из-за этого переезд получился скучным, а это лучший комплимент инфраструктуре. Я не переносил «личность агента». Я дал Codex ту же карту проекта.
Пришлось поправить несколько вещей:
▪️ сделать
AGENTS.md мостом к старой Claude-структуре;▪️ потратить 30 минут, чтобы Codex прочитал проект, memory-индексы и рабочие skill-и;
▪️ проверить, что маршруты к DWH, Redash, Confluence и Stash описаны в правильных слоях.
После этого Codex снова делает рабочие вещи: разбирает SQL в DWH-репозитории, готовит PR без лишних файлов, сверяет Vertica и Trino через QueryPad, правит документацию в Confluence, читает контекст Core Layer и миграции, собирает ECharts-виджет по стайлгайду. Обычный рабочий контур, только раннер поменялся.
Ради этого я и затевал каскад.
Если контекст живёт в голове автора или в истории чата, смена агента превращается в миграцию платформы. Снова объясняешь стиль, ограничения, технические маршруты, правила безопасности. На третьем повторе уже работаешь секретарём у собственного инструмента.
Если контекст живёт в файлах проекта, агент становится заменяемым раннером. Один отвалился - подставляете другой. Часть команд и MCP-интеграций придётся адаптировать, но ядро остаётся на месте: правила, навыки, память, структура.
Важно не переобещать. Каскад не делает агента безошибочным. Он будет путаться, галлюцинировать, цеплять не тот файл и криво трактовать правило. Разница в том, что ошибки становятся реже и чинятся понятнее: смотришь, какой слой контекста не сработал, и правишь конкретный файл.
Для меня эта блокировка закрыла старый долг: отвязать «Каскадизация решает» от конкретного инструмента. Теперь это гайд про проектного AI-агента. Codex, Claude Code, Cursor Agent, Cline, корпоративная оболочка - вторично, если инструмент читает проект, работает с файлами и запускает команды.
Главные вопросы остаются теми же:
▫️ где лежит стабильный контракт;
▫️ как агент понимает, какой скилл нужен;
▫️ что уходит в память, а что проверяется в источнике;
▫️ какие действия нельзя делать без подтверждения;
▫️ как не сжечь контекст и бюджет на простыне из всего подряд.
Я обновил PDF-гайд под эту рамку и залил новую версию в @pbdl_tg_bot. 10 самым активным промо PBDL20 на скидку 20%. Старые формулировки про Claude Code убрал, основной контракт теперь
AGENTS.md / SKILL.md / MEMORY.md.🚀 Если вы уже работаете с AI-агентом в коде, DWH или аналитических проектах, смотрите не только на модель. Смотрите на то, сколько вашего рабочего контекста переживёт внезапную смену инструмента. Мой пережил. За это каскад и ценю.