@k0t0vich/meta-agents-template 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.1.6 - 2026-03-20
+
+### Changed
+- Switched governance/process docs to a single canonical task reference: GitHub `#issue`.
+- Removed mixed prefixed task-id examples (`GOV-*`, `REL-*`, `DOC-*`, `DEV-*`) from workflow commands and policy text.
+- Synchronized current project and template agent artifacts for canonical `#issue` usage (`agents.md`, `tracker-command-template.md`, prompts, branch-router warning, commit-link validation, release docs examples).
+
+## 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

package/README.md

@@ -133,7 +133,7 @@ npm run self:bootstrap
 10. Есть отдельное явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
 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).
+13. Каждый коммит связан с issue (`#issue` в commit message).
 
 Если хотя бы один пункт не выполнен, задача не принимается.
 
@@ -143,14 +143,14 @@ npm run self:bootstrap
 ```bash
 npm run meta:verify
 npm run meta:branch
-npm run meta:task-start -- --task 12 --slug api-redirect
+npm run meta:task-start -- --task #12 --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":"12","slug":"api-redirect"}'
+npm run meta:ops -- --command SET_STATUS --payload '{"task":"#12","status":"IN_PROGRESS"}'
+npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"#12","slug":"api-redirect"}'
 npm run meta:status
 ```
 
@@ -158,6 +158,7 @@ npm run meta:status
 `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: использовать GitHub issue ref в формате `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 и не являются источником истины.

package/agents.md

@@ -139,7 +139,6 @@ Name: <agent role>
 Обязательное правило:
 - для режима `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`;
@@ -149,7 +148,7 @@ Name: <agent role>
 - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
 - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
-- сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
+- сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
 - `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
 - `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
@@ -166,13 +165,14 @@ Name: <agent role>
 ## 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` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
