@k0t0vich/meta-agents-template 0.1.3 → 0.1.4

package/template/agents.md

@@ -1,5 +1,12 @@
 # agents.md
 
+## 0) Профиль развернутого проекта (source of truth)
+- Project: `__PROJECT_NAME__`
+- Tracker provider (обязательный): `__DEFAULT_TRACKER__`
+- Файл-источник: `.meta-agents/config/project-context.yaml`
+- Консистентность: значение обязано совпадать с `.meta-agents/config/trackers.yaml -> tracker_gateway.default`.
+- Операционное правило: если пользователь явно не изменил конфиг, все команды (`CREATE_TASK`, `SET_STATUS`, `ASSIGN_SPRINT`, `COMMIT_BY_NAME`, `PREPARE_RELEASE_NOTE`, `MARK_TASKS_PUBLISH`) выполняются только через выбранный tracker provider.
+
 ## 1) Назначение системы
 Система работает как мета-оркестрация разработки: сначала формализуем задачу и проверяемость, потом делаем реализацию.
 
@@ -21,6 +28,7 @@
 
 ## 3) Роли агентов
 - `Chief of Staff Agent`: оркестрация цепочки, приоритеты, блокеры, эскалации.
+- `Status Agent`: сводный статус проекта (`tracker/sprint/task/git`) по запросам состояния.
 - `Agile Manager Agent`: операции по задачам/спринтам/статусам/коммитам через трекер.
 - `Governance Watchdog Agent`: обязательный контроль PRD/критериев/разрешений перед каждой командой.
 - `Product Manager Agent`: формулирует PRD и критерии приёмки.
@@ -30,10 +38,27 @@
 - `Engineering Agent`: реализация по контракту.
 - `QA Agent`: проверка выполнения критериев и качество тестового покрытия.
 - `Reviewer/Judge Agent`: независимая приёмка по заранее согласованным правилам.
+- `MR Review Agent`: обязательный pre-merge review для MR/PR (task linkage + PRD evidence + Git Flow target).
 - `Publishing Agent`: готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
 - `Publishing Agent`: обновляет публичный `CHANGELOG.md`, готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
 - `Documentation Agent`: поддержка и синхронизация артефактов.
 
+## 3.1) Маршрутизация статус-запросов
+Если пользовательский запрос содержит intent `статус`, `что в процессе`, `процесс`, `где мы`, по умолчанию выбирается `Status Agent`.
+
+Формат ответа `Status Agent` (обязательный):
+1. Какие трекеры используются (locked provider + доступные providers).
+2. Какой текущий спринт.
+3. Какая задача сейчас в работе.
+4. Текущий веточный контекст (branch, branch type, branch task ref, alignment с текущей задачей).
+5. Что не закоммичено (modified/staged + untracked + ahead/behind).
+6. Короткая сводка.
+
+Приоритет источника данных:
+- `github`: GitHub tracker — источник истины; локальные `tasks/*` только cache/legacy.
+- `local`: локальные `tasks/*` — источник истины.
+- `mcp/custom`: внешний трекер — источник истины; локальные `tasks/*` только cache.
+
 ## 4) Жёсткий Auto-Select и показ имени агента
 Автовыбор агента обязателен перед каждой задачей и перед каждой командой (`CREATE_TASK`, `SET_STATUS`, `COMMIT_BY_NAME`, `ASSIGN_SPRINT`).
 
@@ -96,12 +121,15 @@ Name: <agent role>
 
 0. `VERIFY_GOVERNANCE_GATE`
 1. `CREATE_TASK`
-2. `SET_STATUS`
-3. `RUN_REVIEW_GATE`
-4. `COMMIT_BY_NAME`
-5. `ASSIGN_SPRINT`
-6. `PREPARE_RELEASE_NOTE`
-7. `MARK_TASKS_PUBLISH`
+2. `PREPARE_TASK_BRANCH`
+3. `SET_STATUS`
+4. `RUN_REVIEW_GATE`
+5. `COMMIT_BY_NAME`
+6. `RUN_MR_REVIEW_GATE`
+7. `ASSIGN_SPRINT`
+8. `PREPARE_RELEASE_NOTE`
+9. `MARK_TASKS_PUBLISH`
+10. `STATUS_SNAPSHOT`
 
 ## 10) Коммиты и закрытие задач: только по подтверждению пользователя
 Запрещено выполнять автоматически:
