Когда вы работаете с Codex или Claude Code, у проекта заводится файл-памятка. У Codex это AGENTS.md, у Claude Code — CLAUDE.md. Файл вы создаёте сами (в обоих инструментах это делает команда /init) и записываете в него для агента самое важное: что за проект, какими инструментами пользуетесь, как тут принято делать. Перед работой агент читает эту памятку и опирается на неё.
Важный нюанс: каждый инструмент читает только свой файл. Codex смотрит в AGENTS.md, Claude Code — в CLAUDE.md, и ни один не подхватывает чужой автоматически. Работаете обоими — держите оба файла.
Здесь и прячется ловушка, в которую попадают почти все новички. Проект живёт и меняется: вы поставили новый инструмент, поменяли подход, свернули в другую сторону. А памятку поправить забыли. Агент по-прежнему честно читает старый текст и ориентируется на него. То есть уверенно делает не то — и не потому что глупый, а потому что вы дали ему устаревшую карту.
Лечится это одной привычкой. В конце работы отправьте агенту такой промпт:
«Проверь, что файл с инструкциями (AGENTS.md для Codex или CLAUDE.md для Claude Code) соответствует текущему состоянию проекта. Если за эту сессию поменялись инструменты, библиотеки, подход или направление — обнови его, чтобы он описывал проект как есть сейчас. Убери всё, что устарело. Пиши так, чтобы новый агент без всякого контекста понял, как тут всё устроено.»
Агент сам пройдётся по файлу и приведёт его в порядок. Относитесь к этой памятке как к главному источнику правды: пока в ней всё актуально, агент действует осмысленно. Как только она отстаёт от реальности, вы получаете красивые, уверенные и совершенно неправильные ответы.
Звучит скучно, а на деле экономит часы. Не придётся потом сидеть и гадать, почему агент упорно гнёт своё.
По теме
Если вы только начинаете работать с Codex или Claude Code и хотите выстроить вокруг агента порядок с самого начала, эти материалы будут кстати.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov
Если хотите разобрать свою задачу — напишите мне Если хотите разобрать свою задачу — напишите мне.
Можно прийти с идеей, черновым контекстом или уже живой задачей. Помогу быстро понять, где реальный следующий шаг, а где лишний шум.
Обычно хватает 2–3 сообщений, чтобы понять, могу ли я здесь реально помочь и в каком формате лучше двигаться дальше.