Автоматически улучшаем CLAUDE.md по журналам сессий ИИ-агента

Один из самых действенных способов улучшить работу агентных инструментов вроде Claude Code/Cowork и Codex — использовать файлы CLAUDE.md или AGENTS.md^[1], которые дают агенту контекст проекта.

Я заметил: в новых проектах за ними поначалу легко следить, но по мере роста сложности их обновление быстро превращается в кошмар, а делать это вручную — довольно утомительно.

Недавно я нашёл простой трюк: использовать логи агента, чтобы выявлять типичные проблемы с файлом CLAUDE.md. В Claude Code такие сессии хранятся в ~/.claude/projects, в Codex — в ~/.codex/sessions. Эти логи агента — файлы JSONL, в которых записано всё, что происходило в сессии, включая то, что вы просили агента сделать, и то, что он сделал. Учтите: хотя оба используют формат JSONL, схемы у них совершенно разные.

Сам «трюк» в том, чтобы заставить агента просмотреть ваши существующие логи чатов и сверить их с текущим CLAUDE.md, чтобы найти возможные точки оптимизации. По моему опыту, это работает до смешного хорошо и превращает обновление CLAUDE.md из рутины в задачу на 30 секунд для каждого проекта.

Хорошо работает такой промпт: «Просмотри мои JSONL-файлы истории Claude для этого проекта и проанализируй, как можно улучшить текущий файл claude.md. Отметь случаи, когда я раздражаюсь, и повторяющиеся вопросы между сессиями».

Одна проблема всё же была: агенту немного трудно эффективно разбирать JSONL — он пишет jq- и bash-команды сверхчеловеческой сложности.

Поэтому я сделал небольшой CLI, который абстрагирует поиск, — я выложил его в открытый доступ на GitHub с готовыми бинарниками для Mac и Linux, но, подозреваю, одного этого скриншота хватит, чтобы ваш агент собрал такой же инструмент точно под вас (!):

Вывод справки CLI claude-log с командами для разбора и анализа чат-логов Claude Code

С ним агент ищет по логам крайне эффективно. Без него на предложения по проектам даже с умеренным количеством чат-сессий уходило несколько минут, с ним — несколько секунд. По сути, ничто не мешает запускать это как плановую задачу каждый день или каждую неделю, чтобы инструмент просто улучшал себя сам. Я заметил, что быстрый отбор предложений помогает, но уверен: с более детальным промптом он мог бы лучше самоулучшаться.

Надеюсь, это пригодится. У меня есть ещё кое-какие мысли о том, как управлять этим в масштабе организации или предприятия, но пока — пользуйтесь куда более удобным файлом CLAUDE.md.

Мне очень хотелось бы, чтобы Anthropic приняла AGENTS.md — хотя бы для того, чтобы мои тексты звучали менее коряво. ↩︎