Що писати в CLAUDE.md, а що підключати до окремої задачі
Claude Code під час старту читає CLAUDE.md з репозиторію. У Codex і багатьох інших агентів є такий самий файл - AGENTS.md. Туди зручно складати все, що агент має знати про проєкт: як запустити тести, що де лежить, які правила коду.
З часом файл росте, і в ньому з’являються інструкції, які потрібні не в кожній задачі.
Приклад: рецензенти після розробки
Корисний прийом для задач із кодом - незалежні рецензенти. Після розробки агент запускає окремих субагентів, які не бачили, як писався код. Вони читають зміни й звіряють їх із задачею та правилами проєкту. Один перевіряє, чи зроблено те, що просили. Інший - стиль і зайвий код. Знайдене агент виправляє до того, як написати «готово».
Така інструкція займає півтора десятка рядків. Якщо покласти її в CLAUDE.md, агент отримуватиме її в кожній сесії: і в задачі про текст для лендингу, і в розборі логів, де рецензувати нічого. Це зайвий контекст, а іноді й зайва робота.
Писати її вручну в кожній задачі теж незручно. Її легко забути, а під час копіювання зі старої задачі легко взяти застарілу версію.
Інструкція для одного типу задач
У Tascue така інструкція стає інклюдом - наприклад, «Незалежні рецензенти». Його позначають у задачах, де змінюється код, і під час копіювання він стає в кінець промпту. У задачах про тексти й дослідження його просто немає.
Якщо інклюд з’явився, коли в беклозі вже багато задач, його можна додати в усі одразу: «Застосувати до всіх завдань у беклозі». Задачі в роботі та виконані не зміняться.
Що куди класти
| Інструкція | Де тримати |
|---|---|
| Потрібна в будь-якій задачі цього репозиторію: як запустити тести, як влаштований проєкт | CLAUDE.md |
| Потрібна в задачах одного типу: рев’ю коду, перевірка в браузері, правила текстів | Інклюд проєкту |
| Потрібна в усіх проєктах: «не роби коміти» | Спільний інклюд, увімкнений у нових задачах за замовчуванням |
| Потрібна в одній задачі | Текст задачі |
Проста перевірка для нової інструкції: чи потрібна вона в кожній задачі? Якщо ні, їй місце в інклюді, а CLAUDE.md лишається коротким і читається за хвилину.
Промпт із задачі збирається сам: інтро, поля, текст, інклюди. У Claude Code його можна вставити після «Скопіювати» або віддати через MCP - агент отримає ту саму задачу повністю.