@k0t0vich/meta-agents-template 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.1.5 - 2026-03-20
+
+### Changed
+- Removed legacy `codex/*` branch aliases from Git Flow Lite policy, docs, scripts, and CI branch validation.
+- Standardized branch task-ref naming for atomic work (`GOV-*`, `REL-*`, `DOC-*`, `DEV-*`) with `issue-<number>` fallback.
+- Updated branch-routing and status/review parsing so issue-based refs are handled consistently in `feature/issue-<n>-*` flows.
+
+## 0.1.4 - 2026-03-20
+
+### Added
+- `MR Review Agent` and mandatory pre-merge `RUN_MR_REVIEW_GATE` flow (`PASS_CANDIDATE -> PASS_CONFIRMED` after explicit user approval).
+- New MR review tooling: `meta:mr-review`, `meta:mr-review-approve`, and TrackerGateway command `RUN_MR_REVIEW_GATE`.
+- Branch-routing preflight command `meta:task-start` with route decision (`stay_on_current_branch` / `create_new_branch`).
+- Context-protection warning on branch switch when `agents.md` differs between current and base branch.
+- Git Flow Lite CI checks extended with e2e branch-routing scenarios (`same feature` and `different feature`).
+
+### Changed
+- Canonical command cycle now includes `PREPARE_TASK_BRANCH` and `RUN_MR_REVIEW_GATE` before merge.
+- Acceptance criteria strengthened with `branch_routing_e2e_verified` and `agents_context_consistency_verified`.
+- Status snapshot now includes branch context and task/branch alignment details.
+- Internal publishing guide now documents the full Git Flow Lite release path (`develop -> release/* -> main -> back-merge`).
+
 ## 0.1.3 - 2026-03-20
 
 ### Added

package/README.md

@@ -33,6 +33,9 @@ npx meta-agents init my-project
 ## Структура проекта после `init`
 ```text
 my-project/
+  .github/
+    workflows/
+      gitflow-lite-verify.yml
   package.json
   README.md
   agents.md
@@ -42,6 +45,7 @@ my-project/
       system.yaml
       roles.yaml
       trackers.yaml
+      project-context.yaml
     templates/
       prd-step.md
       agent-work-contract.md
@@ -55,17 +59,23 @@ my-project/
       verifier-designer.md
       decomposer.md
       reviewer-judge.md
+      mr-review-agent.md
       agile-manager.md
       publishing-agent.md
+      status-agent.md
     scripts/
       init.mjs
       sync-status.mjs
+      verify-branch-strategy.mjs
+      task-branch-router.mjs
+      run-mr-review-gate.mjs
       generate-prd-step.mjs
       tracker/
         local.mjs
         github.mjs
         mcp.mjs
         custom.mjs
+      tracker-gateway.mjs
   tasks/
     backlog.md
     sprint-1.md
@@ -75,17 +85,28 @@ my-project/
 ## Канонические команды
 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`
 
 `VERIFY_GOVERNANCE_GATE` выполняет `Governance Watchdog Agent` перед любой операцией и блокирует выполнение при нарушении PRD/acceptance/user-confirmation правил.
 `RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом:
 - сначала выводит summary выполненного, критические замечания, потенциальные риски и рекомендацию `PASS_CANDIDATE/FAIL`;
 - финальный `PASS_CONFIRMED` допускается только после явного `Review Approved: yes` от пользователя.
+`RUN_MR_REVIEW_GATE` выполняет `MR Review Agent` перед merge:
+- формирует сводный отчёт по MR/PR (task linkage, PRD evidence, риски, Git Flow target);
+- финальный `PASS_CONFIRMED` допускается только после явного `MR Review Approved: yes`.
+
+## Source of truth по tracker provider
+- Выбранный в `init` provider фиксируется в `.meta-agents/config/project-context.yaml`.
+- Значение обязано совпадать с `.meta-agents/config/trackers.yaml -> tracker_gateway.default`.
+- По умолчанию все операционные команды идут через этот provider, пока пользователь явно не изменит конфиг.
 
 ## Self-bootstrap (для этого репозитория)
 Чтобы сам шаблон работал по своим же правилам, запусти:
@@ -110,7 +131,9 @@ npm run self:bootstrap
 8. Перед каждой командой пройден watchdog gate (`VERIFY_GOVERNANCE_GATE`).
 9. Перед коммитом пройден review gate (`RUN_REVIEW_GATE`) с финальным `PASS_CONFIRMED`.
 10. Есть отдельное явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
-11. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
+11. Перед merge пройден MR review gate (`RUN_MR_REVIEW_GATE`) с финальным `PASS_CONFIRMED`.
+12. Есть отдельное явное подтверждение пользователя на MR review (`MR Review Approved: yes`).
+13. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
 
 Если хотя бы один пункт не выполнен, задача не принимается.
 
@@ -119,22 +142,42 @@ npm run self:bootstrap
 
 ```bash
 npm run meta:verify
