Що писати в CLAUDE.md, а що підключати до окремої задачі

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

З часом файл росте, і в ньому з’являються інструкції, які потрібні не в кожній задачі.

Приклад: рецензенти після розробки

Корисний прийом для задач із кодом - незалежні рецензенти. Після розробки агент запускає окремих субагентів, які не бачили, як писався код. Вони читають зміни й звіряють їх із задачею та правилами проєкту. Один перевіряє, чи зроблено те, що просили. Інший - стиль і зайвий код. Знайдене агент виправляє до того, як написати «готово».

Така інструкція займає півтора десятка рядків. Якщо покласти її в CLAUDE.md, агент отримуватиме її в кожній сесії: і в задачі про текст для лендингу, і в розборі логів, де рецензувати нічого. Це зайвий контекст, а іноді й зайва робота.

Писати її вручну в кожній задачі теж незручно. Її легко забути, а під час копіювання зі старої задачі легко взяти застарілу версію.

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

У Tascue така інструкція стає інклюдом - наприклад, «Незалежні рецензенти». Його позначають у задачах, де змінюється код, і під час копіювання він стає в кінець промпту. У задачах про тексти й дослідження його просто немає.

Якщо інклюд з’явився, коли в беклозі вже багато задач, його можна додати в усі одразу: «Застосувати до всіх завдань у беклозі». Задачі в роботі та виконані не зміняться.

Що куди класти

Інструкція Де тримати
Потрібна в будь-якій задачі цього репозиторію: як запустити тести, як влаштований проєкт CLAUDE.md
Потрібна в задачах одного типу: рев’ю коду, перевірка в браузері, правила текстів Інклюд проєкту
Потрібна в усіх проєктах: «не роби коміти» Спільний інклюд, увімкнений у нових задачах за замовчуванням
Потрібна в одній задачі Текст задачі

Проста перевірка для нової інструкції: чи потрібна вона в кожній задачі? Якщо ні, їй місце в інклюді, а CLAUDE.md лишається коротким і читається за хвилину.

Промпт із задачі збирається сам: інтро, поля, текст, інклюди. У Claude Code його можна вставити після «Скопіювати» або віддати через MCP - агент отримає ту саму задачу повністю.

Стежте за Tascue у LinkedIn