@k0t0vich/meta-agents-template 0.1.2 → 0.1.4

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)
+## 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,55 @@ 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]
+Selected: Publishing Agent
+Reason: Нужно зафиксировать состав релиза и задачи, вошедшие в поставку.
+
+[Task Agent]
+Name: Publishing Agent
+
+Publishing Agent: prepare release note,
+tracker github,
+version v0.1.2,
+included tasks "#2,#3,#4,#5,#6,#7,#8",
+changelog "CHANGELOG.md updated for v0.1.2",
+output "docs/internal/release-notes/v0.1.2.md"
+```
+
+### MARK_TASKS_PUBLISH
+```text
+[Agent Auto-Select]
+Selected: Publishing Agent
+Reason: После релиза нужно перевести вошедшие задачи в статус PUBLISH.
+
+[Task Agent]
+Name: Publishing Agent
+
+Publishing Agent: mark tasks publish,
+tracker github,
+tasks "#2,#3,#4,#5,#6,#7,#8",
+status PUBLISH,
+reason "вошло в релиз v0.1.2"
+```
+
 ## 3) PRD-блок для каждого шага (обязателен)
 ```markdown
 ## PRD Step: <stage-name>
@@ -299,13 +420,20 @@ sprint SPRINT-3
 ## 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. Для релизных задач после публикации: `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` для всех вошедших задач).