@k0t0vich/meta-agents-template 0.1.1 → 0.1.2

package/README.md

@@ -56,6 +56,7 @@ my-project/
       decomposer.md
       reviewer-judge.md
       agile-manager.md
+      publishing-agent.md
     scripts/
       init.mjs
       sync-status.mjs
@@ -78,9 +79,13 @@ my-project/
 3. `RUN_REVIEW_GATE`
 4. `COMMIT_BY_NAME`
 5. `ASSIGN_SPRINT`
+6. `PREPARE_RELEASE_NOTE`
+7. `MARK_TASKS_PUBLISH`
 
 `VERIFY_GOVERNANCE_GATE` выполняет `Governance Watchdog Agent` перед любой операцией и блокирует выполнение при нарушении PRD/acceptance/user-confirmation правил.
-`RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом: выводит summary выполненного, критические замечания, потенциальные риски и итог `PASS/FAIL`.
+`RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом:
+- сначала выводит summary выполненного, критические замечания, потенциальные риски и рекомендацию `PASS_CANDIDATE/FAIL`;
+- финальный `PASS_CONFIRMED` допускается только после явного `Review Approved: yes` от пользователя.
 
 ## Self-bootstrap (для этого репозитория)
 Чтобы сам шаблон работал по своим же правилам, запусти:
@@ -103,8 +108,9 @@ npm run self:bootstrap
 6. Собран полный evidence-пакет.
 7. Синхронизированы `task/status/sprint` в трекере.
 8. Перед каждой командой пройден watchdog gate (`VERIFY_GOVERNANCE_GATE`).
-9. Перед коммитом пройден review gate (`RUN_REVIEW_GATE`).
-10. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
+9. Перед коммитом пройден review gate (`RUN_REVIEW_GATE`) с финальным `PASS_CONFIRMED`.
+10. Есть отдельное явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
+11. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
 
 Если хотя бы один пункт не выполнен, задача не принимается.
 
@@ -114,6 +120,7 @@ npm run self:bootstrap
 ```bash
 npm run meta:verify
 npm run meta:review
+npm run meta:review-approve
 npm run meta:verify-link
 ```
 
@@ -123,7 +130,13 @@ npm run meta:verify-link
 Коммиты и закрытие задач выполняются только по явному подтверждению пользователя в текущем диалоге:
 - `COMMIT_BY_NAME` — только после подтверждения пользователя;
 - перевод задачи в `DONE` — только после подтверждения пользователя;
-- без подтверждения максимум статуса: `READY`.
+- в single-branch режиме статусный цикл: `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);
+- `PUBLISH` означает, что релиз опубликован и доступен в latest.
+- для большой фичи (в режиме GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
 
 ## Основные документы шаблона
 - [agents.md](./agents.md)

package/agents.md

@@ -105,10 +105,26 @@ Name: <agent role>
 - перевод задачи в `DONE`.
 
 Обязательное правило:
-- `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS` и явного подтверждения пользователя в текущем диалоге;
+- для single-branch режима статусный цикл задачи фиксируется как `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- `RUN_REVIEW_GATE` сначала формирует отчёт ревьювера и рекомендацию (`PASS_CANDIDATE`/`FAIL`);
+- финальный `RUN_REVIEW_GATE: PASS_CONFIRMED` допускается только после явного подтверждения пользователя `Review Approved: yes`;
+- `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS_CONFIRMED` и отдельного явного подтверждения пользователя в текущем диалоге;
 - `SET_STATUS -> DONE` выполняется только после явного подтверждения пользователя в текущем диалоге;
-- без подтверждения пользователя максимум допустимого статуса: `READY`.
+- без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
+- `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 - сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
+- `READY` означает: коммит сделан и отправлен (`push`), при этом либо в `main`, либо в отдельной ветке с открытым MR/PR.
+- `DONE` означает: изменения интегрированы в `main` (прямой коммит в `main` или MR/PR смержен).
+- `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
+
+## 10.1) Правило для больших фич (GitHub tracker)
+Если задача классифицирована как большая фича, система обязана предложить:
+- создать `feature issue` (`type:feature`);
+- создать `epic issue` (`type:epic`);
+- выделить отдельную ветку разработки;
+- связать feature с epic в GitHub issue (ссылка в body/comment/task list).
+
+Для текущего этапа (только GitHub tracker) epic реализуется как обычный issue с label `type:epic`.
 
 ## 11) Жёсткие критерии приёмки (все обязательны)
 Задача принимается только если одновременно выполнены все условия:
