auto-sync: 2026-05-31 19:30:01
This commit is contained in:
Stream
186
tasks/multi-agent/DEV_TASK_ANALYST_PLANE_SYNC.md
Normal file
186
tasks/multi-agent/DEV_TASK_ANALYST_PLANE_SYNC.md
Normal file
@@ -0,0 +1,186 @@
|
||||
# DEV TASK: Analyst Plane Sync Integration
|
||||
|
||||
**Статус:** Ready for dev
|
||||
**Проект:** multi-agent
|
||||
**Приоритет:** High
|
||||
**Зависит от:** DEV_TASK_ANALYST_IN_ORCHESTRATOR
|
||||
|
||||
---
|
||||
|
||||
## Контекст
|
||||
|
||||
Существующие агенты (`architect`, `developer`, `reviewer`, `tester`) уже интегрированы с Plane через:
|
||||
- `plane_sync.py` (state update, comments)
|
||||
- Автоматический запуск через Plane webhook в `plane.py`
|
||||
- Автоматический запрос `:approved:` и продвижение стадий
|
||||
|
||||
**Analyst** — единственный агент, который:
|
||||
- Был запущен "вручную" (через `launcher.py` напрямую)
|
||||
- Записал документы локально, но **не синхронизировался с Plane**
|
||||
- Не запросил `:approved:` у стейкхолдера
|
||||
- Не обновил статус тикета
|
||||
|
||||
В результате ET-005 (Спутниковая карта) аналитик отработал, создал BRD/ТЗ/AC/Test Plan, но ничего не появилось в Plane, и Слава не получил запрос на согласование.
|
||||
|
||||
---
|
||||
|
||||
## Цель
|
||||
|
||||
Сделать Analyst **полностью интегрированным агентом** в конвейере Plane → Orchestrator, как architect/developer/reviewer/tester.
|
||||
|
||||
После этой задачи:
|
||||
- Analyst автоматически запускается при переводе тикета в Analysis
|
||||
- Analyst пишет комментарии в Plane при старте, запросе approve, завершении
|
||||
- Analyst автоматически коммитит документы в feature-ветку
|
||||
- Analyst запрашивает `:approved:` у стейкхолдера через комментарий в Plane
|
||||
- Слава видит BRD и может согласовать без дополнительной коммуникации
|
||||
|
||||
---
|
||||
|
||||
## Задачи
|
||||
|
||||
### 1. Зарегистрировать Analyst в Orchestrator launcher
|
||||
|
||||
**Файл:** `src/agents/launcher.py`
|
||||
|
||||
**Что сделать:**
|
||||
- Убедиться, что конфиг для `"analyst"` присутствует (аналогично architect/developer)
|
||||
- Добавить `task_id` в вызов `launch("analyst", repo, task_desc, task_id=task_id)`
|
||||
- Убедиться, что env-переменные для Analyst (HOME, GIT_*) настроены корректно
|
||||
|
||||
**Проверка:**
|
||||
```bash
|
||||
docker exec orchestrator python -c "
|
||||
from src.agents.launcher import launcher
|
||||
print('analyst' in launcher.agent_configs)
|
||||
"
|
||||
```
|
||||
|
||||
### 2. Подключить Analyst к Plane webhook routing
|
||||
|
||||
**Файл:** `src/webhooks/plane.py`
|
||||
|
||||
**Что сделать:**
|
||||
- В `handle_work_item_created` / `handle_work_item_updated`:
|
||||
- Если issue переведён в Analysis (или создан со стадией Analysis) → вызвать `launcher.launch("analyst", repo, task_desc, task_id=task_id)`
|
||||
- Автоматически создать комментарий в Plane: "Analyst запущен. BRD в работе..."
|
||||
- Сохранить `plane_issue_id` в таблицу `tasks`
|
||||
|
||||
**Пример:**
|
||||
```python
|
||||
if new_stage == "analysis":
|
||||
run_id = launcher.launch("analyst", repo, task_desc, task_id=task_id)
|
||||
plane_sync.post_comment(plane_issue_id, "Analyst запущен (run_id={}). BRD/ТЗ/AC в работе.".format(run_id))
|
||||
```
|
||||
|
||||
### 3. Добавить Plane sync при запуске Analyst
|
||||
|
||||
**Файл:** `src/agents/launcher.py` (или `plane.py`)
|
||||
|
||||
**Что сделать:**
|
||||
- При старте Analyst автоматически создать комментарий в Plane:
|
||||
> "Analyst начал работу над BRD. Ожидайте результатов (8-15 мин)."
|
||||
|
||||
### 4. Добавить автоматический запрос `:approved:` после завершения Analyst
|
||||
|
||||
**Файл:** `src/webhooks/plane.py` + `plane_sync.py`
|
||||
|
||||
**Что сделать:**
|
||||
- После успешного завершения Analyst (exit_code=0) и наличия BRD/ТЗ/AC:
|
||||
- Автоматически создать комментарий в Plane:
|
||||
> "BRD/ТЗ/AC/TestPlan готовы. Прошу review и реакцию `:approved:` на подзадаче Анализ."
|
||||
- Обновить статус подзадачи Analysis → `in_review`
|
||||
|
||||
### 5. Автоматическое продвижение после `:approved:`
|
||||
|
||||
**Файл:** `src/webhooks/plane.py`
|
||||
|
||||
**Что сделать:**
|
||||
- При получении комментария с `:approved:` на тикет в стадии Analysis:
|
||||
- Проверить QG `check_analysis_approved`
|
||||
- Если проходит → `advance_stage(task_id, "analysis", "architecture")`
|
||||
- Запустить Architect: `launcher.launch("architect", repo, task_desc, task_id=task_id)`
|
||||
|
||||
### 6. Автоматический коммит документов Analyst'а в Gitea
|
||||
|
||||
**Файл:** `src/agents/launcher.py` (env для Analyst)
|
||||
|
||||
**Что сделать:**
|
||||
- Убедиться, что Analyst имеет доступ к git (HOME, GIT_AUTHOR_NAME/EMAIL)
|
||||
- Analyst должен автоматически коммитить документы в feature-ветку `docs/work-items/<id>/`
|
||||
- После коммита создать комментарий в Plane: "Документы закоммичены в `<branch>`."
|
||||
|
||||
### 7. Обновить документацию
|
||||
|
||||
**Файлы:**
|
||||
- `tasks/multi-agent/BRD.md` — добавить описание Analyst + Plane sync
|
||||
- `tasks/multi-agent/STATUS.md` — отметить интеграцию Analyst
|
||||
- `tasks/multi-agent/DEV_TASK_ANALYST_IN_ORCHESTRATOR.md` — связать с этой задачей
|
||||
|
||||
---
|
||||
|
||||
## Файлы для изменения
|
||||
|
||||
| Файл | Изменения | Приоритет |
|
||||
|------|-----------|-----------|
|
||||
| `src/agents/launcher.py` | Регистрация analyst + env + git commit | High |
|
||||
| `src/webhooks/plane.py` | Роутинг Analysis → analyst, post_comment на старте/approve | High |
|
||||
| `src/plane_sync.py` | (возможно) расширить для analyst | Medium |
|
||||
| `src/qg/checks.py` | Убедиться, что `check_analysis_approved` существует | Medium |
|
||||
| `tasks/multi-agent/BRD.md` | Документация Analyst + Plane sync | Low |
|
||||
| `tasks/multi-agent/STATUS.md` | Обновить статус | Low |
|
||||
|
||||
---
|
||||
|
||||
## Ограничения
|
||||
|
||||
- НЕ ломать существующий цикл (architect → developer → reviewer → tester)
|
||||
- Analyst НЕ пишет код (только документы)
|
||||
- Analyst всегда запрашивает `:approved:` перед закрытием Analysis
|
||||
- Все комментарии в Plane должны быть на русском (если Слава пишет на русском)
|
||||
|
||||
---
|
||||
|
||||
## Порядок выполнения
|
||||
|
||||
1. `launcher.py` (регистрация analyst + env)
|
||||
2. `plane.py` (роутинг + post_comment)
|
||||
3. QG + auto-advance после approve
|
||||
4. Документация
|
||||
5. Smoke test: создать тестовый тикет → Analyst запускается → пишет комментарий → запрашивает approve → Слава ставит `:approved:` → architecture
|
||||
|
||||
---
|
||||
|
||||
## Результат
|
||||
|
||||
После выполнения этой задачи:
|
||||
|
||||
- **Analyst полностью интегрирован** в конвейер Plane → Orchestrator
|
||||
- Создание тикета с переводом в Analysis → Analyst автоматически:
|
||||
- Запускается
|
||||
- Пишет комментарий в Plane ("Analyst начал работу...")
|
||||
- Коммитит документы в Gitea
|
||||
- Запрашивает `:approved:` через комментарий
|
||||
- Слава видит BRD в Plane и может согласовать без дополнительной коммуникации
|
||||
- **Все агенты** (architect, developer, reviewer, tester, analyst) работают по единому протоколу
|
||||
|
||||
---
|
||||
|
||||
## Команды проверки после деплоя
|
||||
|
||||
```bash
|
||||
# 1. Analyst в configs
|
||||
docker exec orchestrator python -c "
|
||||
from src.agents.launcher import launcher
|
||||
print('analyst config:', launcher.agent_configs.get('analyst'))
|
||||
"
|
||||
|
||||
# 2. Smoke: создать тестовый тикет в Analysis → проверить комментарий
|
||||
docker exec orchestrator python -c "
|
||||
import sqlite3
|
||||
conn = sqlite3.connect('/app/data/orchestrator.db')
|
||||
conn.row_factory = sqlite3.Row
|
||||
r = conn.execute('SELECT * FROM agent_runs WHERE agent=\"analyst\" ORDER BY id DESC LIMIT 1').fetchone()
|
||||
print(dict(r))
|
||||
"
|
||||
```
|
||||
Reference in New Issue
Block a user