TASK-0001 — протокол команды

Зачем эта задача

Проблема

Агенты работали в отдельных сессиях. Договорённости оставались в чатах, итог надо было собирать вручную, а ревью одного агента другим ничем не было оформлено.

Что хотели получить

история задач живёт в репозитории, а не только в GitHub;
у каждой задачи есть план, проверки и итог;
независимое ревью и Documentation Impact обязательны;
вы получаете короткую сводку, а не переписку агентов.

Чего задача не делает

Не запускает облачных агентов автоматически, не выдаёт токены, не подключает события GitHub и не меняет продукт AI Diary.

До и после

Вопрос	После PR

Путь задачи: машина состояний

Нажмите на состояние. Обведены те, в которые можно перейти дальше.

Возврат из reviewing в implementing — не больше двух автоматических циклов. Открытый PR ≠ completed.

Роли

Product Owner — вы

Ставите цель, утверждаете продуктовые и архитектурные решения, решаете споры агентов, разрешаете merge и deploy.

Planner / Architect

Claude или Codex. План, acceptance criteria, Documentation Impact, открытые неопределённости.

Developer

Обычно Claude Code Cloud. Ветка, код и документы, тесты, diff и логи.

Independent Reviewer

Обычно Codex Cloud. Получает исходную постановку и diff, а не самоотчёт разработчика. Автор не утверждает своё ревью.

QA

Роль, не обязательно отдельный агент: сверяет критерии с реальными результатами CI и тестов.

только описан

Orchestrator

Детерминированная автоматика: запускает роли, считает попытки и расходы. В этом PR не реализован — сейчас эту роль выполняете вы.

Обсуждения: отдельные треды → общий файл

Каждый смысловой вопрос задачи — отдельный файл в discussion/threads/. Файл discussion/00_all.md собирается скриптом, руками его не правят. CI проверяет, что сборка не устарела.

Пример ниже — синтетический: имитация на вымышленной задаче, не реальный вывод скрипта.

threads/

00_all.md (собран)

Команды

python3 scripts/agent-team/build_discussions.py --write
python3 scripts/agent-team/build_discussions.py --check

Формат шапки тредов совпадает с skills/discussion-threads/SKILL.md. Продуктовые решения по-прежнему идут через канонические треды в docs/baseline/; тред задачи на них только ссылается.

Что реально сделано, а что только описано

реализовано в PR

docs/agent-team/: правила, протокол, реестр задач, decisions;
шаблоны task.md, result.md, треда; шаблоны PR и Issue;
скрипт сборки 00_all.md с режимом --check и unit-тестами;
GitHub Actions: тесты и --check на каждый PR;
TASK-0001 — первая задача в новом формате, с шагами и временем;
AGENTS.md и тонкий CLAUDE.md ссылаются на общие правила.

только описано

автоматический запуск Claude Cloud и Codex Cloud;
маршрутизация событий GitHub к агентам;
синхронизация Issue ↔ файлы задачи;
очередь, учёт попыток и расходов;
автовозврат замечаний ревью разработчику.

Всё это — отдельные будущие задачи. Сейчас передачу между агентами делаете вы.

Проверки и шаги TASK-0001

CI — workflow «Agent-team documentation integrity»

Run	Коммит	Итог
#1 — 43766624892	`8540d69` первый вариант	success
#3 — 43767682324	`f52f994` после правок Claude	success
#8 — 43768679872	`c46d495` правило о презентации	success

Все 8 запусков на ветке до этого черновика зелёные. Запуск на коммите с этой презентацией смотрите в PR.

Шаги

Что нужно от вас

подтвердить

Два decision-файла

collaboration/decisions/0001-portable-history.md и orchestration/decisions/0001-documentation-gate.md написаны как «согласовано с Product Owner». Проверьте, что это действительно ваши решения.

дождаться

S6 и S7

Codex должен повторно проверить актуальный head PR и эту презентацию. Агенты пока сами друг друга не видят: попросите Codex об этом в его сессии.

при merge

Squash and merge

В ветке около 50 мелких коммитов. Squash оставит в master одну понятную запись.

Компромисс: презентации

Обязательная презентация для нетривиальных задач удобна для приёмки, но добавляет работу к каждой такой задаче и блокирует ready-for-human, пока её нет. Если окажется тяжело, порог «нетривиальности» можно поднять.