@@ -109,16 +137,21 @@ Name: <agent role>
 - перевод задачи в `DONE`.
 
 Обязательное правило:
-- для single-branch режима статусный цикл задачи фиксируется как `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- для режима `git_flow_lite` статусный цикл задачи фиксируется как `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- рабочие ветки: `feature/*`, `release/*`, `hotfix/*`; долгоживущие ветки: `develop`, `main`;
+- для агентных веток также допускаются `codex/feature/*`, `codex/release/*`, `codex/hotfix/*`;
+- интеграционные правила: `feature/* -> develop`, `release/* -> main` + back-merge в `develop`, `hotfix/* -> main` + back-merge в `develop`;
 - `RUN_REVIEW_GATE` сначала формирует отчёт ревьювера и рекомендацию (`PASS_CANDIDATE`/`FAIL`);
 - финальный `RUN_REVIEW_GATE: PASS_CONFIRMED` допускается только после явного подтверждения пользователя `Review Approved: yes`;
 - `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS_CONFIRMED` и отдельного явного подтверждения пользователя в текущем диалоге;
+- merge в целевую ветку выполняется только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED` и явного подтверждения пользователя `MR Review Approved: yes`;
 - `SET_STATUS -> DONE` выполняется только после явного подтверждения пользователя в текущем диалоге;
 - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
 - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+- для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
 - сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
-- `READY` означает: коммит сделан и отправлен (`push`), при этом либо в `main`, либо в отдельной ветке с открытым MR/PR.
-- `DONE` означает: изменения интегрированы в `main` (прямой коммит в `main` или MR/PR смержен).
+- `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
+- `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
 
 ## 10.1) Правило для больших фич (GitHub tracker)
@@ -130,6 +163,19 @@ Name: <agent role>
 
 Для текущего этапа (только GitHub tracker) epic реализуется как обычный issue с label `type:epic`.
 
+## 10.2) Обязательная маршрутизация ветки для Agile Manager Agent
+Перед началом реализации агент обязан:
+1. Проверить веточный контекст через `meta:status`.
+2. Запустить branch-routing preflight через `meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
+3. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
+4. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
+5. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
+6. Переключиться на базовую ветку (`develop` или `main`) и обновить её.
+7. Создать новую рабочую ветку по Git Flow Lite.
+8. Перед переключением проверить консистентность `agents.md` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
+
+Без этого preflight выполнение реализации запрещено.
+
 ## 11) Жёсткие критерии приёмки (все обязательны)
 Задача принимается только если одновременно выполнены все условия:
 1. Заполнены все PRD-блоки этапа: `Описание`, `Проверяемость`, `Что сделано`.
@@ -144,13 +190,18 @@ Name: <agent role>
 10. Перед каждой командой пройден `VERIFY_GOVERNANCE_GATE` от `Governance Watchdog Agent`.
 11. Перед коммитом пройден `RUN_REVIEW_GATE` от `Reviewer/Judge Agent`.
 12. Есть явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
-13. До review gate задача переведена в статус `REVIEW`.
-14. Статус `READY` выставлен только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
-15. Для статуса `READY` подтверждены `commit + push` и путь интеграции (`main` или открытый MR/PR).
-16. Для статуса `DONE` подтверждена интеграция в `main` (direct commit или merged MR/PR).
-17. Для статуса `PUBLISH` подтверждена публикация в последней версии.
-18. Для релиза обновлён публичный `CHANGELOG.md`.
-19. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+13. Перед merge пройден `RUN_MR_REVIEW_GATE` от `MR Review Agent`.
+14. Есть явное подтверждение пользователя на MR review (`MR Review Approved: yes`).
+15. До review gate задача переведена в статус `REVIEW`.
+16. Статус `READY` выставлен только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+17. Для статуса `READY` подтверждены `commit + push` в `feature/*|release/*|hotfix/*` и открытый PR в целевую ветку (`develop` или `main`).
+18. Для merge подтверждён `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`.
+19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
+20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
+21. Для релиза обновлён публичный `CHANGELOG.md`.
+22. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
+24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
 
 Если хотя бы один критерий не выполнен, задача не принимается.
 

