Чек-лист агентного инженера

Семь привычек, которые отличают режиссёра ИИ-агентов от того, кто жмёт «принять всё». Это не про код - это про то, как ставить и принимать работу у любого исполнителя, в том числе у ИИ.

1. Сначала сформулировать задачу

Размытая задача - размытый результат. Прежде чем звать агента, сформулируйте словами: что на входе, что должно быть на выходе, чего точно делать не надо. Половина плохих результатов - это плохо поставленная задача, а не слабая модель.

2. Дать контекст

У модели амнезия (раздел 03) - сама она ваш проект не помнит. Принесите ей контекст: правила проекта, примеры «как надо», ограничения, имена и связи. Чем точнее контекст, тем меньше модель додумывает наугад.

3. Разбить на этапы

Не «сделай всё», а последовательность обозримых шагов. Маленький шаг легко проверить и легко откатить, если что-то пошло не так. Большой шаг превращается в простыню, которую невозможно проверить честно.

4. Посмотреть на архитектуру

Прежде чем агент напишет тонну деталей, договоритесь о структуре: из каких частей состоит решение, как они связаны, где данные. Кривую архитектуру потом дороже переделывать, чем сразу поправить план. На многих агентах для этого есть режим планирования - сначала план, потом исполнение.

5. Держать в голове безопасность

Спросите себя: что будет, если в данные попадёт вредная инструкция? У кого какие права? Что необратимо? Необратимое (удаление, оплата, отправка наружу, выкатка) - только через явное подтверждение человека. Подробнее - в разделе про доверчивость.

6. Тестировать результат

«Вроде работает» - не критерий. Проверяйте на реальных и на неудобных данных, а не только на том счастливом случае, что показал агент. Помните про works.any() против works.all(): сработавшее один раз - это ещё не работающее всегда.

7. Не принимать слепо

Принимать - осознанно. Если не понимаете, что сделал агент, - это сигнал не «он умнее меня», а «надо разобраться или попросить объяснить и упростить». Вы отвечаете за систему целиком, даже если каждую строчку написал ИИ.

Свести в одну фразу

Поставил задачу - дал контекст - разбил на шаги - проверил план - подумал про безопасность - протестировал - принял осознанно. Семь шагов, которые превращают «я пользуюсь ИИ» в «я управляю ИИ».