@@ -123,7 +139,13 @@ Name: <agent role>
 9. Если задача закрыта в `DONE`, есть явное подтверждение пользователя на закрытие.
 10. Перед каждой командой пройден `VERIFY_GOVERNANCE_GATE` от `Governance Watchdog Agent`.
 11. Перед коммитом пройден `RUN_REVIEW_GATE` от `Reviewer/Judge Agent`.
-12. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+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. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
 
 Если хотя бы один критерий не выполнен, задача не принимается.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "scripts": {
     "start": "node bin/meta-agents.js --help",
     "self:sync": "node bin/meta-agents.js sync . --force",
-    "self:bootstrap": "npm run self:sync && node scripts/self-bootstrap.mjs"
+    "self:bootstrap": "npm run self:sync && node scripts/self-bootstrap.mjs",
+    "release:smoke-local": "node scripts/post-publish-local-smoke.mjs"
   },
   "files": [
     "README.md",

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"
+    responsibility: "CREATE_TASK/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,5 +19,7 @@ roles:
     responsibility: "Верификация и тестирование"
   - name: "Reviewer/Judge Agent"
     responsibility: "Независимая приёмка + обязательный pre-commit review gate"
+  - name: "Publishing Agent"
+    responsibility: "Подготовка release notes, публикация релиза, перевод вошедших задач в PUBLISH"
   - name: "Documentation Agent"
     responsibility: "Синхронизация документации"

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

@@ -23,9 +23,44 @@ system:
     offer_create_github_repo: true
   governance:
     user_confirmation_required_for:
+      - review_gate_pass
       - commit
       - task_close_done
-    max_status_without_user_confirmation: READY
+      - release_publish
+    max_status_without_user_confirmation: REVIEW
+    status_lifecycle:
+      mode: single_branch
+      sequence:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - DONE
+        - PUBLISH
+      rules:
+        - ready_only_after_review_pass_confirmed
+        - done_only_after_user_confirmation
+        - publish_only_after_done
+      github_status_labels:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - BLOCKED
+        - 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)."
+        PUBLISH: "Released and available in latest published package version."
+    epic_policy:
+      github_only: true
+      large_feature_requires_epic: true
+      required_actions:
+        - propose_feature_issue
+        - propose_epic_issue
+        - create_dedicated_branch
+        - link_feature_to_epic
     watchdog:
       required: true
       before_commands:
@@ -35,6 +70,8 @@ system:
         - RUN_REVIEW_GATE
         - COMMIT_BY_NAME
         - ASSIGN_SPRINT
+        - PREPARE_RELEASE_NOTE
+        - MARK_TASKS_PUBLISH
       minimum_checks:
         - prd_sections_complete
         - acceptance_criteria_defined
@@ -43,6 +80,11 @@ system:
       required_before_commit: true
       command: RUN_REVIEW_GATE
       reporter_role: "Reviewer/Judge Agent"
+      required_user_acknowledgement: true
+      recommendation_statuses:
+        - PASS_CANDIDATE
+        - FAIL
+      final_status: PASS_CONFIRMED
       required_sections:
         - what_done_summary
         - critical_findings
@@ -54,6 +96,11 @@ system:
       accepted_patterns:
         - "TASK-ID"
         - "#issue"
+    publish_flow:
+      release_note_required: true
+      release_note_must_include_tasks: true
+      mark_included_tasks_publish: true
+      publish_status_label: PUBLISH
   acceptance:
     hard_criteria:
       - prd_sections_complete
@@ -65,6 +112,13 @@ system:
       - tracker_sync_complete
       - watchdog_gate_passed
       - review_gate_passed
+      - review_user_acknowledged
+      - ready_has_commit_and_push
+      - done_integrated_to_main
+      - release_note_created
+      - release_note_includes_tasks
+      - release_tasks_marked_publish
+      - publish_released_latest
       - commit_linked_to_issue
   auto_select:
     required: true

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