package/template/package.json

@@ -4,9 +4,14 @@
   "private": true,
   "scripts": {
     "meta:status": "node .meta-agents/scripts/sync-status.mjs",
+    "meta:branch": "node .meta-agents/scripts/verify-branch-strategy.mjs",
+    "meta:task-start": "node .meta-agents/scripts/task-branch-router.mjs",
     "meta:verify": "node .meta-agents/scripts/verify-governance.mjs",
     "meta:review": "node .meta-agents/scripts/run-review-gate.mjs",
     "meta:review-approve": "node .meta-agents/scripts/run-review-gate.mjs --approve yes",
-    "meta:verify-link": "node .meta-agents/scripts/verify-commit-link.mjs"
+    "meta:mr-review": "node .meta-agents/scripts/run-mr-review-gate.mjs",
+    "meta:mr-review-approve": "node .meta-agents/scripts/run-mr-review-gate.mjs --approve yes",
+    "meta:verify-link": "node .meta-agents/scripts/verify-commit-link.mjs",
+    "meta:ops": "node .meta-agents/scripts/tracker-gateway.mjs"
   }
 }

package/template/tracker-command-template.md

@@ -33,20 +33,41 @@ result PASS
 
 Если `result != PASS`, команда не выполняется.
 
+## 0.2) Зафиксированный tracker provider проекта
+- Текущий provider: `__DEFAULT_TRACKER__`.
+- Source of truth:
+  - `.meta-agents/config/project-context.yaml -> project_context.tracker_provider.selected`
+  - `.meta-agents/config/trackers.yaml -> tracker_gateway.default`
+- Если пользователь явно не запросил смену provider и конфиг не обновлён, команды выполняются только через `__DEFAULT_TRACKER__`.
+- CLI enforcement: `npm run meta:ops -- --command <COMMAND> [--tracker ...]` блокирует выполнение при mismatch provider.
+
 ## 1) Ключевое правило подтверждения пользователя
 Только по явному подтверждению пользователя в текущем диалоге разрешены:
 - `COMMIT_BY_NAME`;
