конвейер сборки фич
Конвейер агентов
Фичи собирает мультиагентная сессия: планировщик раскладывает issue по шагам, воркеры делают в изолированных ветках, ревьюер гоняет правки по кругу до приёмки. Merge — только через PR, и жмёт его человек.
в составе:plannerworker ×3reviewermrконтекст у каждого свой
шире экрана — листайте по горизонтали
- итераций ревью на типовую задачу
- 1–2
- воркеров работают параллельно
- ×3
- пушей в main мимо PR
- 0
Прогон
циклограмма типового прогона: план, параллельные воркеры, петля правок и merge · issue #52 → PR #53
шире экрана — листайте по горизонтали
время
план
воркер 1
воркер 2
воркер 3
ревью
mr
merge
журнал прогона · issue #52 → PR #53
- план · читаю issue #52, CONTEXT.md, ADR 0001–0002
- воркер 1 · scout: фактура трекера и меток…… ok · 41 с
- воркер 2 · секции и утилиты tailwind…… ok · 3 мин 12 с
- воркер 3 · og-image + sitemap lastmod…… ok · 1 мин 48 с
- ревью · дифф +214 −3 · замечаний: 2
- итерация → воркер 2 · утилиты утекут в прод-CSS — закрыть каталог · fixed
- итерация → воркер 2 · scroll-padding меньше шапки — секции заезжают · fixed
- ревью · замечаний нет — approving
- mr · ветка feat/ai-workflow, gh pr create — PR #53
- ci · fmt ✓ · clippy ✓ · render-тесты ✓
- merge · squash от @stalexsm — готово · 4 мин 07 с
Роли
Супервизор ведёт сессию и отвечает за результат. Субагент — это форк контекста: он получает задачу и свой набор инструментов, а назад возвращает только итоговое резюме. Контекст не распухает, роли не путаются.
| роль | на входе | на выходе | инструменты |
|---|---|---|---|
| planner | issue, CONTEXT.md, ADR | план: шаги, файлы, риски | только чтение |
| worker | один шаг плана | правки в своём worktree | чтение + запись |
| scout | вопрос по кодовой базе | сжатая фактура, ссылки на файлы | только чтение |
| reviewer | дифф | замечания или approve | только чтение |
| mr | одобренный дифф | ветка, PR, зелёный CI | gh CLI |
- свой контекст
- субагент не видит переписку супервизора — наружу выходит только резюме результата
- своя песочница
- параллельные воркеры пишут в разные git worktree; один writer на каталог — без гонок
- стоп на ошибке
- упавший субагент не «тихо чинится»: супервизор останавливается и докладывает человеку
Скиллы
Скилл — папка с SKILL.md: имя, описание и инструкция. Агент видит только имена и описания, а тело скилла подгружается, когда задача совпала. Проверенные процедуры живут один раз и работают в любой сессии.
tdd/
тест-первым: красный → зелёный → рефакторинг; интеграционные как контракт
code-review/
ревью диффа по двум осям: стандарты репозитория и исходная спека задачи
research/
рессёрч по первоисточникам с фиксацией находок в markdown-файл репозитория
domain-modeling/
глоссарий и ADR: термины и решения рождаются, когда встают, а не впрок
grilling/
допрос плана до вскрытия слабых мест — до того, как план ушёл в работу
prototype/
одноразовый прототип, чтобы ответить на вопрос дизайна и выбросить
как это работает: в системный промпт попадает только описание скилла (пара строк); инструкция целиком грузится по совпадению. Длинные справочники почти ничего не стоят, пока не понадобились.
Паспорт проекта
AGENTS.md — это README для агентов: конвенции, структура, запреты и критерии готовности в корне репозитория. Любой агент читает его до первой правки — и не переспрашивает очевидное.
AGENTS.md · конвенции
прямые пуши в main- любая работа — ветка и pull request
- чистые fmt и clippy — критерий готовности
- commit-сообщения — по конвенции, на русском
docs/agents/ · как агентам работать
- issue-tracker — задачи в GitHub issues, операции через gh
- triage-labels — пять меток от триажа до wontfix
- domain — сначала CONTEXT.md и ADR, потом правки
| метка | смысл |
|---|---|
| needs-triage | владелец оценивает задачу |
| needs-info | ждём деталей от автора |
| ready-for-agent | спека полная — агент работает без человека |
| ready-for-human | только ручная реализация |
| wontfix | делать не будем |
Метка ready-for-agent — главный переключатель конвейера: как только спека полная, задача уходит агенту без участия человека — а возвращается PR-ом.
Ревью — за человеком
Агенты ускоряют каждую петлю правок, но merge остаётся решением человека: он читает дифф, смотрит CI и жмёт кнопку. Конвейер снимает рутину — не ответственность. Такой процесс работает на любом проекте, где задачи можно описать словами.
заверение решения