+2. Запустить branch-routing preflight через `meta:task-start -- --task <#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
+3. В названии рабочей ветки использовать GitHub issue ref в формате `issue-<number>` (например, `feature/issue-21-canonical-github-issue-id`).
+4. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
+5. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
+6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
+7. Переключиться на базовую ветку (`develop` или `main`) и обновить её.
+8. Создать новую рабочую ветку по Git Flow Lite.
+9. Перед переключением проверить консистентность `agents.md` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
 
 Без этого preflight выполнение реализации запрещено.
 
@@ -199,7 +199,7 @@ Name: <agent role>
 19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
 21. Для релиза обновлён публичный `CHANGELOG.md`.
-22. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+22. Коммит содержит ссылку на issue (`#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.4",
+  "version": "0.1.6",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {

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

@@ -8,9 +8,6 @@ on:
       - 'feature/**'
       - 'release/**'
       - 'hotfix/**'
-      - 'codex/feature/**'
-      - 'codex/release/**'
-      - 'codex/hotfix/**'
   pull_request:
     branches:
       - main
@@ -34,7 +31,7 @@ jobs:
         run: |
           BRANCH="${GITHUB_HEAD_REF:-${GITHUB_REF_NAME}}"
           echo "Branch: $BRANCH"
-          if [[ "$BRANCH" =~ ^(main|develop|feature/.+|release/.+|hotfix/.+|codex/feature/.+|codex/release/.+|codex/hotfix/.+)$ ]]; then
+          if [[ "$BRANCH" =~ ^(main|develop|feature/.+|release/.+|hotfix/.+)$ ]]; then
             echo "Branch naming PASS"
           else
             echo "Branch naming FAIL: '$BRANCH' is not Git Flow Lite compatible"
@@ -48,7 +45,9 @@ jobs:
           node --check .meta-agents/scripts/task-branch-router.mjs
           npm run meta:verify
           npm run meta:status -- --json
-          npm run meta:task-start -- --task 101 --slug verify --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
@@ -56,8 +55,8 @@ jobs:
           git add -A
           git commit -m "ci: bootstrap routing check"
           git branch develop
-          git checkout -b codex/feature/101-routing
-          node .meta-agents/scripts/task-branch-router.mjs --task 101 --slug routing --json > /tmp/same-feature.json
+          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 202 --slug routing --json > /tmp/cross-feature.json
+          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/system.yaml

@@ -83,18 +83,18 @@ system:
           - main
           - develop
         working_branches:
-          feature: "feature/<task-or-issue-id>-<slug>"
+          feature: "feature/<task-ref>-<slug>"
           release: "release/vX.Y.Z"
-          hotfix: "hotfix/<task-or-issue-id>-<slug>"
+          hotfix: "hotfix/<task-ref>-<slug>"
+        task_ref_policy:
+          canonical_format: "#<number>"
+          branch_format: "issue-<number>"
         allowed_branch_patterns:
           - "^main$"
           - "^develop$"
           - "^feature/.+"
           - "^release/.+"
           - "^hotfix/.+"
-          - "^codex/feature/.+"
-          - "^codex/release/.+"
-          - "^codex/hotfix/.+"
         merge_rules:
           - "feature/* -> develop"
           - "release/* -> main and back-merge to develop"
@@ -208,7 +208,6 @@ system:
     commit_linkage:
       required: true
       accepted_patterns:
-        - "TASK-ID"
         - "#issue"
     publish_flow:
       changelog_required: true

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

@@ -7,7 +7,7 @@ Rule: для большой фичи в GitHub tracker сначала предл
 
 Branch routing protocol (обязателен для задач реализации):
 1. Сначала снять контекст: `npm run meta:status -- --json`.
-2. Проверить маршрут ветки: `npm run meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic`.
+2. Проверить маршрут ветки: `npm run meta:task-start -- --task <#issue> --slug <slug> --kind atomic`.
 3. Если `route=stay_on_current_branch`, задача считается атомарной внутри текущей feature-ветки.
 4. Если `route=create_new_branch`, перед началом реализации обязательно перейти на базовую ветку (`develop` для feature/release, `main` для hotfix), обновить её и создать новую рабочую ветку.
 5. Создание/переключение ветки выполнять только после явного подтверждения пользователя (`--apply`).
@@ -18,6 +18,10 @@ Mandatory user dialogue before branch switch:
 - подтвердить обработку непушенных коммитов (`ahead > 0`);
 - подтвердить финальный switch/create.
 
+Task ref naming rule:
+- использовать GitHub issue ref как единственный канонический идентификатор (`#<number>`);
+- в имени ветки использовать формат `issue-<number>`.
+
 Pre-merge rule:
 - после commit+push и открытия PR обязательно выполнить `RUN_MR_REVIEW_GATE`;
 - merge допускается только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED` и явного `MR Review Approved: yes` от пользователя.

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

@@ -21,7 +21,7 @@ Output format (обязательный):
 Tooling:
 - Основной путь: `npm run meta:status`.
 - Для machine-readable вывода можно использовать `npm run meta:status -- --json`.
-- Для веточного preflight по конкретной задаче: `npm run meta:task-start -- --task <TASK-ID|#issue> --slug <slug>`.
+- Для веточного preflight по конкретной задаче: `npm run meta:task-start -- --task <#issue> --slug <slug>`.
 
 Rule:
 - В `github` режиме локальные `tasks/*` не считать авторитетным источником по умолчанию; рассматривать только как cache/legacy artifacts.

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

@@ -77,13 +77,13 @@ function classifyBranch(branch) {
   if (/^develop$/.test(branch)) {
     return "develop";
   }
-  if (/^feature\/.+/.test(branch) || /^codex\/feature\/.+/.test(branch)) {
+  if (/^feature\/.+/.test(branch)) {
     return "feature";
   }
-  if (/^release\/.+/.test(branch) || /^codex\/release\/.+/.test(branch)) {
+  if (/^release\/.+/.test(branch)) {
     return "release";
   }
-  if (/^hotfix\/.+/.test(branch) || /^codex\/hotfix\/.+/.test(branch)) {
+  if (/^hotfix\/.+/.test(branch)) {
     return "hotfix";
   }
   return "unknown";
@@ -105,7 +105,7 @@ function extractTaskRefs(text) {
     refs.add(ref);
   }
 
-  const taskMatches = source.match(/\b[A-Z][A-Z0-9_]*-\d+\b/g) || [];
+  const taskMatches = source.match(/\b[A-Za-z][A-Za-z0-9_]*-\d+\b/g) || [];
   for (const ref of taskMatches) {
     refs.add(ref.toUpperCase());
   }
@@ -277,7 +277,13 @@ function gatherTaskRefs(context) {
     refs.add(`#${branchIssue[1]}`);
   }
 
-  const branchTask = String(context.branch || "").match(/([A-Z][A-Z0-9_]*-\d+)/);
+  const branchIssueToken = String(context.branch || "").match(/(?:^|\/)issue-(\d+)(?:-|$)/i);
+  if (branchIssueToken) {
+    refs.add(`#${branchIssueToken[1]}`);
+    refs.add(`ISSUE-${branchIssueToken[1]}`);
+  }
+
+  const branchTask = String(context.branch || "").match(/([A-Za-z][A-Za-z0-9_]*-\d+)/);
   if (branchTask) {
     refs.add(branchTask[1].toUpperCase());
   }

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

@@ -62,13 +62,13 @@ function classifyBranch(branch) {
   if (/^develop$/.test(branch)) {
     return "develop";
   }
-  if (/^feature\/.+/.test(branch) || /^codex\/feature\/.+/.test(branch)) {
+  if (/^feature\/.+/.test(branch)) {
     return "feature";
   }
-  if (/^release\/.+/.test(branch) || /^codex\/release\/.+/.test(branch)) {
+  if (/^release\/.+/.test(branch)) {
     return "release";
   }
-  if (/^hotfix\/.+/.test(branch) || /^codex\/hotfix\/.+/.test(branch)) {
+  if (/^hotfix\/.+/.test(branch)) {
     return "hotfix";
   }
   return "unknown";

package/template/.meta-agents/scripts/sync-status.mjs

@@ -12,9 +12,6 @@ const BRANCH_PATTERNS = [
   { type: "feature", regex: /^feature\/.+/ },
   { type: "release", regex: /^release\/.+/ },
   { type: "hotfix", regex: /^hotfix\/.+/ },
-  { type: "feature", regex: /^codex\/feature\/.+/ },
-  { type: "release", regex: /^codex\/release\/.+/ },
-  { type: "hotfix", regex: /^codex\/hotfix\/.+/ },
 ];
 
 function parseArgs(argv) {
@@ -258,8 +255,9 @@ function detectTaskFromBranch(branch) {
   if (!taskRef) {
     return "";
   }
-  if (/^\d+$/.test(taskRef)) {
-    return `#${taskRef}`;
+  const issueMatch = taskRef.match(/^ISSUE-(\d+)$/);
+  if (issueMatch) {
+    return `#${issueMatch[1]}`;
   }
   return taskRef;
 }
@@ -280,21 +278,20 @@ function extractBranchTaskRef(branch) {
     return "";
   }
 
-  const normalized = source.startsWith("codex/") ? source.slice("codex/".length) : source;
-  const match = normalized.match(/^(feature|release|hotfix)\/(.+)$/);
+  const match = source.match(/^(feature|release|hotfix)\/(.+)$/);
   if (!match) {
     return "";
   }
 
   const tail = match[2];
-  const uppercaseToken = tail.match(/^([A-Z][A-Z0-9_]*-\d+)/);
+  const uppercaseToken = tail.match(/^([A-Za-z][A-Za-z0-9_]*-\d+)/);
   if (uppercaseToken) {
     return uppercaseToken[1].toUpperCase();
   }
 
   const numericToken = tail.match(/^(\d+)(?:-|$)/);
   if (numericToken) {
-    return numericToken[1];
+    return `ISSUE-${numericToken[1]}`;
   }
 
   return "";
@@ -308,7 +305,7 @@ function extractTaskRefFromCurrentTask(currentTask) {
 
   const issueMatch = source.match(/#(\d+)/);
   if (issueMatch) {
-    return issueMatch[1];
+    return `ISSUE-${issueMatch[1]}`;
   }
 
   const taskMatch = source.match(/\b([A-Z][A-Z0-9_]*-\d+)\b/);

package/template/.meta-agents/scripts/task-branch-router.mjs

@@ -7,9 +7,6 @@ const BRANCH_PATTERNS = [
   { type: "feature", regex: /^feature\/.+/ },
   { type: "release", regex: /^release\/.+/ },
   { type: "hotfix", regex: /^hotfix\/.+/ },
-  { type: "feature", regex: /^codex\/feature\/.+/ },
-  { type: "release", regex: /^codex\/release\/.+/ },
-  { type: "hotfix", regex: /^codex\/hotfix\/.+/ },
 ];
 
 const TASK_KIND_MAP = {
@@ -180,8 +177,7 @@ function extractBranchTaskRef(branch) {
     return "";
   }
 
-  const normalized = source.startsWith("codex/") ? source.slice("codex/".length) : source;
-  const match = normalized.match(/^(feature|release|hotfix)\/(.+)$/);
+  const match = source.match(/^(feature|release|hotfix)\/(.+)$/);
   if (!match) {
     return "";
   }
@@ -194,7 +190,7 @@ function extractBranchTaskRef(branch) {
 
   const issueMatch = tail.match(/^(\d+)(?:-|$)/);
   if (issueMatch) {
-    return issueMatch[1];
+    return `ISSUE-${issueMatch[1]}`;
   }
 
   return "";
@@ -208,12 +204,12 @@ function normalizeTaskRef(task) {
 
   const issue = source.match(/^#?(\d+)$/);
   if (issue) {
-    return issue[1];
+    return `ISSUE-${issue[1]}`;
   }
 
   const fromBodyIssue = source.match(/#(\d+)/);
   if (fromBodyIssue) {
-    return fromBodyIssue[1];
+    return `ISSUE-${fromBodyIssue[1]}`;
   }
 
   const taskRef = source.match(/([A-Za-z][A-Za-z0-9_]*-\d+)/);
@@ -249,7 +245,7 @@ function defaultBaseBranch(kind) {
 }
 
 function buildTargetBranch({ kind, taskRef, slug }) {
-  const prefix = `codex/${kind}`;
+  const prefix = kind;
   const taskPart = slugify(taskRef) || "task";
   const slugPart = slugify(slug) || "work";
   if (slugPart === taskPart) {
@@ -377,6 +373,7 @@ function buildPlan(options, gitContext) {
       });
 
   const blockers = [];
+  const namingWarnings = [];
   const requiresDialogue = [];
 
   if (!sameFeature && gitContext.dirty && !options.allowDirty) {
@@ -393,6 +390,12 @@ function buildPlan(options, gitContext) {
     );
   }
 
+  if (!/^ISSUE-\d+$/.test(taskRef)) {
+    namingWarnings.push(
+      "Canonical task ref should be GitHub issue number (#<number>) so branch naming stays issue-<number>.",
+    );
+  }
+
   if (sameFeature) {
     requiresDialogue.push(
       "Задача атомарная и относится к текущей feature-ветке. Подтвердите, что продолжаем работу в этой ветке.",
@@ -414,6 +417,7 @@ function buildPlan(options, gitContext) {
     current: gitContext,
     targetBranch,
     blockers,
+    namingWarnings,
     contextWarnings: getContextWarnings(baseBranch),
     requiresDialogue,
     suggestedCommands: sameFeature
@@ -466,6 +470,16 @@ function printPlan(plan, applyResult) {
     }
   }
 
+  console.log("");
+  console.log("## Naming Warnings");
+  if (plan.namingWarnings.length === 0) {
+    console.log("- none");
+  } else {
+    for (const warning of plan.namingWarnings) {
+      console.log(`- ${warning}`);
+    }
+  }
+
   console.log("");
   console.log("## Required User Dialogue");
   for (const line of plan.requiresDialogue) {

package/template/.meta-agents/scripts/verify-branch-strategy.mjs

@@ -7,9 +7,6 @@ const BRANCH_PATTERNS = [
   { type: "feature", regex: /^feature\/.+/ },
   { type: "release", regex: /^release\/.+/ },
   { type: "hotfix", regex: /^hotfix\/.+/ },
-  { type: "feature", regex: /^codex\/feature\/.+/ },
-  { type: "release", regex: /^codex\/release\/.+/ },
-  { type: "hotfix", regex: /^codex\/hotfix\/.+/ },
 ];
 
 function git(args, allowFailure = false) {

package/template/.meta-agents/scripts/verify-commit-link.mjs

@@ -8,8 +8,7 @@ function readLastCommitSubject(ref = "HEAD") {
 
 function validateMessage(message) {
   const hasIssueNumber = /#\d+\b/.test(message);
-  const hasTaskId = /\b[A-Z][A-Z0-9_]*-\d+\b/.test(message);
-  return hasIssueNumber || hasTaskId;
+  return hasIssueNumber;
 }
 
 function parseArgs(argv) {
@@ -49,7 +48,7 @@ function main() {
     }
 
     if (!validateMessage(message)) {
-      console.error("Commit link FAIL: message must contain TASK-ID or #issue.");
+      console.error("Commit link FAIL: message must contain #issue.");
       console.error(`Message: ${message}`);
       process.exit(1);
     }

package/template/README.md

@@ -50,14 +50,14 @@
 ```bash
 npm run meta:verify
 npm run meta:branch
-npm run meta:task-start -- --task 12 --slug api-redirect
+npm run meta:task-start -- --task #12 --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":"12","slug":"api-redirect"}'
+npm run meta:ops -- --command SET_STATUS --payload '{"task":"#12","status":"IN_PROGRESS"}'
+npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"#12","slug":"api-redirect"}'
 npm run meta:status
 ```
 
@@ -66,6 +66,7 @@ npm run meta:status
 `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: использовать GitHub issue ref в формате `issue-<number>`.
 `meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
 
 `meta:status` выдаёт сводный статус:

package/template/agents.md

@@ -139,7 +139,6 @@ Name: <agent role>
 Обязательное правило:
 - для режима `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`;
@@ -149,7 +148,7 @@ Name: <agent role>
 - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
 - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
-- сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
+- сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
 - `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
 - `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
@@ -166,13 +165,14 @@ Name: <agent role>
 ## 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` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
+2. Запустить branch-routing preflight через `meta:task-start -- --task <#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
+3. В названии рабочей ветки использовать GitHub issue ref в формате `issue-<number>` (например, `feature/issue-21-canonical-github-issue-id`).
+4. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
+5. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
+6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
+7. Переключиться на базовую ветку (`develop` или `main`) и обновить её.
+8. Создать новую рабочую ветку по Git Flow Lite.
+9. Перед переключением проверить консистентность `agents.md` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
 
 Без этого preflight выполнение реализации запрещено.
 
@@ -199,7 +199,7 @@ Name: <agent role>
 19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
 21. Для релиза обновлён публичный `CHANGELOG.md`.
-22. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
+22. Коммит содержит ссылку на issue (`#issue`).
 23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
 24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
 

package/template/tasks/task-status-log.md

@@ -1,3 +1,3 @@
 # Task Status Log
 
-- Format: YYYY-MM-DD | TASK-ID | STATUS | short note
+- Format: YYYY-MM-DD | #issue | STATUS | short note

package/template/tracker-command-template.md

@@ -26,7 +26,7 @@ Reason: Обязательная проверка соблюдения PRD и к
 Name: Governance Watchdog Agent
 
 Governance Watchdog Agent: verify governance gate,
-task <TASK-ID>,
+task <#issue>,
 required checks "prd_sections_complete, acceptance_defined, user_confirmation_policy_respected",
 result PASS
 ```
@@ -53,7 +53,6 @@ result PASS
 Дополнительно для коммита:
 - для `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`);
@@ -65,10 +64,11 @@ result PASS
 - merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
 - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
 - перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
+- branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
 - если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
 - если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
 - перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
-- сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
+- сообщение коммита обязательно содержит `#issue-number`.
 
 Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
 - `TODO`
@@ -80,7 +80,7 @@ result PASS
 - `PUBLISH`
 
 Семантика статусов:
-- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*` (или `codex/*` эквиваленты); открыт PR в `develop` или `main` согласно правилам ветвления.
+- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*`; открыт PR в `develop` или `main` согласно правилам ветвления.
 - `DONE`: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
 
@@ -100,7 +100,7 @@ Reason: Нужна обязательная preflight-проверка проц
 Name: Governance Watchdog Agent
 
 Governance Watchdog Agent: verify governance gate,
-task DEV-12,
+task #12,
 checklist "PRD(Описание+Проверяемость), hard criteria, user confirmation policy",
 result PASS
 ```
@@ -115,7 +115,7 @@ Reason: Нужен обязательный pre-commit review.
 Name: Reviewer/Judge Agent
 
 Reviewer/Judge Agent: run review gate,
-task DEV-12,
+task #12,
 checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
 result PASS_CANDIDATE,
 report "posted to issue #12"
@@ -133,7 +133,7 @@ Reason: Подтверждение review пользователем получ
 Name: Reviewer/Judge Agent
 
 Reviewer/Judge Agent: run review gate,
-task DEV-12,
+task #12,
 approve yes,
 result PASS_CONFIRMED
 ```
@@ -168,7 +168,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker __DEFAULT_TRACKER__,
-task DEV-12,
+task #12,
 status IN_PROGRESS,
 reason "начата реализация"
 ```
@@ -186,7 +186,7 @@ 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",
+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"
 ```
 
@@ -201,7 +201,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker __DEFAULT_TRACKER__,
-task DEV-12,
+task #12,
 status REVIEW,
 reason "готово к review gate"
 ```
@@ -257,9 +257,9 @@ Agile Manager Agent: commit by name,
 tracker __DEFAULT_TRACKER__,
 task "API редирект офферов",
 issue 12,
-commit message "DEV-12 | API редирект офферов (#12)",
+commit message "#12 | API редирект офферов",
 push yes,
-branch "feature/DEV-12-api-redirect",
+branch "feature/issue-12-api-redirect",
 open mr "optional",
 target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
@@ -275,7 +275,7 @@ Reason: Нужен обязательный pre-merge review по MR/PR с пр
 Name: MR Review Agent
 
 MR Review Agent: run MR review gate,
-task DEV-12,
+task #12,
 pr 34,
 checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
 result PASS_CANDIDATE
@@ -293,7 +293,7 @@ Reason: Подтверждение MR review пользователем полу
 Name: MR Review Agent
 
 MR Review Agent: run MR review gate,
-task DEV-12,
+task #12,
 pr 34,
 approve yes,
 result PASS_CONFIRMED
@@ -310,7 +310,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker __DEFAULT_TRACKER__,
-task DEV-12,
+task #12,
 status PUBLISH,
 reason "релиз опубликован в latest"
 ```
@@ -329,7 +329,7 @@ Close Task Approved: yes
 
 Agile Manager Agent: set status,
 tracker __DEFAULT_TRACKER__,
-task DEV-12,
+task #12,
 status DONE,
 reason "пользователь подтвердил закрытие"
 ```
@@ -345,7 +345,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: assign sprint,
 tracker __DEFAULT_TRACKER__,
-task DEV-12,
+task #12,
 sprint SPRINT-3
 ```
 

package/tracker-command-template.md

@@ -26,7 +26,7 @@ Reason: Обязательная проверка соблюдения PRD и к
 Name: Governance Watchdog Agent
 
 Governance Watchdog Agent: verify governance gate,
-task <TASK-ID>,
+task <#issue>,
 required checks "prd_sections_complete, acceptance_defined, user_confirmation_policy_respected",
 result PASS
 ```
@@ -53,7 +53,6 @@ result PASS
 Дополнительно для коммита:
 - для `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`);
@@ -65,10 +64,11 @@ result PASS
 - merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
 - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
 - перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
+- branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
 - если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
 - если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
 - перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
-- сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
+- сообщение коммита обязательно содержит `#issue-number`.
 
 Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
 - `TODO`
@@ -80,7 +80,7 @@ result PASS
 - `PUBLISH`
 
 Семантика статусов:
-- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*` (или `codex/*` эквиваленты); открыт PR в `develop` или `main` согласно правилам ветвления.
+- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*`; открыт PR в `develop` или `main` согласно правилам ветвления.
 - `DONE`: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
 
@@ -100,7 +100,7 @@ Reason: Нужна обязательная preflight-проверка проц
 Name: Governance Watchdog Agent
 
 Governance Watchdog Agent: verify governance gate,
-task DEV-12,
+task #12,
 checklist "PRD(Описание+Проверяемость), hard criteria, user confirmation policy",
 result PASS
 ```
@@ -115,7 +115,7 @@ Reason: Нужен обязательный pre-commit review.
 Name: Reviewer/Judge Agent
 
 Reviewer/Judge Agent: run review gate,
-task DEV-12,
+task #12,
 checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
 result PASS_CANDIDATE,
 report "posted to issue #12"
@@ -133,7 +133,7 @@ Reason: Подтверждение review пользователем получ
 Name: Reviewer/Judge Agent
 
 Reviewer/Judge Agent: run review gate,
-task DEV-12,
+task #12,
 approve yes,
 result PASS_CONFIRMED
 ```
@@ -168,7 +168,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker github,
-task DEV-12,
+task #12,
 status IN_PROGRESS,
 reason "начата реализация"
 ```
@@ -186,7 +186,7 @@ Agile Manager Agent: prepare task branch,
 tracker github,
 task "#12",
 task kind "atomic",
-command "npm run meta:task-start -- --task 12 --slug api-redirect",
+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"
 ```
 
@@ -201,7 +201,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker github,
-task DEV-12,
+task #12,
 status REVIEW,
 reason "готово к review gate"
 ```
@@ -257,9 +257,9 @@ Agile Manager Agent: commit by name,
 tracker github,
 task "API редирект офферов",
 issue 12,
-commit message "DEV-12 | API редирект офферов (#12)",
+commit message "#12 | API редирект офферов",
 push yes,
-branch "feature/DEV-12-api-redirect",
+branch "feature/issue-12-api-redirect",
 open mr "optional",
 target status READY,
 what done "добавлен endpoint, тесты, обработка ошибок"
@@ -275,7 +275,7 @@ Reason: Нужен обязательный pre-merge review по MR/PR с пр
 Name: MR Review Agent
 
 MR Review Agent: run MR review gate,
-task DEV-12,
+task #12,
 pr 34,
 checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
 result PASS_CANDIDATE
@@ -293,7 +293,7 @@ Reason: Подтверждение MR review пользователем полу
 Name: MR Review Agent
 
 MR Review Agent: run MR review gate,
-task DEV-12,
+task #12,
 pr 34,
 approve yes,
 result PASS_CONFIRMED
@@ -310,7 +310,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: set status,
 tracker github,
-task DEV-12,
+task #12,
 status PUBLISH,
 reason "релиз опубликован в latest"
 ```
@@ -329,7 +329,7 @@ Close Task Approved: yes
 
 Agile Manager Agent: set status,
 tracker github,
-task DEV-12,
+task #12,
 status DONE,
 reason "пользователь подтвердил закрытие"
 ```
@@ -345,7 +345,7 @@ Name: Agile Manager Agent
 
 Agile Manager Agent: assign sprint,
 tracker github,
-task DEV-12,
+task #12,
 sprint SPRINT-3
 ```
 
@@ -362,7 +362,7 @@ 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"
+command "npm run meta:status"
 ```
 
 ### PREPARE_RELEASE_NOTE