Definition of Ready для AI-агента
Definition of Ready для AI-агентаМы давно усвоили: плохо поставленная задача плохо заканчивается.
Но затем открываем чат с AI-агентом и пишем:
Сделай фичу.А через час удивляемся, почему он изменил не тот модуль, нарушил архитектуру и написал тесты, которые ничего не проверяют.
Проблема не всегда в агенте. Иногда он просто слишком буквально выполнил слишком расплывчатое задание.
Поэтому AI-агенту нужен свой Definition of Ready.
До запуска он должен понимать:
— какую проблему решает;
— где можно менять код;
— куда заходить нельзя;
— какие есть архитектурные ограничения;
— какой стиль принят в проекте;
— какие тесты должны пройти;
— что считается готовым результатом;
— как именно человек будет проверять его работу.
Сравните два задания.
Плохое:
Сделай регистрацию.
Готовое к работе:
Добавь регистрацию через этот API.
Следуй этому ADR.
Меняй только модуль Auth.
Схему базы не трогай.
Вот примеры похожего кода.
Вот обязательные тесты.
Задача готова, когда выполняются эти сценарии.Во втором случае агенту не приходится угадывать ваши намерения. Он может заниматься реализацией.
DoR придумали не для бюрократии и не только для разработчиков. Он нужен любому исполнителю, от которого ждут предсказуемого результата.
Даже если исполнитель кремниевый.