@@ -4,6 +4,17 @@ tracker_gateway:
     github:
       mode: "issues_projects"
       enabled: true
+      status_labels:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - BLOCKED
+        - DONE
+        - PUBLISH
+      hierarchy_labels:
+        epic: "type:epic"
+        feature: "type:feature"
     mcp:
       mode: "external_tracker_via_mcp"
       enabled: true

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

@@ -1,3 +1,5 @@
 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.
+Rule: для большой фичи в GitHub tracker сначала предложить связку `feature issue` + `epic issue` и выделенную ветку.

package/template/.meta-agents/prompts/clarifier.md

@@ -1,3 +1,4 @@
 Role: Clarifier Agent
 Goal: выявить цель, ограничения, неоднозначности и критерии успеха.
+Rule: если задача классифицируется как большая фича, обязательно предложить создать `feature issue` и `epic issue` в GitHub tracker, а также отдельную ветку.
 Output: PRD Step с заполненными "Описание" и "Проверяемость".

package/template/.meta-agents/prompts/publishing-agent.md

@@ -0,0 +1,7 @@
+Role: Publishing Agent
+Goal: подготовить релиз, зафиксировать release notes и перевести вошедшие задачи в статус PUBLISH.
+Rule:
+- перед публикацией создать release note со списком issue/tasks, вошедших в релиз;
+- после подтверждённой публикации обновить статусы всех вошедших задач на `PUBLISH` в GitHub tracker;
+- для каждого релиза оставлять ссылку на release note и версию.
+Output: release note path + список задач + подтверждение обновления статусов.

package/template/.meta-agents/prompts/reviewer-judge.md

@@ -1,4 +1,7 @@
 Role: Reviewer/Judge Agent
 Goal: независимая приёмка по критериям и обязательный pre-commit review gate.
-Output format: что сделано, критические замечания, потенциальные риски, итог PASS/FAIL.
+Output format: что сделано, критические замечания, потенциальные риски, рекомендация PASS_CANDIDATE/FAIL.
+Rule: финальный PASS_CONFIRMED только после явного `Review Approved: yes` от пользователя.
+Status rule: перед review gate задача должна быть в статусе `REVIEW`; статус `READY` выставляется только после `PASS_CONFIRMED`.
+Delivery rule: `READY` требует commit+push; `DONE` требует интеграцию в `main`; `PUBLISH` только после фактической публикации.
 Output: accepted/rejected + findings.

package/template/.meta-agents/scripts/run-review-gate.mjs

@@ -2,6 +2,23 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
 
