Коротко: якщо Ви працюєте з Claude Code або Codex, не тримайте весь контекст у чаті. Створіть у проєкті просту файлову систему: правила для агента, пам'ять, поточний план, сирі джерела, бізнес-контекст, готові результати і чеклісти перевірки. Тоді AI читає менше зайвого, краще розуміє задачу і рідше вигадує факти.
Для кого ця структура
Ця схема підходить для людей, які хочуть працювати з AI-агентами не як з одноразовим чатом, а як з робочою системою всередині проєкту.
Наприклад, Ви можете використовувати Claude Code, Codex або обидва інструменти. Назви стартових файлів у них різні, але ідея однакова: агенту треба пояснити, де лежать правила, де пам'ять, де поточний план, де сирі матеріали і де готові результати.
Такий приклад можна брати як основу. Головна ціль - зібрати структуру, з якою AI не починає кожне завдання з нуля.
Головна ідея: не один великий промпт, а карта проєкту
Довгий промпт швидко перетворюється на хаос. Сьогодні Ви додали туди бізнес-контекст, завтра правила стилю, післязавтра нову задачу, а через тиждень агент уже читає багато зайвого.
Файлова структура працює краще, бо кожен тип інформації має своє місце:
- Правила для агента лежать окремо.
- Довга пам'ять не змішується з поточним планом.
- Сирі матеріали не потрапляють у очищений бізнес-контекст.
- Готові результати не губляться у чатах.
- Невідомі факти записуються як питання, а не вигадуються.
Claude Code і Codex: які файли використовувати
У Claude Code і Codex стартові файли виконують схожу роль, але називаються по-різному.
| Якщо Ви працюєте в | Основний файл правил | Для чого він потрібен |
|---|---|---|
| Claude Code | CLAUDE.md | Пояснює Claude Code, як працювати з цим проєктом. |
| Codex | AGENTS.md | Пояснює Codex та іншим агентам правила, межі і маршрут роботи. |
| Обидва інструменти | CLAUDE.md + AGENTS.md | Один файл можна зробити головним, а другий - коротким loader-файлом. |
По суті, CLAUDE.md і AGENTS.md - це майже однакові за роллю файли для різних AI-систем. Вони мають відповідати на одні й ті самі питання:
- що агент має прочитати першим;
- де лежить пам'ять про проєкт;
- де поточний план;
- де бізнес-контекст;
- що не можна чіпати без дозволу;
- як перевіряти результат.
Якщо Ви використовуєте тільки Claude Code, почніть з CLAUDE.md. Якщо використовуєте тільки Codex, почніть з AGENTS.md. Якщо використовуєте обидва, не дублюйте довгі правила у двох місцях: зробіть один файл головним, а другий нехай коротко направляє до нього.
Мінімальна структура з нуля
Для старту не треба будувати складну систему. Достатньо такої бази:
CLAUDE.md або AGENTS.md
memory.md
plan.md
raw/
business/
INDEX.md
project-summary.md
open-questions.md
products/
audience/
marketing/
economics/
voice/
outputs/
evals/
archive/Це вже перетворює порожній проєкт на зрозумілий workspace для AI-агента.
За що відповідає кожен блок
| Блок | Роль у проєкті |
|---|---|
CLAUDE.md або AGENTS.md | Головні правила для AI-агента у Вашому проєкті. |
memory.md | Стабільні факти, важливі рішення, обмеження, довга пам'ять. |
plan.md | Поточна задача, наступні кроки, блокери, що треба перевірити. |
raw/ | Сирі джерела: брифи, транскрипти, CSV, аудити, скріншоти, промпти. |
business/ | Очищена бізнес-пам'ять: продукти, аудиторія, оффер, економіка, стиль. |
business/INDEX.md | Карта бізнес-файлів: куди дивитися по кожному питанню. |
business/project-summary.md | Коротка вижимка бізнесу з посиланнями на повні файли. |
business/open-questions.md | Місце для невідомих або сумнівних фактів. |
outputs/ | Готові результати: статті, ТЗ, промпти, тексти, аудити. |
evals/ | Чеклісти якості, за якими агент перевіряє роботу. |
Що написати у файлі правил
Стартовий файл правил не має бути великим. Його задача - не зберігати всю інформацію, а направити агента.
Приклад логіки для CLAUDE.md або AGENTS.md:
1. Спочатку прочитай цей файл.
2. Якщо задача про бізнес, маркетинг, рекламу, контент або продажі - відкрий business/INDEX.md.
3. Якщо треба зрозуміти поточний стан - відкрий plan.md.
4. Якщо потрібні стабільні факти про проєкт - відкрий memory.md.
5. Сирі матеріали шукай у raw/.
6. Готові результати зберігай в outputs/.
7. Якщо факт невідомий - запиши його в business/open-questions.md, не вигадуй.Так агент отримує маршрут і не витрачає токени на випадкове читання всього проєкту.
Як ця структура економить токени
Токени витрачаються не тільки на відповідь. Вони витрачаються на весь контекст, який модель читає перед роботою.
Коли все лежить в одному файлі, агент змушений читати зайве. Коли є project-summary.md, він може швидко зрозуміти бізнес. Коли є business/INDEX.md, він бачить карту і відкриває тільки потрібний файл. Коли сирі матеріали лежать у raw/, агент не плутає чернетки зі стабільною пам'яттю.
Практичний ефект простий: замість "прочитай усе і здогадайся" агент отримує маршрут "прочитай правила, поточний план, короткий summary і тільки потрібну тематичну папку".
Business layer: навіщо потрібна папка business/
Якщо AI працює тільки з кодом, Вам може вистачити правил, пам'яті і плану. Але якщо він допомагає з рекламою, контентом, продажами, продуктами або клієнтським сервісом, йому потрібна бізнес-пам'ять.
Папка business/ відділяє знання про компанію від технічного шуму.
| Дані | Куди покласти |
|---|---|
| Коротка суть бізнесу | business/project-summary.md |
| Навігація по бізнес-файлах | business/INDEX.md |
| Невідомі або сумнівні факти | business/open-questions.md |
| Продукти і послуги | business/products/catalog.md |
| Оффери, бонуси, гарантії | business/products/offer-matrix.md |
| Сегменти аудиторії | business/audience/segments.md |
| Пошуковий попит | business/market/search-demand.md |
| Воронка і friction | business/marketing/funnel.md |
| Економіка, CPA, CAC, ROI | business/economics/unit-economics.md |
| Голос бренду | business/voice/tone-of-voice.md |
Ключове правило для project-summary.md
business/project-summary.md не має бути складом усього. Це коротка вижимка, яку агент може швидко прочитати перед роботою.
Туди варто покласти:
- що за бізнес;
- які продукти або послуги;
- для кого вони;
- який основний оффер;
- які болі, бажання і заперечення аудиторії;
- яка економіка, якщо вона важлива для задач;
- який tone of voice;
- яка поточна ціль;
- посилання на повні файли.
Якщо агенту потрібна загальна картина, він читає summary. Якщо потрібна глибина, переходить у конкретний файл.
Що робити, якщо проєкт уже існує
Не треба ламати стару структуру і переносити все механічно. Краще дозібрати відсутній шар.
- Визначте, з яким агентом працюєте: Claude Code, Codex або обидва.
- Додайте
CLAUDE.mdабоAGENTS.md. - Створіть
memory.mdіplan.md, якщо їх немає. - Винесіть сирі матеріали в
raw/. - Створіть
business/INDEX.mdіbusiness/project-summary.md. - Важливі бізнес-факти дистилюйте в тематичні файли.
- Невідомі факти записуйте в
open-questions.md.
Головне - не перетворювати нову структуру на ще один склад. Її задача - допомогти агенту швидко знайти потрібний контекст.
Типові помилки
- Писати всі правила, пам'ять і план в один файл.
- Дублювати різні інструкції в
CLAUDE.mdіAGENTS.md. - Класти сирі транскрипти прямо в
memory.md. - Не вести
plan.md, через що агент щоразу починає з нуля. - Не фіксувати відкриті питання.
- Не мати
evals/, тобто перевірок якості результату.
FAQ
Що краще створити: CLAUDE.md чи AGENTS.md?
Якщо Ви працюєте в Claude Code, створіть CLAUDE.md. Якщо працюєте в Codex, створіть AGENTS.md. Якщо використовуєте обидва інструменти, можна мати обидва файли, але не дублювати в них різні правила.
Чи однакові CLAUDE.md і AGENTS.md?
За роллю вони дуже схожі: це стартові інструкції для AI-агента. Різниця в тому, що різні системи читають різні файли. Тому структура правил може бути майже однакова, але назва файлу залежить від інструмента.
Як економити токени в Claude Code і Codex?
Не змушуйте агента читати все підряд. Зробіть файл правил роутером, project-summary.md короткою вижимкою, business/INDEX.md картою контексту, а сирі матеріали тримайте в raw/.
Чи потрібна папка business/ у кожному проєкті?
Вона особливо потрібна, якщо AI працює з продуктом, маркетингом, рекламою, продажами, контентом або клієнтськими знаннями. Для чисто технічного проєкту можна почати з мінімальної структури і додати business/ пізніше.
Бонус: готовий промпт для Claude Code або Codex
Скопіюйте цей промпт у Claude Code або Codex, відкривши корінь нового або існуючого проєкту. Він допоможе агенту створити структуру акуратно: без видалення старих файлів, без дублювання правил і без вигадування бізнес-фактів.
Ти працюєш у корені мого проєкту. Потрібно налаштувати файлову структуру для роботи з AI-агентом у Claude Code або Codex.
Головні правила:
1. Спочатку перевір, які файли і папки вже існують.
2. Не видаляй, не перейменовуй і не перезаписуй існуючі файли без мого дозволу.
3. Якщо файл уже існує, не замінюй його повністю. Акуратно додай тільки відсутній короткий блок або запропонуй зміни.
4. Якщо факт про бізнес невідомий, запиши його в business/open-questions.md, не вигадуй.
Файл правил:
- якщо ти працюєш у Claude Code, основний файл правил - CLAUDE.md;
- якщо ти працюєш у Codex, основний файл правил - AGENTS.md;
- якщо в проєкті потрібні обидва файли, один зроби головним, а другий коротким loader-файлом, який посилається на головний.
Створи або дозбери таку структуру:
CLAUDE.md або AGENTS.md
memory.md
plan.md
raw/
business/
INDEX.md
project-summary.md
open-questions.md
products/
catalog.md
offer-matrix.md
audience/
segments.md
marketing/
funnel.md
economics/
unit-economics.md
voice/
tone-of-voice.md
outputs/
evals/
archive/
У файл правил додай короткий маршрут для агента:
1. Спочатку читати файл правил.
2. Для поточного стану читати plan.md.
3. Для стабільних фактів читати memory.md.
4. Для бізнесу, маркетингу, реклами, продажів і контенту читати business/INDEX.md.
5. Сирі джерела шукати в raw/.
6. Готові результати зберігати в outputs/.
7. Невідомі факти записувати в business/open-questions.md.
У business/INDEX.md створи карту бізнес-файлів.
У business/project-summary.md створи короткий шаблон: що за бізнес, продукти, аудиторія, оффер, болі/бажання/заперечення, економіка, tone of voice, поточна ціль, посилання на повні файли.
У plan.md створи короткий блок: поточна задача, наступні кроки, блокери, як перевірити результат.
У memory.md створи місце для стабільних фактів і важливих рішень.
У evals/ створи простий checklist перевірки структури.
Після виконання покажи:
- які файли створено;
- які файли оновлено;
- які питання залишились відкритими;
- як перевірити, що структура працює.Висновок
AI-агент працює стабільніше, коли має не хаотичний чат, а зрозумілу файлову систему: правила, пам'ять, план, сирі джерела, бізнес-контекст, результати і перевірки.
Цей підхід можна використовувати як основу, але адаптувати під свій інструмент і свій бізнес. Якщо потрібен Claude Code - почніть з CLAUDE.md. Якщо потрібен Codex - почніть з AGENTS.md. Якщо потрібна система для бізнесу, додайте business/ і навчіть агента працювати з фактами, а не з припущеннями.
Саме так будуються AI-агенти, які працюють за правилами і базою знань компанії, а не вигадують відповіді з голови.