Что писать в CLAUDE.md, а что подключать к отдельной задаче

Claude Code при старте читает CLAUDE.md из репозитория. У Codex и многих других агентов есть такой же файл — AGENTS.md. Туда удобно складывать всё, что агент должен знать о проекте: как запустить тесты, где что лежит, какие правила кода.

Со временем файл растёт, и в нём появляются инструкции, которые нужны не в каждой задаче.

Пример: ревьюеры после разработки

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

Такая инструкция занимает полтора десятка строк. Если положить её в CLAUDE.md, агент будет получать её в каждой сессии: и в задаче про текст для лендинга, и в разборе логов, где ревьюить код нечего. Это лишний контекст, а иногда и лишняя работа.

Писать её руками в каждой задаче тоже неудобно. Её легко забыть, а при копировании из старой задачи легко взять устаревшую версию.

Инструкция для одного типа задач

В Tascue такая инструкция становится инклюдом — например, «Независимые ревьюеры». Его отмечают в задачах, где меняется код, и при копировании он встаёт в конец промпта. В задачах про тексты и исследования его просто нет.

Если инклюд появился, когда в бэклоге уже много задач, его можно добавить во все сразу: «Применить ко всем задачам в бэклоге». Задачи в работе и выполненные не изменятся.

Куда что класть

Инструкция Где держать
Нужна в любой задаче этого репозитория: как запустить тесты, как устроен проект CLAUDE.md
Нужна в задачах одного типа: ревью кода, проверка в браузере, правила текстов Инклюд проекта
Нужна во всех проектах: «не делай коммиты» Общий инклюд, включённый в новые задачи по умолчанию
Нужна в одной задаче Текст задачи

Простая проверка для новой инструкции: она нужна в каждой задаче? Если нет, ей место в инклюде, а CLAUDE.md остаётся коротким и читается за минуту.

Промпт из задачи собирается сам: интро, поля, текст, инклюды. В Claude Code его можно вставить после «Скопировать» или отдать через MCP — агент получит ту же задачу целиком.

Следите за Tascue в LinkedIn