Проблема
Давайте будем честны: мы больше не хотим читать код. Не хотим проверять всё, что делают агенты, и держать в голове каждую техническую деталь проекта.
Но если агентов никто не контролирует, они превратят любой проект в неподдерживаемый хаос, в котором не разберётся ни человек, ни агент. Это лишь вопрос времени.
Идея
HUMAN-INTENT.md — это файл в корне репозитория, в нём ваш замысел: архитектура проекта, правила разработки и продуктовые решения.
Это не документация к коду. Это закон, которому код обязан подчиняться.
Правила
-
Пишется вами — и только вами
Агенты никогда не редактируют этот файл. Каждая строка в нём — решение, принятое человеком.
-
Его инструкции — закон для агента
Написанное в HUMAN-INTENT.md важнее всего остального. Если код противоречит файлу — неправ код.
-
Он задаёт архитектуру, правила и продукт
Замысел, а не рецепты. Агент и так знает все паттерны; ваша задача — зафиксировать, что должно быть верно и почему.
Почему это работает
За агентами невозможно уследить: кода становится больше, чем кто-либо готов прочитать. Контролировать каждую строку — безнадёжно. Контролировать замысел — реально.
HUMAN-INTENT.md поднимает контроль на уровень выше: вы следите за одним файлом со своими решениями, а не за тысячами строк кода. Пока файл — закон, проект развивается по вашему замыслу, даже если код никто не читает.
С чего начать
- Создайте HUMAN-INTENT.md в корне репозитория.
- Запишите решения, которые уже приняты: архитектура, правила разработки, продукт.
- Скажите агенту читать этот файл и считать его законом — сошлитесь на него из AGENTS.md или CLAUDE.md.
- Каждое новое решение добавляйте в файл. Никогда не позволяйте агенту писать в него.
- Ревьюируйте этот файл, а не код.