+function parseArgs(argv) {
+  const options = {
+    approve: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--approve") {
+      const value = (argv[index + 1] || "").trim().toLowerCase();
+      options.approve = value === "yes" || value === "true" || value === "1";
+      index += 1;
+    }
+  }
+
+  return options;
+}
+
 function git(args, allowFailure = false) {
   try {
     const output = execFileSync("git", args, { encoding: "utf8" });
@@ -30,7 +47,8 @@ function matchTestFile(filePath) {
 
 async function scanMarkers(files) {
   const markers = [];
-  const pattern = /\b(TODO|FIXME|XXX|HACK)\b\s*[:\-]/g;
+  // Match common marker formats while ignoring status arrows in workflow lines.
+  const pattern = /\b(TODO|FIXME|XXX|HACK)\b\s*(?::|-(?!>))/;
 
   for (const file of files) {
     try {
@@ -51,6 +69,7 @@ async function scanMarkers(files) {
 }
 
 async function main() {
+  const options = parseArgs(process.argv.slice(2));
   const stagedFiles = splitLines(git(["diff", "--cached", "--name-only"], true));
   const recentFiles = splitLines(git(["show", "--name-only", "--pretty=", "HEAD"], true));
   const files = stagedFiles.length > 0 ? stagedFiles : recentFiles;
@@ -103,15 +122,27 @@ async function main() {
   }
 
   console.log("");
-  if (critical.length === 0) {
+  console.log("## Рекомендация ревьювера");
+  console.log(critical.length === 0 ? "- PASS_CANDIDATE" : "- FAIL");
+
+  if (critical.length > 0) {
+    console.log("");
     console.log("## Решение");
-    console.log("- PASS");
-    process.exit(0);
+    console.log("- FAIL");
+    process.exit(1);
+  }
+
+  console.log("");
+  if (!options.approve) {
+    console.log("## Решение");
+    console.log("- PENDING_USER_CONFIRMATION");
+    console.log("- Требуется явное подтверждение пользователя: Review Approved = yes");
+    process.exit(2);
   }
 
   console.log("## Решение");
-  console.log("- FAIL");
-  process.exit(1);
+  console.log("- PASS_CONFIRMED");
+  process.exit(0);
 }
 
 main().catch((error) => {

package/template/.meta-agents/templates/agent-work-contract.md

@@ -10,3 +10,5 @@
 - Acceptance Criteria:
 - Failure/Escalation Rules:
 - Tracker Binding (task/status/sprint):
+- Git Strategy (main or feature branch + MR/PR):
+- Epic/Feature Linkage (for large features in GitHub tracker):

package/template/.meta-agents/templates/task-template.md

@@ -3,8 +3,10 @@
 - Task ID:
 - Short Name:
 - Owner Role:
-- Status: TODO
+- Status: TODO (TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE -> PUBLISH for release tasks)
 - Sprint:
+- Parent Epic (optional):
+- Git Strategy (main or feature branch + MR/PR):
 
 ## PRD Step
 ### Описание

package/template/README.md

@@ -11,7 +11,9 @@
 Отдельно включён `Governance Watchdog Agent`:
 - обязательный gate перед каждой командой;
 - техническая проверка PRD-структуры через `npm run meta:verify`.
-- обязательный review gate перед коммитом через `npm run meta:review`.
+- обязательный review gate перед коммитом:
+  - `npm run meta:review` (отчёт + рекомендация);
+  - `npm run meta:review-approve` (финальный PASS только после подтверждения пользователя).
 
 ## Что спросит init
 1. Git режим: `github`, `local` или `skip`.
@@ -22,7 +24,12 @@
 1. Каждый шаг содержит: `Описание -> Проверяемость -> Что сделано`.
 2. Перед каждой задачей обязателен вывод `[Agent Auto-Select]` и `[Task Agent]`.
 3. Коммиты и закрытие задачи в `DONE` только после явного подтверждения пользователя.
-4. Без подтверждения пользователя максимум статуса: `READY`.
+4. В single-branch режиме используется статусный цикл: `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`).
+5. Без подтверждения пользователя максимум статуса: `REVIEW`; `READY` только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+6. `READY` = коммит + push (в `main` или в ветку с открытым MR/PR); `DONE` = интеграция в `main`; `PUBLISH` = опубликовано в latest.
+7. Для больших фич (GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
+8. В GitHub epic оформляется как issue с label `type:epic`, а feature связывается с ним ссылкой (`type:feature`).
+9. Для релиза используется `Publishing Agent`: он создаёт release note с вошедшими задачами и переводит эти задачи в `PUBLISH`.
 
 ## Команды
 Смотри `tracker-command-template.md`.
@@ -31,5 +38,6 @@
 ```bash
 npm run meta:verify
 npm run meta:review
+npm run meta:review-approve
 npm run meta:verify-link
 ```

package/template/agents.md

@@ -30,6 +30,7 @@
 - `Engineering Agent`: реализация по контракту.
 - `QA Agent`: проверка выполнения критериев и качество тестового покрытия.
 - `Reviewer/Judge Agent`: независимая приёмка по заранее согласованным правилам.
+- `Publishing Agent`: готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
 - `Documentation Agent`: поддержка и синхронизация артефактов.
 
 ## 4) Жёсткий Auto-Select и показ имени агента
@@ -98,6 +99,8 @@ Name: <agent role>
 3. `RUN_REVIEW_GATE`
 4. `COMMIT_BY_NAME`
 5. `ASSIGN_SPRINT`
+6. `PREPARE_RELEASE_NOTE`
+7. `MARK_TASKS_PUBLISH`
 
 ## 10) Коммиты и закрытие задач: только по подтверждению пользователя
 Запрещено выполнять автоматически:
@@ -105,10 +108,26 @@ Name: <agent role>
 - перевод задачи в `DONE`.
 
 Обязательное правило:
-- `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS` и явного подтверждения пользователя в текущем диалоге;
+- для single-branch режима статусный цикл задачи фиксируется как `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- `RUN_REVIEW_GATE` сначала формирует отчёт ревьювера и рекомендацию (`PASS_CANDIDATE`/`FAIL`);
+- финальный `RUN_REVIEW_GATE: PASS_CONFIRMED` допускается только после явного подтверждения пользователя `Review Approved: yes`;
+- `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS_CONFIRMED` и отдельного явного подтверждения пользователя в текущем диалоге;
 - `SET_STATUS -> DONE` выполняется только после явного подтверждения пользователя в текущем диалоге;
-- без подтверждения пользователя максимум допустимого статуса: `READY`.
+- без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
+- `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 - сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
+- `READY` означает: коммит сделан и отправлен (`push`), при этом либо в `main`, либо в отдельной ветке с открытым MR/PR.
+- `DONE` означает: изменения интегрированы в `main` (прямой коммит в `main` или MR/PR смержен).
+- `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
+
+## 10.1) Правило для больших фич (GitHub tracker)
+Если задача классифицирована как большая фича, система обязана предложить:
+- создать `feature issue` (`type:feature`);
+- создать `epic issue` (`type:epic`);
+- выделить отдельную ветку разработки;
+- связать feature с epic в GitHub issue (ссылка в body/comment/task list).
+
+Для текущего этапа (только GitHub tracker) epic реализуется как обычный issue с label `type:epic`.
 
 ## 11) Жёсткие критерии приёмки (все обязательны)
 Задача принимается только если одновременно выполнены все условия:
@@ -123,7 +142,13 @@ Name: <agent role>
 9. Если задача закрыта в `DONE`, есть явное подтверждение пользователя на закрытие.
 10. Перед каждой командой пройден `VERIFY_GOVERNANCE_GATE` от `Governance Watchdog Agent`.
 11. Перед коммитом пройден `RUN_REVIEW_GATE` от `Reviewer/Judge Agent`.
-12. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+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. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
 
 Если хотя бы один критерий не выполнен, задача не принимается.
 

package/template/package.json

@@ -6,6 +6,7 @@
     "meta:status": "node .meta-agents/scripts/sync-status.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"
   }
 }

package/template/tracker-command-template.md

@@ -38,13 +38,37 @@ result PASS
 - `COMMIT_BY_NAME`;
 - перевод задачи в `DONE`.
 
-Без подтверждения пользователя можно переводить задачу максимум в `READY`.
+Без подтверждения пользователя можно переводить задачу максимум в `REVIEW`.
+`SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 
 Дополнительно для коммита:
-- `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE` с результатом `PASS`;
+- для single-branch режима используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- `RUN_REVIEW_GATE` работает в два этапа:
+  - сначала отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
+  - после явного подтверждения пользователя (`Review Approved: yes`) — финальный `PASS_CONFIRMED`;
+- `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`;
 - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
 
-## 2) Канонические команды (через Agile Manager Agent)
+Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
+- `TODO`
+- `IN_PROGRESS`
+- `REVIEW`
+- `READY`
+- `BLOCKED`
+- `DONE`
+- `PUBLISH`
+
+Семантика статусов:
+- `READY`: коммит сделан и отправлен (`push`), изменения находятся либо в `main`, либо в отдельной ветке с открытым MR/PR.
+- `DONE`: изменения интегрированы в `main` (direct commit в `main` или MR/PR смержен).
+- `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
+
+Правило больших фич (GitHub tracker):
+- если фича крупная, агент обязан предложить `feature issue` + `epic issue` и отдельную ветку;
+- epic в GitHub оформляется как issue с label `type:epic`;
+- feature оформляется как issue с label `type:feature` и ссылкой на epic.
+
+## 2) Канонические команды (через Agile Manager Agent / Publishing Agent)
 ### VERIFY_GOVERNANCE_GATE
 ```text
 [Agent Auto-Select]
@@ -72,10 +96,27 @@ Name: Reviewer/Judge Agent
 Reviewer/Judge Agent: run review gate,
 task DEV-12,
 checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
-result PASS,
+result PASS_CANDIDATE,
 report "posted to issue #12"
 ```
 
+```text
+[User Confirmation]
+Review Approved: yes
+
+[Agent Auto-Select]
+Selected: Reviewer/Judge Agent
+Reason: Подтверждение review пользователем получено, фиксируем финальный результат.
+
+[Task Agent]
+Name: Reviewer/Judge Agent
+
+Reviewer/Judge Agent: run review gate,
+task DEV-12,
+approve yes,
+result PASS_CONFIRMED
+```
+
 ### CREATE_TASK
 ```text
 [Agent Auto-Select]
@@ -111,6 +152,57 @@ status IN_PROGRESS,
 reason "начата реализация"
 ```
 
+### SET_STATUS -> REVIEW (обязателен перед review gate)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Реализация завершена, задача передаётся в review.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: set status,
+tracker github,
+task DEV-12,
+status REVIEW,
+reason "готово к review gate"
+```
+
+### CREATE_EPIC (для большой фичи)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Большая фича требует эпик в GitHub-трекере.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: create task,
+tracker github,
+type epic,
+labels "type:epic,tracker:github,sprint:SPRINT-3",
+short name "EPIC: новый подбор офферов",
+description "Родительская задача для крупной фичи"
+```
+
+### CREATE_FEATURE_AND_LINK_TO_EPIC
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Нужна отдельная feature-задача, связанная с epic.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: create task,
+tracker github,
+type feature,
+labels "type:feature,tracker:github,sprint:SPRINT-3",
+short name "FEATURE: scoring pipeline v2",
+description "Дочерняя feature в рамках epic #42",
+link to epic "#42"
+```
+
 ### COMMIT_BY_NAME (только после подтверждения пользователя)
 ```text
 [Agent Auto-Select]
@@ -128,10 +220,29 @@ tracker github,
 task "API редирект офферов",
 issue 12,
 commit message "DEV-12 | API редирект офферов (#12)",
+push yes,
+branch "feature/DEV-12-api-redirect",
+open mr "optional",
 target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
 ```
 
+### SET_STATUS -> PUBLISH (после фактической публикации)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Публикация релиза завершена, фиксируем статус поставки.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: set status,
+tracker github,
+task DEV-12,
+status PUBLISH,
+reason "релиз опубликован в latest"
+```
+
 ### SET_STATUS -> DONE (только после подтверждения пользователя)
 ```text
 [Agent Auto-Select]
@@ -166,6 +277,38 @@ task DEV-12,
 sprint SPRINT-3
 ```
 
+### 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",
+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>
@@ -190,7 +333,12 @@ sprint SPRINT-3
 2. `CREATE_TASK`.
 3. `SET_STATUS -> IN_PROGRESS`.
 4. Реализация + evidence.
-5. `RUN_REVIEW_GATE` (`PASS` обязателен).
-6. `COMMIT_BY_NAME` только после review PASS и подтверждения пользователя.
-7. `SET_STATUS -> READY`.
-8. `SET_STATUS -> DONE` только после подтверждения пользователя.
+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` для всех вошедших задач).

package/tracker-command-template.md

@@ -38,12 +38,36 @@ result PASS
 - `COMMIT_BY_NAME`;
 - перевод задачи в `DONE`.
 
-Без подтверждения пользователя можно переводить задачу максимум в `READY`.
+Без подтверждения пользователя можно переводить задачу максимум в `REVIEW`.
+`SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 
 Дополнительно для коммита:
-- `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE` с результатом `PASS`;
+- для single-branch режима используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- `RUN_REVIEW_GATE` работает в два этапа:
+  - сначала отчёт и рекомендация (`PASS_CANDIDATE`/`FAIL`);
+  - после явного подтверждения пользователя (`Review Approved: yes`) — финальный `PASS_CONFIRMED`;
+- `COMMIT_BY_NAME` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`;
 - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
 
+Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
+- `TODO`
+- `IN_PROGRESS`
+- `REVIEW`
+- `READY`
+- `BLOCKED`
+- `DONE`
+- `PUBLISH`
+
+Семантика статусов:
+- `READY`: коммит сделан и отправлен (`push`), изменения находятся либо в `main`, либо в отдельной ветке с открытым MR/PR.
+- `DONE`: изменения интегрированы в `main` (direct commit в `main` или MR/PR смержен).
+- `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
+
+Правило больших фич (GitHub tracker):
+- если фича крупная, агент обязан предложить `feature issue` + `epic issue` и отдельную ветку;
+- epic в GitHub оформляется как issue с label `type:epic`;
+- feature оформляется как issue с label `type:feature` и ссылкой на epic.
+
 ## 2) Канонические команды (через Agile Manager Agent)
 ### VERIFY_GOVERNANCE_GATE
 ```text
@@ -72,10 +96,27 @@ Name: Reviewer/Judge Agent
 Reviewer/Judge Agent: run review gate,
 task DEV-12,
 checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
-result PASS,
+result PASS_CANDIDATE,
 report "posted to issue #12"
 ```
 
+```text
+[User Confirmation]
+Review Approved: yes
+
+[Agent Auto-Select]
+Selected: Reviewer/Judge Agent
+Reason: Подтверждение review пользователем получено, фиксируем финальный результат.
+
+[Task Agent]
+Name: Reviewer/Judge Agent
+
+Reviewer/Judge Agent: run review gate,
+task DEV-12,
+approve yes,
+result PASS_CONFIRMED
+```
+
 ### CREATE_TASK
 ```text
 [Agent Auto-Select]
@@ -111,6 +152,57 @@ status IN_PROGRESS,
 reason "начата реализация"
 ```
 
+### SET_STATUS -> REVIEW (обязателен перед review gate)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Реализация завершена, задача передаётся в review.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: set status,
+tracker github,
+task DEV-12,
+status REVIEW,
+reason "готово к review gate"
+```
+
+### CREATE_EPIC (для большой фичи)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Большая фича требует эпик в GitHub-трекере.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: create task,
+tracker github,
+type epic,
+labels "type:epic,tracker:github,sprint:SPRINT-3",
+short name "EPIC: новый подбор офферов",
+description "Родительская задача для крупной фичи"
+```
+
+### CREATE_FEATURE_AND_LINK_TO_EPIC
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Нужна отдельная feature-задача, связанная с epic.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: create task,
+tracker github,
+type feature,
+labels "type:feature,tracker:github,sprint:SPRINT-3",
+short name "FEATURE: scoring pipeline v2",
+description "Дочерняя feature в рамках epic #42",
+link to epic "#42"
+```
+
 ### COMMIT_BY_NAME (только после подтверждения пользователя)
 ```text
 [Agent Auto-Select]
@@ -128,10 +220,29 @@ tracker github,
 task "API редирект офферов",
 issue 12,
 commit message "DEV-12 | API редирект офферов (#12)",
+push yes,
+branch "feature/DEV-12-api-redirect",
+open mr "optional",
 target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
 ```
 
+### SET_STATUS -> PUBLISH (после фактической публикации)
+```text
+[Agent Auto-Select]
+Selected: Agile Manager Agent
+Reason: Публикация релиза завершена, фиксируем статус поставки.
+
+[Task Agent]
+Name: Agile Manager Agent
+
+Agile Manager Agent: set status,
+tracker github,
+task DEV-12,
+status PUBLISH,
+reason "релиз опубликован в latest"
+```
+
 ### SET_STATUS -> DONE (только после подтверждения пользователя)
 ```text
 [Agent Auto-Select]
@@ -190,7 +301,11 @@ sprint SPRINT-3
 2. `CREATE_TASK`.
 3. `SET_STATUS -> IN_PROGRESS`.
 4. Реализация + evidence.
-5. `RUN_REVIEW_GATE` (`PASS` обязателен).
-6. `COMMIT_BY_NAME` только после review PASS и подтверждения пользователя.
-7. `SET_STATUS -> READY`.
-8. `SET_STATUS -> DONE` только после подтверждения пользователя.
+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`.