Что писать в CLAUDE.md, а что подключать к отдельной задаче
Claude Code при старте читает CLAUDE.md из репозитория. У Codex и многих других агентов есть такой же файл — AGENTS.md. Туда удобно складывать всё, что агент должен знать о проекте: как запустить тесты, где что лежит, какие правила кода.
Со временем файл растёт, и в нём появляются инструкции, которые нужны не в каждой задаче.
Пример: ревьюеры после разработки
Полезный приём для задач с кодом — независимые ревьюеры. После разработки агент запускает отдельных субагентов, которые не видели, как писался код. Они читают изменения и сверяют их с задачей и правилами проекта. Один проверяет, сделано ли то, что просили. Другой — стиль и лишний код. Найденное агент исправляет до того, как написать «готово».
Такая инструкция занимает полтора десятка строк. Если положить её в CLAUDE.md, агент будет получать её в каждой сессии: и в задаче про текст для лендинга, и в разборе логов, где ревьюить код нечего. Это лишний контекст, а иногда и лишняя работа.
Писать её руками в каждой задаче тоже неудобно. Её легко забыть, а при копировании из старой задачи легко взять устаревшую версию.
Инструкция для одного типа задач
В Tascue такая инструкция становится инклюдом — например, «Независимые ревьюеры». Его отмечают в задачах, где меняется код, и при копировании он встаёт в конец промпта. В задачах про тексты и исследования его просто нет.
Если инклюд появился, когда в бэклоге уже много задач, его можно добавить во все сразу: «Применить ко всем задачам в бэклоге». Задачи в работе и выполненные не изменятся.
Куда что класть
| Инструкция | Где держать |
|---|---|
| Нужна в любой задаче этого репозитория: как запустить тесты, как устроен проект | CLAUDE.md |
| Нужна в задачах одного типа: ревью кода, проверка в браузере, правила текстов | Инклюд проекта |
| Нужна во всех проектах: «не делай коммиты» | Общий инклюд, включённый в новые задачи по умолчанию |
| Нужна в одной задаче | Текст задачи |
Простая проверка для новой инструкции: она нужна в каждой задаче? Если нет, ей место в инклюде, а CLAUDE.md остаётся коротким и читается за минуту.
Промпт из задачи собирается сам: интро, поля, текст, инклюды. В Claude Code его можно вставить после «Скопировать» или отдать через MCP — агент получит ту же задачу целиком.