Проблема
Будьмо чесними: ми більше не хочемо читати код. Не хочемо перевіряти все, що роблять агенти, і тримати в голові кожну технічну деталь проєкту.
Але якщо агентів ніхто не контролює, вони перетворять будь-який проєкт на хаос, який неможливо підтримувати і в якому не розбереться ні людина, ні агент. Це лише питання часу.
Ідея
HUMAN-INTENT.md — один файл у корені репозиторію. У ньому ваш задум: архітектура проєкту, правила розробки та продуктові рішення.
Це не документація до коду. Це закон, якому код зобов'язаний підкорятися.
Правила
-
Пишеться вами — і тільки вами
Агенти ніколи не редагують цей файл. Кожен рядок у ньому — рішення, ухвалене людиною.
-
Його інструкції — закон для агента
Написане в HUMAN-INTENT.md важливіше за все інше. Якщо код суперечить файлу — помиляється код.
-
Він визначає архітектуру, правила і продукт
Задум, а не рецепти. Агент і так знає всі патерни; ваше завдання — зафіксувати, що має бути істинним і чому.
Чому це працює
За агентами неможливо встежити: коду стає більше, ніж будь-хто готовий прочитати. Контролювати кожен рядок — безнадійно. Контролювати задум — реально.
HUMAN-INTENT.md піднімає контроль на рівень вище: ви стежите за одним файлом зі своїми рішеннями, а не за тисячами рядків коду. Поки файл — закон, проєкт розвивається за вашим задумом, навіть якщо код ніхто не читає.
З чого почати
- Створіть HUMAN-INTENT.md у корені репозиторію.
- Запишіть рішення, які вже ухвалено: архітектура, правила розробки, продукт.
- Скажіть агентові читати цей файл і вважати його законом — пошліться на нього з AGENTS.md чи CLAUDE.md.
- Кожне нове рішення додавайте у файл. Ніколи не дозволяйте агентові туди писати.
- Рев'юйте цей файл, а не код.