+- merge после `RUN_MR_REVIEW_GATE`;
 - перевод задачи в `DONE`.
 
 Без подтверждения пользователя можно переводить задачу максимум в `REVIEW`.
 `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 
 Дополнительно для коммита:
-- для single-branch режима используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- для `git_flow_lite` используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- рабочие ветки: `feature/*`, `release/*`, `hotfix/*`; долгоживущие ветки: `develop`, `main`;
+- для агентных веток допускаются `codex/feature/*`, `codex/release/*`, `codex/hotfix/*`;
+- правила merge: `feature/* -> develop`, `release/* -> main` + back-merge в `develop`, `hotfix/* -> main` + back-merge в `develop`;
 - `RUN_REVIEW_GATE` работает в два этапа:
   - сначала отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
   - после явного подтверждения пользователя (`Review Approved: yes`) — финальный `PASS_CONFIRMED`;
+- `RUN_MR_REVIEW_GATE` работает в два этапа:
+  - сначала сводный MR-отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
+  - после явного подтверждения пользователя (`MR Review Approved: yes`) — финальный `PASS_CONFIRMED`;
 - `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`;
+- merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
+- для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
+- перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
+- если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
+- если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
+- перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
 - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
 
 Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
@@ -59,8 +80,8 @@ result PASS
 - `PUBLISH`
 
 Семантика статусов:
-- `READY`: коммит сделан и отправлен (`push`), изменения находятся либо в `main`, либо в отдельной ветке с открытым MR/PR.
-- `DONE`: изменения интегрированы в `main` (direct commit в `main` или MR/PR смержен).
+- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*` (или `codex/*` эквиваленты); открыт PR в `develop` или `main` согласно правилам ветвления.
+- `DONE`: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
 
 Правило больших фич (GitHub tracker):
@@ -68,7 +89,7 @@ result PASS
 - epic в GitHub оформляется как issue с label `type:epic`;
 - feature оформляется как issue с label `type:feature` и ссылкой на epic.
 
-## 2) Канонические команды (через Agile Manager Agent / Publishing Agent)
+## 2) Канонические команды (через Agile Manager Agent / Reviewer/Judge Agent / MR Review Agent / Publishing Agent / Status Agent)
 ### VERIFY_GOVERNANCE_GATE
 ```text
 [Agent Auto-Select]
@@ -127,7 +148,7 @@ Reason: Нужна операция создания задачи в треке
 Name: Agile Manager Agent
 
 Agile Manager Agent: create task,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 repo your-org/your-repo,
 short name "API редирект офферов",
 owner "Engineering Agent",
@@ -146,12 +167,29 @@ Reason: Нужна операция смены статуса задачи.
 Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task DEV-12,
 status IN_PROGRESS,
 reason "начата реализация"
 ```
 
+### PREPARE_TASK_BRANCH (обязателен перед реализацией)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Нужно проверить соответствие задачи текущей ветке и выбрать корректный Git Flow маршрут.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: prepare task branch,
+tracker __DEFAULT_TRACKER__,
+task "#12",
+task kind "atomic",
+command "npm run meta:task-start -- --task 12 --slug api-redirect",
+user dialogue "confirm branch context + dirty/ahead handling + agents.md context warning + switch decision"
+```
+
 ### SET_STATUS -> REVIEW (обязателен перед review gate)
 ```text
 [Agent Auto-Select]
@@ -162,7 +200,7 @@ Reason: Реализация завершена, задача передаётс
 Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task DEV-12,
 status REVIEW,
 reason "готово к review gate"
@@ -178,9 +216,9 @@ Reason: Большая фича требует эпик в GitHub-трекере
 Name: Agile Manager Agent
 
 Agile Manager Agent: create task,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 type epic,
-labels "type:epic,tracker:github,sprint:SPRINT-3",
+labels "type:epic,tracker:__DEFAULT_TRACKER__,sprint:SPRINT-3",
 short name "EPIC: новый подбор офферов",
 description "Родительская задача для крупной фичи"
 ```
@@ -195,9 +233,9 @@ Reason: Нужна отдельная feature-задача, связанная
 Name: Agile Manager Agent
 
 Agile Manager Agent: create task,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 type feature,
-labels "type:feature,tracker:github,sprint:SPRINT-3",
+labels "type:feature,tracker:__DEFAULT_TRACKER__,sprint:SPRINT-3",
 short name "FEATURE: scoring pipeline v2",
 description "Дочерняя feature в рамках epic #42",
 link to epic "#42"
@@ -216,7 +254,7 @@ Name: Agile Manager Agent
 Commit Approved: yes
 
 Agile Manager Agent: commit by name,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task "API редирект офферов",
 issue 12,
 commit message "DEV-12 | API редирект офферов (#12)",
@@ -227,6 +265,40 @@ target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
 ```
 
+### RUN_MR_REVIEW_GATE (обязателен перед merge)
+```text
+[Agent Auto-Select]
+Selected: MR Review Agent
+Reason: Нужен обязательный pre-merge review по MR/PR с проверкой task linkage и PRD evidence.
+
+[Task Agent]
+Name: MR Review Agent
+
+MR Review Agent: run MR review gate,
+task DEV-12,
+pr 34,
+checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
+result PASS_CANDIDATE
+```
+
+```text
+[User Confirmation]
+MR Review Approved: yes
+
+[Agent Auto-Select]
+Selected: MR Review Agent
+Reason: Подтверждение MR review пользователем получено, фиксируем финальный результат.
+
+[Task Agent]
+Name: MR Review Agent
+
+MR Review Agent: run MR review gate,
+task DEV-12,
+pr 34,
+approve yes,
+result PASS_CONFIRMED
+```
+
 ### SET_STATUS -> PUBLISH (после фактической публикации)
 ```text
 [Agent Auto-Select]
@@ -237,7 +309,7 @@ Reason: Публикация релиза завершена, фиксируем
 Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task DEV-12,
 status PUBLISH,
 reason "релиз опубликован в latest"
@@ -256,7 +328,7 @@ Name: Agile Manager Agent
 Close Task Approved: yes
 
 Agile Manager Agent: set status,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task DEV-12,
 status DONE,
 reason "пользователь подтвердил закрытие"
@@ -272,11 +344,27 @@ Reason: Нужна операция назначения задачи в спр
 Name: Agile Manager Agent
 
 Agile Manager Agent: assign sprint,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 task DEV-12,
 sprint SPRINT-3
 ```
 
+### STATUS_SNAPSHOT
+```text
+[Agent Auto-Select]
+Selected: Status Agent
+Reason: Пользователь запросил текущий статус проекта/процесса.
+
+[Task Agent]
+Name: Status Agent
+
+Status Agent: status snapshot,
+tracker __DEFAULT_TRACKER__,
+source policy "github/mcp/custom -> external tracker first, local -> tasks first",
+include "trackers_used,current_sprint,current_task,current_branch_context,git_uncommitted,summary",
+command "npm run meta:status"
+```
+
 ### PREPARE_RELEASE_NOTE
 ```text
 [Agent Auto-Select]
@@ -287,7 +375,7 @@ Reason: Нужно зафиксировать состав релиза и за
 Name: Publishing Agent
 
 Publishing Agent: prepare release note,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 version v0.1.2,
 included tasks "#2,#3,#4,#5,#6,#7,#8",
 changelog "CHANGELOG.md updated for v0.1.2",
@@ -304,7 +392,7 @@ Reason: После релиза нужно перевести вошедшие
 Name: Publishing Agent
 
 Publishing Agent: mark tasks publish,
-tracker github,
+tracker __DEFAULT_TRACKER__,
 tasks "#2,#3,#4,#5,#6,#7,#8",
 status PUBLISH,
 reason "вошло в релиз v0.1.2"
@@ -332,14 +420,20 @@ reason "вошло в релиз v0.1.2"
 ## 4) Минимальный операционный цикл
 1. `VERIFY_GOVERNANCE_GATE`.
 2. `CREATE_TASK`.
-3. `SET_STATUS -> IN_PROGRESS`.
-4. Реализация + evidence.
-5. `SET_STATUS -> REVIEW`.
-6. `RUN_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
-7. Пользователь подтверждает review (`Review Approved: yes`).
-8. `RUN_REVIEW_GATE` -> `PASS_CONFIRMED`.
-9. `COMMIT_BY_NAME` только после review PASS_CONFIRMED и отдельного подтверждения пользователя на коммит.
-10. `SET_STATUS -> READY`.
-11. `SET_STATUS -> DONE` только после подтверждения пользователя.
-12. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
-13. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).
+3. `PREPARE_TASK_BRANCH`.
+4. `SET_STATUS -> IN_PROGRESS`.
+5. Реализация + evidence.
+6. `SET_STATUS -> REVIEW`.
+7. `RUN_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
+8. Пользователь подтверждает review (`Review Approved: yes`).
+9. `RUN_REVIEW_GATE` -> `PASS_CONFIRMED`.
+10. `COMMIT_BY_NAME` только после review PASS_CONFIRMED и отдельного подтверждения пользователя на коммит.
+11. Push + open PR в целевую ветку по Git Flow Lite.
+12. `RUN_MR_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
+13. Пользователь подтверждает MR review (`MR Review Approved: yes`).
+14. `RUN_MR_REVIEW_GATE` -> `PASS_CONFIRMED`.
+15. Merge PR по Git Flow Lite.
+16. `SET_STATUS -> READY`.
+17. `SET_STATUS -> DONE` только после подтверждения пользователя.
+18. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
+19. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).

package/tracker-command-template.md

@@ -33,20 +33,41 @@ result PASS
 
 Если `result != PASS`, команда не выполняется.
 
+## 0.2) Зафиксированный tracker provider проекта
+- Текущий provider: `github`.
+- Source of truth:
+  - `.meta-agents/config/project-context.yaml -> project_context.tracker_provider.selected`
+  - `.meta-agents/config/trackers.yaml -> tracker_gateway.default`
+- Если пользователь явно не запросил смену provider и конфиг не обновлён, команды выполняются только через `github`.
+- CLI enforcement: `npm run meta:ops -- --command <COMMAND> [--tracker ...]` блокирует выполнение при mismatch provider.
+
 ## 1) Ключевое правило подтверждения пользователя
 Только по явному подтверждению пользователя в текущем диалоге разрешены:
 - `COMMIT_BY_NAME`;
+- merge после `RUN_MR_REVIEW_GATE`;
 - перевод задачи в `DONE`.
 
 Без подтверждения пользователя можно переводить задачу максимум в `REVIEW`.
 `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 
 Дополнительно для коммита:
-- для single-branch режима используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- для `git_flow_lite` используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- рабочие ветки: `feature/*`, `release/*`, `hotfix/*`; долгоживущие ветки: `develop`, `main`;
+- для агентных веток допускаются `codex/feature/*`, `codex/release/*`, `codex/hotfix/*`;
+- правила merge: `feature/* -> develop`, `release/* -> main` + back-merge в `develop`, `hotfix/* -> main` + back-merge в `develop`;
 - `RUN_REVIEW_GATE` работает в два этапа:
   - сначала отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
   - после явного подтверждения пользователя (`Review Approved: yes`) — финальный `PASS_CONFIRMED`;
+- `RUN_MR_REVIEW_GATE` работает в два этапа:
+  - сначала сводный MR-отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
+  - после явного подтверждения пользователя (`MR Review Approved: yes`) — финальный `PASS_CONFIRMED`;
 - `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`;
+- merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
+- для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
+- перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
+- если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
+- если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
+- перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
 - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
 
 Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
@@ -59,8 +80,8 @@ result PASS
 - `PUBLISH`
 
 Семантика статусов:
-- `READY`: коммит сделан и отправлен (`push`), изменения находятся либо в `main`, либо в отдельной ветке с открытым MR/PR.
-- `DONE`: изменения интегрированы в `main` (direct commit в `main` или MR/PR смержен).
+- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*` (или `codex/*` эквиваленты); открыт PR в `develop` или `main` согласно правилам ветвления.
+- `DONE`: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
 
 Правило больших фич (GitHub tracker):
@@ -68,7 +89,7 @@ result PASS
 - epic в GitHub оформляется как issue с label `type:epic`;
 - feature оформляется как issue с label `type:feature` и ссылкой на epic.
 
-## 2) Канонические команды (через Agile Manager Agent / Publishing Agent)
+## 2) Канонические команды (через Agile Manager Agent / Reviewer/Judge Agent / MR Review Agent / Publishing Agent / Status Agent)
 ### VERIFY_GOVERNANCE_GATE
 ```text
 [Agent Auto-Select]
@@ -152,6 +173,23 @@ status IN_PROGRESS,
 reason "начата реализация"
 ```
 
+### PREPARE_TASK_BRANCH (обязателен перед реализацией)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Нужно проверить соответствие задачи текущей ветке и выбрать корректный Git Flow маршрут.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: prepare task branch,
+tracker github,
+task "#12",
+task kind "atomic",
+command "npm run meta:task-start -- --task 12 --slug api-redirect",
+user dialogue "confirm branch context + dirty/ahead handling + agents.md context warning + switch decision"
+```
+
 ### SET_STATUS -> REVIEW (обязателен перед review gate)
 ```text
 [Agent Auto-Select]
@@ -227,6 +265,40 @@ target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
 ```
 
+### RUN_MR_REVIEW_GATE (обязателен перед merge)
+```text
+[Agent Auto-Select]
+Selected: MR Review Agent
+Reason: Нужен обязательный pre-merge review по MR/PR с проверкой task linkage и PRD evidence.
+
+[Task Agent]
+Name: MR Review Agent
+
+MR Review Agent: run MR review gate,
+task DEV-12,
+pr 34,
+checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
+result PASS_CANDIDATE
+```
+
+```text
+[User Confirmation]
+MR Review Approved: yes
+
+[Agent Auto-Select]
+Selected: MR Review Agent
+Reason: Подтверждение MR review пользователем получено, фиксируем финальный результат.
+
+[Task Agent]
+Name: MR Review Agent
+
+MR Review Agent: run MR review gate,
+task DEV-12,
+pr 34,
+approve yes,
+result PASS_CONFIRMED
+```
+
 ### SET_STATUS -> PUBLISH (после фактической публикации)
 ```text
 [Agent Auto-Select]
@@ -277,6 +349,22 @@ task DEV-12,
 sprint SPRINT-3
 ```
 
+### STATUS_SNAPSHOT
+```text
+[Agent Auto-Select]
+Selected: Status Agent
+Reason: Пользователь запросил текущий статус проекта/процесса.
+
+[Task Agent]
+Name: Status Agent
+
+Status Agent: status snapshot,
+tracker github,
+source policy "github/mcp/custom -> external tracker first, local -> tasks first",
+include "trackers_used,current_sprint,current_task,current_branch_context,git_uncommitted,summary",
+command "node .meta-agents/scripts/sync-status.mjs"
+```
+
 ### PREPARE_RELEASE_NOTE
 ```text
 [Agent Auto-Select]
@@ -332,14 +420,20 @@ reason "вошло в релиз v0.1.2"
 ## 4) Минимальный операционный цикл
 1. `VERIFY_GOVERNANCE_GATE`.
 2. `CREATE_TASK`.
-3. `SET_STATUS -> IN_PROGRESS`.
-4. Реализация + evidence.
-5. `SET_STATUS -> REVIEW`.
-6. `RUN_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
-7. Пользователь подтверждает review (`Review Approved: yes`).
-8. `RUN_REVIEW_GATE` -> `PASS_CONFIRMED`.
-9. `COMMIT_BY_NAME` только после review PASS_CONFIRMED и отдельного подтверждения пользователя на коммит.
-10. `SET_STATUS -> READY`.
-11. `SET_STATUS -> DONE` только после подтверждения пользователя.
-12. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
-13. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).
+3. `PREPARE_TASK_BRANCH`.
+4. `SET_STATUS -> IN_PROGRESS`.
+5. Реализация + evidence.
+6. `SET_STATUS -> REVIEW`.
+7. `RUN_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
+8. Пользователь подтверждает review (`Review Approved: yes`).
+9. `RUN_REVIEW_GATE` -> `PASS_CONFIRMED`.
+10. `COMMIT_BY_NAME` только после review PASS_CONFIRMED и отдельного подтверждения пользователя на коммит.
+11. Push + open PR в целевую ветку по Git Flow Lite.
+12. `RUN_MR_REVIEW_GATE` (получить report + `PASS_CANDIDATE`/`FAIL`).
+13. Пользователь подтверждает MR review (`MR Review Approved: yes`).
+14. `RUN_MR_REVIEW_GATE` -> `PASS_CONFIRMED`.
+15. Merge PR по Git Flow Lite.
+16. `SET_STATUS -> READY`.
+17. `SET_STATUS -> DONE` только после подтверждения пользователя.
+18. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
+19. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).