Каркас рабочего ИИ-агента: одна страница, три промпта, одиннадцать проверок

1. Почему больше агентов это хуже

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

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

Когда второй агент действительно нужен

• Работа физически не помещается в один контекст: разбор ста файлов, обход сотни страниц.
• Нужна независимая проверка: один делает, второй судит по заранее написанным критериям и не знает, кто автор.
• Разные права доступа: один читает боевую базу, второй пишет только в черновик.

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

2. Из чего состоит каркас

Рабочий агент держится на четырёх вещах. Ни одна из них не про сложность схемы.

• Одна страница инструкции. Кто он, что делает, чего не делает никогда, как выглядит готовый результат.
• Папка с файлами, к которым у него есть доступ. Предсказуемые имена, никакой свалки.
• Три промпта: постановка задачи, самопроверка перед сдачей, разбор после работы.
• Список требований, по которому ты проверяешь его перед тем, как доверить живую работу.

3. Схема папки с инструментами

Агент работает ровно настолько хорошо, насколько понятно устроена его папка. Эта схема выдерживает рост и не превращается в свалку через месяц.

Два файла, которые решают больше всего

Папка examples важнее любой инструкции. Один принятый образец и один завёрнутый дают агенту больше, чем страница требований, потому что показывают границу на живом материале.

Файл errors.md не даёт агенту ходить по кругу. Каждый раз, когда ты его поправил, туда идёт строка: что было, что стало, почему. Перед новой работой агент читает этот файл первым.

4. Промпт первый: постановка задачи

Этот промпт ставится перед каждой новой работой. Он заставляет агента задать вопросы до начала, чтобы через час не принести не то.

5. Промпт второй: самопроверка перед сдачей

Половина брака ловится самим агентом, если дать ему список проверок и потребовать ответ по каждой. Этот промпт вставляется перед тем, как агент отдаёт работу.

6. Одиннадцать требований к собранному агенту

Прогони этот список перед тем, как дать агенту первую живую работу. Каждый пункт проверяется за минуту.

• Инструкция помещается на одну страницу и читается целиком за две минуты.
• Роль названа одной фразой, без перечисления пяти профессий.
• Есть раздел «чего не делаю никогда» минимум из пяти строк.
• Вид готового результата описан примером, без слов «качественно» и «подробно».
• В папке examples лежит хотя бы один принятый и один завёрнутый образец.
• Файл errors.md существует и агент читает его перед работой.
• У агента один тип работы. Второй тип означает второго агента.
• Есть промпт самопроверки, и агент отвечает по нему построчно.
• Понятно, чем работа заканчивается: куда кладётся файл, кто его принимает.
• Есть граница, за которой агент обязан остановиться и спросить человека.
• Агент прогнан на трёх тестовых задачах, и ты видел, как он ошибается.

7. Промпт третий: разбор после работы

Этот промпт превращает ошибку в правило. Без него агент повторяет одну и ту же ошибку каждую неделю.

Одна такая запись после каждой правки, и через месяц агент перестаёт ошибаться в том, что раньше правилось каждый день. Это и есть вся дрессировка.

8. Пять ошибок, из-за которых конструкция рассыпается

Каждая из них выглядит как усиление и работает как поломка.

• Подагент на каждую мелочь. Схема растёт, контекст теряется на переходах, а чинить приходится саму схему. Один агент на одну законченную работу.
• Инструкция на десять страниц. Агент читает её и теряется в требованиях, начинает выполнять первые и забывает последние. Страница максимум.
• Требования словами «качественно», «подробно», «профессионально». Они ничего не значат для модели. Меняй на примеры и на числа.
• Нет границы остановки. Агент, которому не сказано, где спросить человека, принимает решения за тебя в самом дорогом месте.
• Правки в чате вместо правок в файлах. Поправил в переписке, через день начал новый чат и получил ту же ошибку. Правило живёт в файле. В диалоге оно умирает вместе с чатом.

9. Порядок действий на ближайшие двадцать минут

Чтобы это не осталось чтением, собери каркас прямо сейчас на одном своём агенте.

• Создай папку по схеме из третьего раздела. Пять минут.
• Напиши INSTRUCTION.md на одну страницу: роль одной фразой, задача, пять запретов, пример готового результата. Десять минут.
• Положи три промпта из разделов четыре, пять и семь в папку prompts. Две минуты.
• Прогони список из одиннадцати требований и почини то, что не проходит. Три минуты.