Зачем делят AGENTS.md / CLAUDE.md на несколько файлов ❓

TL;DR: AGENTS.md/CLAUDE.md дробят, чтобы сужать контекст, давать правила "по месту" (для конкретного модуля) и не упираться в лимиты - и OpenAI это прямо заложила в механику Codex.

1️⃣ Контекст "по месту", а не простыня на весь репо

Идея - держать базовые правила в корне, а узкие - рядом с кодом (сервис/пакет/папка). Тогда агент подтягивает то, что релевантно текущей директории. В Codex это оформлено как "цепочка инструкций": он собирает файлы от корня проекта до текущей папки, и файлы ближе к текущей директории "перекрывают" ранние.

2️⃣ Официально поддержанные override`s и приоритеты

Codex проверяет в каждой папке сначала AGENTS.override.md, потом AGENTS.md, и берёт максимум один файл на директорию. Это и есть "переопределение правил" без копипасты всего документа.

3️⃣ Лимит размера 🔜 проще дробить, чем раздувать один файл

В документации Codex явно сказано, что он прекращает добавлять инструкции, когда суммарный размер достигает лимита (по умолчанию 32 KiB) - и прямо рекомендует разносить инструкции по вложенным директориям, если упираетесь в кап.

👇👇👇

Как это делает OpenAI у себя

Про практику OpenAI есть публичный сигнал: в обзоре формата отмечают, что у OpenAI-организации "десятки AGENTS.md" по подкомпонентам, т.е. подход именно "много маленьких по месту", а не один общий.
Плюс, сама документация Codex описывает "слоение" инструкций: глобальные (~/.codex), репо-уровень (корень) и локальные overrides (подпапки).

〰️〰️〰️〰️〰️〰️〰️〰️

Дробление AGENTS.md/CLAUDE.md - это важный инженерный приём, который привнесёт тебе следующей пользы:

🟢меньше шума в контексте,
🟢правила применяются там, где нужно,
🟢проще сопровождать,
🟢не ловить silent-truncation на лимитах.

@data_engi

#openai #agents #hack #trix #ai #llm #dev