+npm run meta:branch
+npm run meta:task-start -- --task GOV-1 --slug api-redirect
 npm run meta:review
 npm run meta:review-approve
+npm run meta:mr-review
+npm run meta:mr-review-approve
 npm run meta:verify-link
+npm run meta:ops -- --command SET_STATUS --payload '{"task":"DEV-12","status":"IN_PROGRESS"}'
+npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"GOV-1","slug":"api-redirect"}'
+npm run meta:status
 ```
 
+`meta:ops` принудительно проверяет tracker provider lock и блокирует выполнение, если переданный `--tracker` не совпадает с зафиксированным provider проекта.
+`meta:branch` валидирует ветку по Git Flow Lite (`main`, `develop`, `feature/*`, `release/*`, `hotfix/*`).
+`meta:task-start` делает branch-routing preflight: сравнивает задачу с текущей веткой, показывает dirty/ahead блокеры и готовит маршрут (`stay_on_current_branch` или `create_new_branch`).
+`meta:task-start` также делает context-protection check для `agents.md` между текущей и базовой веткой и требует явного подтверждения при diff.
+Именование branch task ref: по умолчанию использовать префиксные ID (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); для чистого GitHub issue fallback формат `issue-<number>`.
+`meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
+`meta:status` отдаёт единый статус-срез: trackers used, current sprint, current task, current branch context, git uncommitted и summary.
+В `github` режиме локальные `tasks/*` по умолчанию считаются cache/legacy и не являются источником истины.
+
 Она проверяет наличие обязательных PRD-блоков в задачах (`Описание`, `Проверяемость`, `Что сделано`) и валидирует базовую процессную дисциплину.
 
 ## Правило диалога пользователя
 Коммиты и закрытие задач выполняются только по явному подтверждению пользователя в текущем диалоге:
 - `COMMIT_BY_NAME` — только после подтверждения пользователя;
 - перевод задачи в `DONE` — только после подтверждения пользователя;
-- в single-branch режиме статусный цикл: `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- в режиме Git Flow Lite статусный цикл: `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
 - без подтверждения максимум статуса: `REVIEW`;
 - `READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
-- `READY` означает commit + push (в `main` или в ветку с открытым MR/PR);
-- `DONE` означает интеграцию в `main` (direct commit или merged MR/PR);
+- merge в целевую ветку разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED` и `MR Review Approved: yes`.
+- Git Flow Lite ветки: `feature/* -> develop`, `release/* -> main` + back-merge в `develop`, `hotfix/* -> main` + back-merge в `develop`;
+- веточный preflight для задач реализации: `meta:task-start` (проверка branch/task соответствия и диалог перед switch/create);
+- pre-merge gate для MR: `meta:mr-review`/`meta:mr-review-approve` (task linkage + PRD evidence + подтверждение пользователя);
+- `READY` означает commit + push в `feature/*|release/*|hotfix/*` и открытый PR в целевую ветку;
+- `DONE` означает интеграцию в `main` + back-merge в `develop` для release/hotfix;
 - `PUBLISH` означает, что релиз опубликован и доступен в latest.
 - для большой фичи (в режиме GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
 

package/agents.md

@@ -1,5 +1,12 @@
 # agents.md
 
+## 0) Профиль развернутого проекта (source of truth)
+- Project: `meta-agents-template`
+- Tracker provider (обязательный): `github`
+- Файл-источник: `.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,20 @@ 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`;
+- интеграционные правила: `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 +162,20 @@ 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. В названии рабочей ветки использовать task ref с префиксом (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); если есть только issue number, использовать `issue-<number>`.
+4. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
+5. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
+6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
+7. Переключиться на базовую ветку (`develop` или `main`) и обновить её.
+8. Создать новую рабочую ветку по Git Flow Lite.
+9. Перед переключением проверить консистентность `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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {

package/template/.github/workflows/gitflow-lite-verify.yml

@@ -0,0 +1,62 @@
+name: Git Flow Lite Verify
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+      - 'feature/**'
+      - 'release/**'
+      - 'hotfix/**'
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+
+      - name: Validate branch naming policy
+        shell: bash
+        run: |
+          BRANCH="${GITHUB_HEAD_REF:-${GITHUB_REF_NAME}}"
+          echo "Branch: $BRANCH"
+          if [[ "$BRANCH" =~ ^(main|develop|feature/.+|release/.+|hotfix/.+)$ ]]; then
+            echo "Branch naming PASS"
+          else
+            echo "Branch naming FAIL: '$BRANCH' is not Git Flow Lite compatible"
+            exit 1
+          fi
+
+      - name: Run governance and branch checks
+        run: |
+          npm run meta:branch
+          node --check .meta-agents/scripts/run-mr-review-gate.mjs
+          node --check .meta-agents/scripts/task-branch-router.mjs
+          npm run meta:verify
+          npm run meta:status -- --json
+          npm run meta:task-start -- --task GOV-101 --slug verify --json
+          git config user.name "Meta Agents CI"
+          git config user.email "meta-agents@example.com"
+
+      - name: Validate branch routing e2e scenarios
+        shell: bash
+        run: |
+          git add -A
+          git commit -m "ci: bootstrap routing check"
+          git branch develop
+          git checkout -b feature/gov-101-routing
+          node .meta-agents/scripts/task-branch-router.mjs --task GOV-101 --slug routing --json > /tmp/same-feature.json
+          node -e 'const fs=require("fs"); const d=JSON.parse(fs.readFileSync("/tmp/same-feature.json","utf8")); if (d.decision !== "stay_on_current_branch") { console.error("Expected stay_on_current_branch"); process.exit(1); }'
+          node .meta-agents/scripts/task-branch-router.mjs --task GOV-202 --slug routing --json > /tmp/cross-feature.json
+          node -e 'const fs=require("fs"); const d=JSON.parse(fs.readFileSync("/tmp/cross-feature.json","utf8")); if (d.decision !== "create_new_branch") { console.error("Expected create_new_branch"); process.exit(1); }'

package/template/.meta-agents/config/project-context.yaml

@@ -0,0 +1,7 @@
+project_context:
+  tracker_provider:
+    selected: "__DEFAULT_TRACKER__"
+    locked: true
+    required_for_all_commands: true
+    source_of_truth: true
+    change_policy: "update both project-context.yaml and trackers.yaml default in same change"

package/template/.meta-agents/config/roles.yaml

@@ -2,7 +2,7 @@ roles:
   - name: "Chief of Staff Agent"
     responsibility: "Оркестрация, блокеры, эскалации"
   - name: "Agile Manager Agent"
-    responsibility: "CREATE_TASK/SET_STATUS/COMMIT_BY_NAME/ASSIGN_SPRINT + epic/feature orchestration in GitHub tracker"
+    responsibility: "CREATE_TASK/PREPARE_TASK_BRANCH/SET_STATUS/COMMIT_BY_NAME/ASSIGN_SPRINT + epic/feature orchestration in GitHub tracker"
   - name: "Governance Watchdog Agent"
     responsibility: "Обязательный preflight-gate: PRD/acceptance/user confirmation policy"
   - name: "Product Manager Agent"
@@ -19,7 +19,11 @@ roles:
     responsibility: "Верификация и тестирование"
   - name: "Reviewer/Judge Agent"
     responsibility: "Независимая приёмка + обязательный pre-commit review gate"
+  - name: "MR Review Agent"
+    responsibility: "Обязательный pre-merge review gate: task linkage + PRD evidence + Git Flow target validation"
   - name: "Publishing Agent"
     responsibility: "Подготовка release notes, публикация релиза, перевод вошедших задач в PUBLISH"
   - name: "Documentation Agent"
     responsibility: "Синхронизация документации"
+  - name: "Status Agent"
+    responsibility: "Сводный статус по tracker/sprint/task/git + branch context (type/task-ref/alignment) с приоритетом источника по tracker provider"

package/template/.meta-agents/config/system.yaml

@@ -22,14 +22,55 @@ system:
       - skip
     offer_create_github_repo: true
   governance:
+    status_intent_router:
+      enabled: true
+      intent_keywords:
+        - "status"
+        - "статус"
+        - "что в процессе"
+        - "что в работе"
+        - "процесс"
+        - "где мы"
+      selected_agent: "Status Agent"
+      required_output_sections:
+        - trackers_used
+        - current_sprint
+        - current_task
+        - current_branch_context
+        - git_uncommitted
+        - summary
+      source_priority:
+        github:
+          - github_tracker
+          - local_tasks_cache
+        local:
+          - local_tasks
+        mcp:
+          - external_tracker
+          - local_tasks_cache
+        custom:
+          - external_tracker
+          - local_tasks_cache
+    tracker_selection:
+      explicit_provider_required: true
+      source_of_truth:
+        - ".meta-agents/config/project-context.yaml"
+        - ".meta-agents/config/trackers.yaml"
+      providers_allowed:
+        - github
+        - mcp
+        - local
+        - custom
+      require_provider_consistency: true
     user_confirmation_required_for:
       - review_gate_pass
+      - mr_review_gate_pass
       - commit
       - task_close_done
       - release_publish
     max_status_without_user_confirmation: REVIEW
     status_lifecycle:
-      mode: single_branch
+      mode: git_flow_lite
       sequence:
         - TODO
         - IN_PROGRESS
@@ -37,10 +78,68 @@ system:
         - READY
         - DONE
         - PUBLISH
+      git_flow_lite:
+        long_lived_branches:
+          - main
+          - develop
+        working_branches:
+          feature: "feature/<task-ref>-<slug>"
+          release: "release/vX.Y.Z"
+          hotfix: "hotfix/<task-ref>-<slug>"
+        task_ref_policy:
+          preferred_format:
+            - "GOV-<n>"
+            - "REL-<n>"
+            - "DOC-<n>"
+            - "DEV-<n>"
+          issue_fallback_format: "issue-<number>"
+        allowed_branch_patterns:
+          - "^main$"
+          - "^develop$"
+          - "^feature/.+"
+          - "^release/.+"
+          - "^hotfix/.+"
+        merge_rules:
+          - "feature/* -> develop"
+          - "release/* -> main and back-merge to develop"
+          - "hotfix/* -> main and back-merge to develop"
+      branch_routing_dialog:
+        required: true
+        required_before_commands:
+          - CREATE_TASK
+          - SET_STATUS
+          - COMMIT_BY_NAME
+        routing_command: "meta:task-start"
+        task_types:
+          atomic: "feature branch context (sub-task inside feature)"
+          feature: "dedicated feature branch from develop"
+          release: "release branch from develop"
+          hotfix: "hotfix branch from main"
+        stay_on_same_branch_when:
+          - current_branch_type_is_feature
+          - requested_task_matches_branch_task_ref
+          - user_confirmed_same_feature_execution
+        switch_branch_when:
+          - requested_task_does_not_match_branch_context
+          - current_branch_is_main_or_develop_for_implementation
+        blockers_require_user_resolution:
+          - working_tree_dirty
+          - current_branch_ahead
+        required_evidence:
+          - task_branch_router_same_feature_report
+          - task_branch_router_cross_feature_report
+          - agents_context_consistency_check
+        context_protection:
+          critical_file: "agents.md"
+          require_user_warning_on_diff: true
       rules:
+        - branch_routing_preflight_required
         - ready_only_after_review_pass_confirmed
+        - merge_only_after_mr_review_pass_confirmed
         - done_only_after_user_confirmation
         - publish_only_after_done
+        - no_direct_feature_commits_to_main
+        - release_and_hotfix_require_back_merge_to_develop
       github_status_labels:
         - TODO
         - IN_PROGRESS
@@ -50,8 +149,8 @@ system:
         - DONE
         - PUBLISH
       semantics:
-        READY: "Commit created and pushed; either main branch commit or feature branch with open MR/PR."
-        DONE: "Changes integrated to main (direct commit on main or MR/PR merged)."
+        READY: "Commit created and pushed on feature/release/hotfix branch with open PR (feature->develop, release/hotfix->main)."
+        DONE: "Changes integrated to main; for release/hotfix tasks back-merge from main to develop is confirmed."
         PUBLISH: "Released and available in latest published package version."
     epic_policy:
       github_only: true
@@ -66,8 +165,10 @@ system:
       before_commands:
         - VERIFY_GOVERNANCE_GATE
         - CREATE_TASK
+        - PREPARE_TASK_BRANCH
         - SET_STATUS
         - RUN_REVIEW_GATE
+        - RUN_MR_REVIEW_GATE
         - COMMIT_BY_NAME
         - ASSIGN_SPRINT
         - PREPARE_RELEASE_NOTE
@@ -91,6 +192,23 @@ system:
         - potential_risks
         - recommendation_pass_or_fail
       block_on_critical: true
+    mr_review_gate:
+      required_before_merge: true
+      command: RUN_MR_REVIEW_GATE
+      reporter_role: "MR Review Agent"
+      required_user_acknowledgement: true
+      recommendation_statuses:
+        - PASS_CANDIDATE
+        - FAIL
+      final_status: PASS_CONFIRMED
+      required_sections:
+        - mr_context
+        - task_linkage
+        - prd_evidence
+        - critical_findings
+        - potential_risks
+        - recommendation_pass_or_fail
+      block_on_critical: true
     commit_linkage:
       required: true
       accepted_patterns:
@@ -111,17 +229,25 @@ system:
       - human_approvals_passed
       - evidence_pack_complete
       - tracker_sync_complete
+      - branch_routing_dialog_completed
+      - branch_routing_e2e_verified
+      - agents_context_consistency_verified
       - watchdog_gate_passed
       - review_gate_passed
       - review_user_acknowledged
+      - mr_review_gate_passed
+      - mr_review_user_acknowledged
       - ready_has_commit_and_push
+      - ready_has_pr_to_expected_target_branch
       - done_integrated_to_main
+      - done_back_merged_to_develop_for_release_hotfix
       - release_changelog_updated
       - release_note_created
       - release_note_includes_tasks
       - release_tasks_marked_publish
       - publish_released_latest
       - commit_linked_to_issue
+      - tracker_provider_explicit_and_consistent
   auto_select:
     required: true
     before_each_task: true

package/template/.meta-agents/config/trackers.yaml

@@ -1,4 +1,5 @@
 tracker_gateway:
+  # Must match .meta-agents/config/project-context.yaml -> project_context.tracker_provider.selected
   default: "__DEFAULT_TRACKER__"
   providers:
     github:

package/template/.meta-agents/prompts/agile-manager.md

@@ -1,5 +1,27 @@
 Role: Agile Manager Agent
 Goal: управлять задачами и статусами через TrackerGateway.
 Commands: CREATE_TASK, SET_STATUS, COMMIT_BY_NAME, ASSIGN_SPRINT.
-Status semantics: READY = commit+push; DONE = integrated to main; PUBLISH = published in latest version.
+Status semantics: READY = commit+push on feature/release/hotfix + open PR; DONE = integrated to main + back-merge to develop (release/hotfix); PUBLISH = published in latest version.
+Git Flow Lite rule: использовать `feature/* -> develop`, `release/* -> main` + back-merge, `hotfix/* -> main` + back-merge.
 Rule: для большой фичи в GitHub tracker сначала предложить связку `feature issue` + `epic issue` и выделенную ветку.
+
+Branch routing protocol (обязателен для задач реализации):
+1. Сначала снять контекст: `npm run meta:status -- --json`.
+2. Проверить маршрут ветки: `npm run meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic`.
+3. Если `route=stay_on_current_branch`, задача считается атомарной внутри текущей feature-ветки.
+4. Если `route=create_new_branch`, перед началом реализации обязательно перейти на базовую ветку (`develop` для feature/release, `main` для hotfix), обновить её и создать новую рабочую ветку.
+5. Создание/переключение ветки выполнять только после явного подтверждения пользователя (`--apply`).
+
+Mandatory user dialogue before branch switch:
+- подтвердить текущую ветку и её тип;
+- подтвердить обработку незакоммиченных изменений (commit/stash/discard);
+- подтвердить обработку непушенных коммитов (`ahead > 0`);
+- подтвердить финальный switch/create.
+
+Task ref naming rule:
+- для веток использовать task ref с префиксом (`GOV-1`, `REL-5`, `DOC-2`, `DEV-12`);
+- если есть только номер issue, использовать fallback `issue-<number>` в имени ветки.
+
+Pre-merge rule:
+- после commit+push и открытия PR обязательно выполнить `RUN_MR_REVIEW_GATE`;
+- merge допускается только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED` и явного `MR Review Approved: yes` от пользователя.