diff --git a/tasks/multi-agent/BRD.md b/tasks/multi-agent/BRD.md index 10a5328..d036ce3 100644 --- a/tasks/multi-agent/BRD.md +++ b/tasks/multi-agent/BRD.md @@ -29,9 +29,10 @@ related: | Заказчик / Owner | Слава | Формулирует задачи, ставит approve, наблюдает в Plane | | Analyst | Стрим (OpenClaw) | Пишет BRD/ТЗ, задаёт вопросы, координирует | | Orchestrator | Скрипт (FastAPI) | Слушает webhooks, проверяет QG, запускает агентов | +| Architect | Claude Code CLI | ADR, C4-диаграммы, требования к инфре/данным | | Developer | Claude Code CLI | Пишет код, тесты, открывает PR | | Reviewer | Claude Code CLI | Проверяет код на соответствие ТЗ/ADR | -| Tester | Claude Code CLI | Запускает тесты, оформляет отчёт | +| Tester | Claude Code CLI | Запускает e2e/регресс, оформляет отчёт | ## 3. Scope @@ -40,13 +41,12 @@ related: - Claude Code CLI на mva154: установка, авторизация, headless mode - Gitea: репо Enduro Trails, branch protection, CI (Gitea Actions) - Plane: шаблоны Work Item, webhooks, лейблы, custom fields -- Агенты: Developer, Reviewer (через Claude Code CLI) -- Quality Gates: QG-0 → QG-5 (до деплоя) +- Агенты: Architect, Developer, Reviewer, Tester (через Claude Code CLI) +- Quality Gates: QG-0 → QG-7 (полный конвейер) - Пилотный проект: Enduro Trails ### Вне скоупа (v1) - Designer-агент (UI-дизайн пока ручной) -- Tester-агент (на пилоте — Developer пишет тесты сам) - Deployer-агент (деплой ручной или через простой CI) - Ephemeral preview-окружения - Visual regression / a11y тесты @@ -104,7 +104,7 @@ related: - Reactions как approve-механизм - Webhooks → Orchestrator -## 5. Производственный процесс (упрощённый для пилота) +## 5. Производственный процесс ``` Слава Стрим Orchestrator Claude Code CLI @@ -117,10 +117,14 @@ related: │◄── Прошу approve ──┤ │ │ ├─── :approved: ─────► │ │ │ │ ├─ QG-1 check │ + │ │ ├─ Запуск Architect ──►│ + │ │ │ ├─ ADR + требования + │ │ │ ├─ git commit + │ │ │◄── push event │ + │ │ ├─ QG-2 check │ │ │ ├─ Запуск Developer ──►│ │ │ │ ├─ Код + тесты - │ │ │ ├─ git commit - │ │ │ ├─ PR + │ │ │ ├─ git commit + PR │ │ │◄── webhook CI green │ │ │ ├─ QG-4 check │ │ │ ├─ Запуск Reviewer ───►│ @@ -128,6 +132,10 @@ related: │ │ │ ├─ approve/reject │ │ │◄── webhook review │ │ │ ├─ QG-5 check │ + │ │ ├─ Запуск Tester ─────►│ + │ │ │ ├─ e2e + отчёт + │ │ │◄── test report │ + │ │ ├─ QG-6 check │ │ │ ├─ Merge PR │ │ │ ├─ Deploy test │ │◄── Готово, проверь ─┤ │ │ @@ -135,23 +143,27 @@ related: │ │ ├─ Done │ ``` -**Этапы пилота (5 из 8):** +**Этапы (7 из 8):** 1. **Постановка** — Слава в Plane (или через Стрим) 2. **Анализ** — Стрим пишет BRD/ТЗ/AC -3. **Разработка** — Claude Code CLI (код + тесты + PR) -4. **Code Review** — Claude Code CLI (другой запуск, другой prompt) -5. **Внедрение** — merge + deploy (CI или ручной) +3. **Архитектура** — Claude Code CLI (ADR, C4, требования к инфре/данным) +4. **Разработка** — Claude Code CLI (код + unit-тесты + PR) +5. **Code Review** — Claude Code CLI (другой запуск, проверка соответствия ТЗ/ADR) +6. **Тестирование** — Claude Code CLI (e2e, регресс, отчёт) +7. **Внедрение** — merge + deploy (CI или ручной) -Пропущены на пилоте: Архитектура (Стрим решает inline), Дизайн (не нужен), Тестирование (Developer пишет тесты). +Пропущен на пилоте: Дизайн (UI-макеты пока ручные). -## 6. Quality Gates (пилот) +## 6. Quality Gates | QG | Между | Что проверяет | Как | |----|-------|---------------|-----| | QG-0 | Постановка → Анализ | title + description заполнены | Orchestrator (webhook) | -| QG-1 | Анализ → Разработка | ТЗ есть + :approved: от Славы | Orchestrator (файл + Plane API) | +| QG-1 | Анализ → Архитектура | ТЗ/BRD/AC есть + :approved: от Славы | Orchestrator (файл + Plane API) | +| QG-2 | Архитектура → Разработка | ADR есть, req-coverage, диаграммы рендерятся | Orchestrator (lint-adr.sh) | | QG-4 | Разработка → Review | CI зелёный (lint + test + build) | Gitea Actions → webhook | -| QG-5 | Review → Merge | Review approve + 0 unresolved | Orchestrator (Gitea API) | +| QG-5 | Review → Тестирование | Review approve + 0 unresolved | Orchestrator (Gitea API) | +| QG-6 | Тестирование → Внедрение | Все тесты зелёные, test-report создан | Orchestrator | | QG-7 | Merge → Done | Deploy smoke OK + :approved: | Orchestrator | ## 7. Инфраструктура (что нужно поднять)