⚪️ Суб-агенты: зачем


❓ В чатике нашего канала (welcome, если что, ссылка в описании канала) встал закономерный вопрос: а как можно использовать субагентов, чем они важны или полезны?

▶️ Сразу скажу что работать можно вполне и без субагентов, нет такой работы, которую бы можно сделать только субагентами. Последовательное выполнение задач вполне себе работает (исключение которое мне кажется имеется - скажу позже)

Какие же задачи можно решать субагентами эффективно?

▶️ Прежде всего - исследования. Шикарно сварм работает когда мы хотим что то найти в проекте, разобраться в чем то. Можно назначит ьсубагенту мелкую модель (например, gpt-5.4-mini) и она довольно быстро, щадящим образом для лимитов соберет вам контекст по кодовой базе. Примеры промптов типа "разберись как в проекте работает система аутентификации, ее взаимосвязи и контракты, как она документирована - в общем, собери все. Используй субагентов для поиска на gpt-5.4-mini". В кодексе есть даже субагент explore вроде бы, видел несколько раз как он сам запускался.

▶️ Проработка разных аспектов плана. Тут посложнее.

👉 Лирическое отступление про постановку задачи и отчетность. Я ВСЕГДА делаю материализованные планы, постаноку задач и отчеты о выполнении. Это значит что все через md файлы. Да, можно в контекст сессии все пихать, и оно где то в сессии даже будет в файл записано, но использвоание файлов дает мне:
• прослеживаемость: я всегда могу открыть файл и посомтреть какое задание было дано
• артефакты задачи все в одном месте, в папке задачи, не надо искать по сессиям
• можно сослаться на план работы (ставя задачу верификации или ревью)
• часто агент может лучше поставить задачу в файл, чем в контекст, более развернуто, плюс - можно записывать задачу через паттерн рефлексии: первым шагом записали черновик задачи, вторым шагом промпт на "доработай задачу, ..." - и станет заметно лучше;
• задачу в файле можно прорабатывать в много проходов, по разным аспектам - в контексте агент не будет пересказывать ее дословно со всеми деталями, она потеряется при длительном обсуждении;

Теперь к аспектам: когда мы делаем план, надо много вещей держать ввиду. Соблюдение паттернов, стандартов кода. Не оверинжинирить. Безопасность кода. Документирвоание именений. Переимпользование сущностей кода и следование архзитектуре проекта. Работа с БД/хранилищем, миграции и прочие приколы. Соблюдение принятого в проекте гит флоу. Соблюдение подходов к CI / CD, схема выкатки деплоев. ... Думаю, вы можете в зависимости от специфики проекта перечислить массу таких аспектов!

Для того чтобы план работы был проработан по всем этим аспектам, и проработан хорошо, в идеале нужно каждый аспект прогонять моделью отдельно - тогда она качественно этот аспект проработает. В отдельных ответственных случаях я делаю @3 самплинг (это когда задача повторяется три раза, а потом мы интегрируем результат, при это 3 минимально полезный самплинг, лучше 5 делать для прям хорошего качества).

Как вы понимаете, если у вас десяток аспектов - то это уже 10 запусков агента. А если на часть и @3 самплинг, ... В общем, тут тоже здорово работает модель запустить это через субагентов. Промптинг я делаю на постановку задачи через файл, на результат отработки задачи через файл.


... (продолжение: https://t.me/deksden_notes/713)