Subagent стискає дослідження

Коли потрібно переглянути багато модулів, тестів, конфігурацій або логів, subagent допомагає винести пошук в окремий контекст і повернути основній сесії лише стислий, перевірюваний результат.

Subagent — це дослідницький інструмент, а не заміна фінального рішення. Основна сесія відповідає за перевірку висновків і зміни в репозиторії.

Доцільно делегуватиНе варто делегувати
Знайти всі інтеграції з платіжним сервісомПрочитати один короткий файл
Простежити повний refund flowЗʼясувати один рядок trace
Зібрати повʼязані тестиВнести маленьку правку
Узагальнити великий diff або логиВести довгу інтерактивну розмову

Mini-task spec для subagent

Мета, межі, формат, обмеження
Досліди шлях refund-операції.
Перевір controllers, services, payment client, config і tests.
Поверни стислий висновок, file:line evidence,
припущення, відкриті питання та наступні кроки.
Файли не змінюй; великі фрагменти коду не копіюй.

Очікуваний результат

  • **Висновок** — кілька речень про знайдений flow;
  • **Evidence** — конкретні посилання на файл і рядки;
  • **Припущення** — те, що випливає з непрямих ознак;
  • **Відкриті питання** — що залишилося неперевіреним;
  • **Наступні дії** — що має перевірити основна сесія.

Після повернення висновку

  1. Перевірте два-три ключові місця вручну.
  2. Зіставте висновок із тестом або командою.
  3. Відокремте підтверджене від припущень.
  4. Оновіть inventory, API map або investigation note через звичайний diff.
  5. Не переносіть неперевірений summary у документацію як факт.

Межі delegation

Не використовуйте subagent для кожної дрібної задачі й не створюйте складну multi-agent систему на етапі простого investigation. Делегування має зменшувати шум, зберігаючи людський контроль над доказами та фінальним результатом.

Канонічне джерело уроку · JavaRush

Відкрити матеріал JavaRush