@k0t0vich/meta-agents-template 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.1.9 - 2026-03-20
+
+### Fixed
+- `meta-agents init` now creates `AGENTS.md` by default for new projects, so agent runtimes that expect uppercase bootstrap filename can load rules reliably.
+- Existing projects with pre-created `agents.md` remain non-destructive: init still updates only managed links block instead of replacing full file.
+- Bootstrap block now includes explicit required instruction to read canonical rules from npm-linked template files.
+- Branch context protection for `meta:task-start` now checks `AGENTS.md` with fallback to `agents.md`.
+- Local smoke now validates `AGENTS.md` presence and required bootstrap instruction in empty-folder install scenario.
+
+## 0.1.8 - 2026-03-20
+
+### Changed
+- Finalized npm-linked rules model: generated projects keep root configs only (`project-context.yaml`, `trackers.yaml`) and execute meta scripts directly from `node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/*`.
+- Reworked root bootstrap docs and `agents.md` so project context stays local while operational rules are consumed from template-linked sources.
+- Restored reliable status flow for both source repo and generated projects (`meta:status` fallback paths documented and runnable).
+- Tightened commit-message validation to canonical format `#<issue-number> <summary>` and synchronized policy text with that format.
+- Expanded local release smoke to validate two required scenarios: linked execution from current code and installation flow from an empty folder.
+
 ## 0.1.7 - 2026-03-20
 
 ### Changed

package/README.md

@@ -31,8 +31,8 @@ npx -y @k0t0vich/meta-agents-template init . --yes --tracker github
 Важно:
 - если пользователь дал URL `https://www.npmjs.com/package/@k0t0vich/meta-agents-template`, извлекай имя пакета `@k0t0vich/meta-agents-template` и ставь именно его;
 - не запускай `npm i -D ...` в папке без `package.json`, иначе npm может установить пакет в родительский проект.
-- `meta-agents init` по умолчанию работает non-destructive: в корне создаёт/обновляет только `.meta-agents/config/*`, аккуратно merge-ит `meta:*` scripts в `package.json` и добавляет ссылочный блок в `agents.md` вместо полной перезаписи.
-- `--force` нужен только если надо перезаписать уже существующие `.meta-agents/config/*` и мигрировать legacy `meta:*` scripts.
+- `meta-agents init` по умолчанию работает non-destructive: в корне создаёт/обновляет только project-specific конфиги `.meta-agents/config/project-context.yaml` (имя проекта + tracker) и `.meta-agents/config/trackers.yaml`, аккуратно merge-ит `meta:*` scripts в `package.json` и добавляет/обновляет bootstrap-блок в `AGENTS.md` (или в уже существующий `agents.md`) вместо полной перезаписи.
+- `--force` нужен только если надо перезаписать уже существующие project-specific конфиги (`project-context.yaml`, `trackers.yaml`) и мигрировать legacy `meta:*` scripts.
 
 ## One-line для агентного запуска
 Если пользователь пишет только:
@@ -48,7 +48,7 @@ mkdir -p my-project && cd my-project && npm init -y && npm i -D @k0t0vich/meta-a
 Проверка, что шаблон и правила действительно развернуты:
 
 ```bash
-test -f agents.md && test -f .meta-agents/config/project-context.yaml && test -f node_modules/@k0t0vich/meta-agents-template/agents.md && echo "meta-agents template ready"
+(test -f AGENTS.md || test -f agents.md) && test -f .meta-agents/config/project-context.yaml && test -f node_modules/@k0t0vich/meta-agents-template/template/agents.md && echo "meta-agents template ready"
 ```
 
 ## Диалог при `init`
@@ -64,21 +64,19 @@ test -f agents.md && test -f .meta-agents/config/project-context.yaml && test -f
 my-project/
   package.json
   package-lock.json
-  agents.md
+  AGENTS.md        # или agents.md, если файл уже существовал
   .meta-agents/
     config/
-      system.yaml
-      roles.yaml
-      trackers.yaml
       project-context.yaml
+      trackers.yaml
   node_modules/
     @k0t0vich/meta-agents-template/
-      agents.md
-      tracker-command-template.md
+      template/agents.md
+      template/tracker-command-template.md
       template/.meta-agents/scripts/*.mjs
 ```
 
-`agents.md` в проекте не перезаписывается целиком: `init` добавляет/обновляет в нём только ссылочный блок на правила из npm-пакета.
+Файл `AGENTS.md` (или уже существующий `agents.md`) не перезаписывается целиком: `init` добавляет/обновляет в нём только managed bootstrap-блок со ссылками на canonical rules из npm-пакета.
 
 ## Канонические команды
 0. `VERIFY_GOVERNANCE_GATE`
@@ -131,7 +129,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 (`#issue` в commit message).
+13. Каждый коммит следует формату `#issue-number <summary>` (issue ref в начале commit message).
 
 Если хотя бы один пункт не выполнен, задача не принимается.
 
@@ -155,7 +153,7 @@ 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.
+`meta:task-start` также делает context-protection check для `AGENTS.md` (fallback: `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.
@@ -180,7 +178,7 @@ npm run meta:status
 - для большой фичи (в режиме GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
 
 ## Основные документы шаблона
-- [agents.md](./agents.md)
-- [tracker-command-template.md](./tracker-command-template.md)
+- [template/agents.md](./template/agents.md)
+- [template/tracker-command-template.md](./template/tracker-command-template.md)
 - [CHANGELOG.md](./CHANGELOG.md)
 - [GitHub Releases](https://github.com/k0t0vich/meta-agents-template/releases)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {
@@ -10,13 +10,21 @@
     "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",
-    "release:smoke-local": "node scripts/post-publish-local-smoke.mjs"
+    "release:smoke-local": "node scripts/post-publish-local-smoke.mjs",
+    "meta:status": "node template/.meta-agents/scripts/sync-status.mjs",
+    "meta:branch": "node template/.meta-agents/scripts/verify-branch-strategy.mjs",
+    "meta:task-start": "node template/.meta-agents/scripts/task-branch-router.mjs",
+    "meta:verify": "node template/.meta-agents/scripts/verify-governance.mjs",
+    "meta:review": "node template/.meta-agents/scripts/run-review-gate.mjs",
+    "meta:review-approve": "node template/.meta-agents/scripts/run-review-gate.mjs --approve yes",
+    "meta:mr-review": "node template/.meta-agents/scripts/run-mr-review-gate.mjs",
+    "meta:mr-review-approve": "node template/.meta-agents/scripts/run-mr-review-gate.mjs --approve yes",
+    "meta:verify-link": "node template/.meta-agents/scripts/verify-commit-link.mjs",
+    "meta:ops": "node template/.meta-agents/scripts/tracker-gateway.mjs"
   },
   "files": [
     "README.md",
     "CHANGELOG.md",
-    "agents.md",
-    "tracker-command-template.md",
     "bin",
     "src",
     "template"

package/src/cli.mjs

@@ -279,12 +279,26 @@ export async function main(argv) {
     if (result.config.skipped.length > 0) {
       console.log(`Config files kept: ${result.config.skipped.join(", ")}`);
     }
-    if (result.agents.created) {
-      console.log("agents.md: created with npm links to template rules");
-    } else if (result.agents.updated) {
-      console.log("agents.md: appended/updated npm links block");
-    } else {
-      console.log("agents.md: npm links block already up to date");
+    if (result.agents.created.length > 0) {
+      console.log(
+        `Agent bootstrap created: ${result.agents.created
+          .map((item) => path.basename(item))
+          .join(", ")}`,
+      );
+    }
+    if (result.agents.updated.length > 0) {
+      console.log(
+        `Agent bootstrap updated: ${result.agents.updated
+          .map((item) => path.basename(item))
+          .join(", ")}`,
+      );
+    }
+    if (result.agents.created.length === 0 && result.agents.updated.length === 0) {
+      console.log(
+        `Agent bootstrap already up to date: ${result.agents.unchanged
+          .map((item) => path.basename(item))
+          .join(", ")}`,
+      );
     }
     if (result.git.actions.length > 0) {
       console.log(`Git actions: ${result.git.actions.join("; ")}`);

package/src/init.mjs

@@ -12,6 +12,8 @@ const TEXT_EXTENSIONS = new Set([
   ".mjs",
   ".js",
 ]);
+const ROOT_CONFIG_FILES = ["project-context.yaml", "trackers.yaml"];
+const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
 
 const AGENTS_LINK_BLOCK_START = "<!-- meta-agents-template:links:start -->";
 const AGENTS_LINK_BLOCK_END = "<!-- meta-agents-template:links:end -->";
@@ -218,24 +220,35 @@ function buildAgentsLinkBlock(packageName) {
   const lines = [
     AGENTS_LINK_BLOCK_START,
     "## Meta Agents Template (npm-linked)",
+    "ОБЯЗАТЕЛЬНО: перед выполнением любой команды сначала прочитай canonical rules по ссылкам ниже.",
+    "При конфликте локального текста и шаблона приоритет у canonical files из node_modules.",
     "Базовые правила шаблона:",
-    `- [Template agents.md](${packageRoot}/agents.md)`,
-    `- [Template tracker-command-template.md](${packageRoot}/tracker-command-template.md)`,
+    `- [Template agents.md](${packageRoot}/template/agents.md)`,
+    `- [Template tracker-command-template.md](${packageRoot}/template/tracker-command-template.md)`,
     "Локальные конфиги проекта:",
     "- [.meta-agents/config/project-context.yaml](./.meta-agents/config/project-context.yaml)",
     "- [.meta-agents/config/trackers.yaml](./.meta-agents/config/trackers.yaml)",
-    "- [.meta-agents/config/system.yaml](./.meta-agents/config/system.yaml)",
     AGENTS_LINK_BLOCK_END,
   ];
   return `${lines.join("\n")}\n`;
 }
 
-async function upsertAgentsLinks(targetDir, packageName) {
-  const agentsPath = path.join(targetDir, "agents.md");
+function buildAgentsBootstrapContent(fileName, block) {
+  return [
+    `# ${fileName}`,
+    "",
+    "Bootstrap file for agent runtime.",
+    "Before any task, read canonical rules from the npm-linked files in the block below.",
+    "",
+    block,
+  ].join("\n");
+}
+
+async function upsertAgentsLinksInFile(agentsPath, packageName) {
   const block = buildAgentsLinkBlock(packageName);
 
   if (!(await pathExists(agentsPath))) {
-    const content = ["# agents.md", "", block].join("\n");
+    const content = buildAgentsBootstrapContent(path.basename(agentsPath), block);
     await fs.writeFile(agentsPath, content, "utf8");
     return { created: true, updated: false, path: agentsPath };
   }
@@ -265,10 +278,35 @@ async function upsertAgentsLinks(targetDir, packageName) {
   return { created: false, updated, path: agentsPath };
 }
 
+async function detectAgentsFilePath(targetDir) {
+  try {
+    const entries = await fs.readdir(targetDir, { withFileTypes: true });
+    const match = entries.find(
+      (entry) => entry.isFile() && entry.name.toLowerCase() === "agents.md",
+    );
+    if (match) {
+      return path.join(targetDir, match.name);
+    }
+  } catch {
+    // target directory may not exist yet
+  }
+  return path.join(targetDir, DEFAULT_AGENTS_FILENAME);
+}
+
+async function upsertAgentsLinks(targetDir, packageName) {
+  const agentsPath = await detectAgentsFilePath(targetDir);
+  const result = await upsertAgentsLinksInFile(agentsPath, packageName);
+  return {
+    created: result.created ? [result.path] : [],
+    updated: result.updated ? [result.path] : [],
+    unchanged: !result.created && !result.updated ? [result.path] : [],
+  };
+}
+
 async function syncConfigFiles({ templateRoot, targetDir, values, force }) {
   const sourceConfigRoot = path.join(templateRoot, ".meta-agents", "config");
   const targetConfigRoot = path.join(targetDir, ".meta-agents", "config");
-  const sourceFiles = await walkFiles(sourceConfigRoot);
+  const sourceFiles = ROOT_CONFIG_FILES.map((file) => path.join(sourceConfigRoot, file));
 
   const updated = [];
   const skipped = [];

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

@@ -1,4 +1,6 @@
 project_context:
+  project:
+    name: "__PROJECT_NAME__"
   tracker_provider:
     selected: "__DEFAULT_TRACKER__"
     locked: true

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

@@ -208,7 +208,7 @@ system:
     commit_linkage:
       required: true
       accepted_patterns:
-        - "#issue"
+        - "#<issue-number> <summary>"
     publish_flow:
       changelog_required: true
       release_note_required: true

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

@@ -22,6 +22,9 @@ Tooling:
 - Основной путь: `npm run meta:status`.
 - Для machine-readable вывода можно использовать `npm run meta:status -- --json`.
 - Для веточного preflight по конкретной задаче: `npm run meta:task-start -- --task <#issue> --slug <slug>`.
+- Fallback (если `meta:status` отсутствует в npm scripts):
+  - source repo: `node template/.meta-agents/scripts/sync-status.mjs --json`
+  - generated project: `node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/sync-status.mjs --json`
 
 Rule:
 - В `github` режиме локальные `tasks/*` не считать авторитетным источником по умолчанию; рассматривать только как cache/legacy artifacts.

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

@@ -15,6 +15,7 @@ const TASK_KIND_MAP = {
   release: "release",
   hotfix: "hotfix",
 };
+const GOVERNANCE_CONTEXT_FILES = ["AGENTS.md", "agents.md"];
 
 function git(args, allowFailure = false) {
   try {
@@ -266,6 +267,16 @@ function readFileAtRef(ref, filePath) {
   return git(["show", `${ref}:${filePath}`], true);
 }
 
+function readGovernanceContextAtRef(ref) {
+  for (const filePath of GOVERNANCE_CONTEXT_FILES) {
+    const content = readFileAtRef(ref, filePath);
+    if (content) {
+      return { filePath, content };
+    }
+  }
+  return null;
+}
+
 function getContextWarnings(baseBranch) {
   const warnings = [];
   if (!baseBranch) {
@@ -280,19 +291,19 @@ function getContextWarnings(baseBranch) {
     return warnings;
   }
 
-  const currentAgents = readFileAtRef("HEAD", "agents.md");
-  const baseAgents = readFileAtRef(baseBranch, "agents.md");
+  const currentAgents = readGovernanceContextAtRef("HEAD");
+  const baseAgents = readGovernanceContextAtRef(baseBranch);
 
   if (!currentAgents || !baseAgents) {
     warnings.push(
-      "Cannot compare governance context file 'agents.md' between current and base branch (missing in one of refs).",
+      "Cannot compare governance context file 'AGENTS.md/agents.md' between current and base branch (missing in one of refs).",
     );
     return warnings;
   }
 
-  if (currentAgents !== baseAgents) {
+  if (currentAgents.content !== baseAgents.content) {
     warnings.push(
-      `Governance context differs: 'agents.md' in current branch is not equal to '${baseBranch}:agents.md'. Confirm switch before apply.`,
+      `Governance context differs: '${currentAgents.filePath}' in current branch is not equal to '${baseBranch}:${baseAgents.filePath}'. Confirm switch before apply.`,
     );
   }
 

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

@@ -7,8 +7,8 @@ function readLastCommitSubject(ref = "HEAD") {
 }
 
 function validateMessage(message) {
-  const hasIssueNumber = /#\d+\b/.test(message);
-  return hasIssueNumber;
+  const normalized = String(message || "").trim();
+  return /^#\d+\s+\S.*$/.test(normalized);
 }
 
 function parseArgs(argv) {
@@ -48,7 +48,9 @@ function main() {
     }
 
     if (!validateMessage(message)) {
-      console.error("Commit link FAIL: message must contain #issue.");
+      console.error(
+        "Commit link FAIL: message must match '#<issue-number> <summary>' and start with issue ref.",
+      );
       console.error(`Message: ${message}`);
       process.exit(1);
     }

package/template/README.md

@@ -3,11 +3,10 @@
 Проект инициализирован шаблоном `meta-agents-template`.
 
 ## Что уже подключено
-- `agents.md`: роли, правила и жёсткие критерии приёмки;
-- `tracker-command-template.md`: команды управления задачами и спринтами;
-- `.meta-agents/`: конфигурация системы и шаблоны PRD/verification;
-- `.github/workflows/gitflow-lite-verify.yml`: branch-aware CI-проверки для Git Flow Lite;
-- `tasks/`: backlog/sprint/status-log.
+- `AGENTS.md` (или существующий `agents.md`): локальный bootstrap-файл с ссылками на canonical правила в npm-пакете;
+- `.meta-agents/config/project-context.yaml`: project name + выбранный tracker provider;
+- `.meta-agents/config/trackers.yaml`: lock tracker provider и доступные providers;
+- `meta:*` npm scripts, которые запускают canonical tooling из `node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/*`.
 
 ## Source of truth по tracker provider
 - Выбранный при `init` provider фиксируется в `.meta-agents/config/project-context.yaml`.
@@ -44,7 +43,7 @@
 12. Перед релизом `Publishing Agent` обязан обновить публичный `CHANGELOG.md`.
 
 ## Команды
-Смотри `tracker-command-template.md`.
+Смотри `node_modules/@k0t0vich/meta-agents-template/template/tracker-command-template.md`.
 
 Дополнительно:
 ```bash
@@ -65,7 +64,7 @@ npm run meta:status
 Если передать `--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.
+`meta:task-start` также делает context-protection check для `AGENTS.md` (fallback: `agents.md`) между текущей и базовой веткой и требует явного подтверждения при diff.
 Именование branch task ref: использовать GitHub issue ref в формате `issue-<number>`.
 `meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
 

package/template/agents.md

@@ -148,7 +148,7 @@ Name: <agent role>
 - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
 - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
 - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
-- сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
+- сообщение коммита обязано начинаться с ссылки на задачу и summary в формате `#issue-number <summary>`.
 - `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
 - `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
@@ -172,7 +172,7 @@ Name: <agent role>
 6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
 7. Переключиться на базовую ветку (`develop` или `main`) и обновить её.
 8. Создать новую рабочую ветку по Git Flow Lite.
-9. Перед переключением проверить консистентность `agents.md` между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
+9. Перед переключением проверить консистентность `AGENTS.md` (fallback: `agents.md`) между текущей и базовой веткой; при отличиях показать явное предупреждение и запросить подтверждение пользователя.
 
 Без этого preflight выполнение реализации запрещено.
 
@@ -199,9 +199,9 @@ Name: <agent role>
 19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
 20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
 21. Для релиза обновлён публичный `CHANGELOG.md`.
-22. Коммит содержит ссылку на issue (`#issue`).
+22. Коммит следует формату `#issue-number <summary>` (issue ref в начале сообщения).
 23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
-24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
+24. Перед `--apply` подтверждена консистентность контекста `AGENTS.md` (fallback: `agents.md`) или явно подтверждён осознанный switch при diff.
 
 Если хотя бы один критерий не выполнен, задача не принимается.
 

package/template/package.json

@@ -3,15 +3,15 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
-    "meta:status": "node .meta-agents/scripts/sync-status.mjs",
-    "meta:branch": "node .meta-agents/scripts/verify-branch-strategy.mjs",
-    "meta:task-start": "node .meta-agents/scripts/task-branch-router.mjs",
-    "meta:verify": "node .meta-agents/scripts/verify-governance.mjs",
-    "meta:review": "node .meta-agents/scripts/run-review-gate.mjs",
-    "meta:review-approve": "node .meta-agents/scripts/run-review-gate.mjs --approve yes",
-    "meta:mr-review": "node .meta-agents/scripts/run-mr-review-gate.mjs",
-    "meta:mr-review-approve": "node .meta-agents/scripts/run-mr-review-gate.mjs --approve yes",
-    "meta:verify-link": "node .meta-agents/scripts/verify-commit-link.mjs",
-    "meta:ops": "node .meta-agents/scripts/tracker-gateway.mjs"
+    "meta:status": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/sync-status.mjs",
+    "meta:branch": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/verify-branch-strategy.mjs",
+    "meta:task-start": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/task-branch-router.mjs",
+    "meta:verify": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/verify-governance.mjs",
+    "meta:review": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/run-review-gate.mjs",
+    "meta:review-approve": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/run-review-gate.mjs --approve yes",
+    "meta:mr-review": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/run-mr-review-gate.mjs",
+    "meta:mr-review-approve": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/run-mr-review-gate.mjs --approve yes",
+    "meta:verify-link": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/verify-commit-link.mjs",
+    "meta:ops": "node ./node_modules/@k0t0vich/meta-agents-template/template/.meta-agents/scripts/tracker-gateway.mjs"
   }
 }

package/template/tracker-command-template.md

@@ -67,8 +67,8 @@ result PASS
 - branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
 - если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
 - если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
-- перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
-- сообщение коммита обязательно содержит `#issue-number`.
+- перед `--apply` обязателен контекстный check: сравнить `AGENTS.md` (fallback: `agents.md`) текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
+- сообщение коммита обязательно следует формату `#issue-number <summary>` (issue ref в начале).
 
 Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
 - `TODO`
@@ -187,7 +187,7 @@ tracker __DEFAULT_TRACKER__,
 task "#12",
 task kind "atomic",
 command "npm run meta:task-start -- --task #12 --slug api-redirect",
-user dialogue "confirm branch context + dirty/ahead handling + agents.md context warning + switch decision"
+user dialogue "confirm branch context + dirty/ahead handling + AGENTS.md context warning + switch decision"
 ```
 
 ### SET_STATUS -> REVIEW (обязателен перед review gate)
@@ -257,7 +257,7 @@ Agile Manager Agent: commit by name,
 tracker __DEFAULT_TRACKER__,
 task "API редирект офферов",
 issue 12,
-commit message "#12 | API редирект офферов",
+commit message "#12 API редирект офферов",
 push yes,
 branch "feature/issue-12-api-redirect",
 open mr "optional",

package/agents.md

@@ -1,226 +0,0 @@
-# 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) Назначение системы
-Система работает как мета-оркестрация разработки: сначала формализуем задачу и проверяемость, потом делаем реализацию.
-
-Базовый поток:
-`clarify -> PRD step -> verification design -> decomposition -> execution -> evidence -> acceptance`
-
-Главный принцип:
-`acceptance-first` и `verification-first`.
-
-## 2) Обязательный PRD на каждом шаге
-Каждый этап (уточнение, архитектура, декомпозиция, реализация, ревью) обязан иметь PRD-запись в строгом порядке:
-
-1. `Описание`.
-2. `Проверяемость`.
-3. `Что сделано`.
-
-Правило запуска этапа:
-- если не заполнены `Описание` и `Проверяемость`, этап не стартует.
-
-## 3) Роли агентов
-- `Chief of Staff Agent`: оркестрация цепочки, приоритеты, блокеры, эскалации.
-- `Status Agent`: сводный статус проекта (`tracker/sprint/task/git`) по запросам состояния.
-- `Agile Manager Agent`: операции по задачам/спринтам/статусам/коммитам через трекер.
-- `Governance Watchdog Agent`: обязательный контроль PRD/критериев/разрешений перед каждой командой.
-- `Product Manager Agent`: формулирует PRD и критерии приёмки.
-- `Solution Architect Agent`: проектирует архитектуру и контракты компонентов.
-- `Verifier Designer Agent`: проектирует модель валидации и evidence-план.
-- `Decomposer Agent`: режет систему на проверяемые компоненты.
-- `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`).
-
-Обязательный префикс:
-```text
-[Agent Auto-Select]
-Selected: <agent role>
-Reason: <short reason>
-
-[Task Agent]
-Name: <agent role>
-```
-
-Правило исполнения:
-- если префикс не выведен, задача/команда не выполняется;
-- если пользователь явно указал роль, она используется, но блок `Task Agent` обязателен.
-
-## 5) Единица работы: Verified Component
-Каждый компонент обязан иметь:
-- цель;
-- входы/выходы;
-- ограничения и инварианты;
-- критерии приёмки;
-- стратегию проверки;
-- required evidence;
-- владельца компонента;
-- ссылку на PRD-этап.
-
-## 6) Типы валидации
-- `strict`: схемы, типы, правила, инварианты, policy, state transitions.
-- `statistical`: benchmark/метрики/judge score/пороговые значения.
-- `human`: review/approval в рискованных и неоднозначных точках.
-
-## 7) AgentWorkContract
-Перед передачей задачи Executor-агенту фиксируется контракт:
-- scope;
-- допустимая свобода решений;
-- required outputs;
-- required evidence;
-- acceptance criteria;
-- failure/escalation правила;
-- трекерная привязка (`task_id`, `tracker_provider`, `sprint`).
-
-Без контракта делегирование запрещено.
-
-## 8) TrackerGateway
-Трекер выделяется в отдельный адаптерный слой, независимый от ролей агентов.
-
-`TrackerGateway` поддерживает провайдеры:
-- `local`;
-- `github`;
-- `mcp` (alias `mpc`);
-- `custom`.
-
-Режим по умолчанию для командной работы: `github` (или другой внешний трекер). `local` используется как fallback.
-
-## 9) Канонические команды
-Все рабочие операции проходят через `Agile Manager Agent` + `TrackerGateway`.
-Операционные шаблоны команд: [tracker-command-template.md](./tracker-command-template.md).
-
-0. `VERIFY_GOVERNANCE_GATE`
-1. `CREATE_TASK`
-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) Коммиты и закрытие задач: только по подтверждению пользователя
-Запрещено выполнять автоматически:
-- `COMMIT_BY_NAME`;
-- перевод задачи в `DONE`.
-
-Обязательное правило:
-- для режима `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` не допускается.
-- сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
-- `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
-- `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
-- `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`.
-
-## 10.2) Обязательная маршрутизация ветки для Agile Manager Agent
-Перед началом реализации агент обязан:
-1. Проверить веточный контекст через `meta:status`.
-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 выполнение реализации запрещено.
-
-## 11) Жёсткие критерии приёмки (все обязательны)
-Задача принимается только если одновременно выполнены все условия:
-1. Заполнены все PRD-блоки этапа: `Описание`, `Проверяемость`, `Что сделано`.
-2. Выполнен обязательный префикс `Agent Auto-Select` + `Task Agent`.
-3. Пройдены все обязательные `strict` проверки.
-4. `statistical` метрики не ниже зафиксированных порогов.
-5. Пройдены обязательные `human` approvals.
-6. Собран полный evidence-пакет (артефакты, логи, ссылки на проверки).
-7. Синхронизированы `task/status/sprint` в трекере.
-8. Если был коммит, есть явное подтверждение пользователя на коммит.
-9. Если задача закрыта в `DONE`, есть явное подтверждение пользователя на закрытие.
-10. Перед каждой командой пройден `VERIFY_GOVERNANCE_GATE` от `Governance Watchdog Agent`.
-11. Перед коммитом пройден `RUN_REVIEW_GATE` от `Reviewer/Judge Agent`.
-12. Есть явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
-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 (`#issue`).
-23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
-24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
-
-Если хотя бы один критерий не выполнен, задача не принимается.
-
-## 12) Verification-first gate
-Реализация не начинается, пока не определены:
-- acceptance criteria;
-- метрики и пороги;
-- инварианты и ограничения;
-- процедуры проверки;
-- зоны неопределённости и правила эскалации;
-- способ фиксации в трекере.
-
-## 13) Реакция на провал проверки
-Допустимые сценарии:
-- `retry` с корректировками;
-- пересмотр архитектуры;
-- уточнение критериев;
-- эскалация пользователю/founder;
-- возврат статуса задачи в `IN_PROGRESS` или `BLOCKED`.
-
-## 14) Главный инвариант
-Нельзя делегировать работу и нельзя закрывать задачу без формализованных критериев приёмки, PRD-блока `Проверяемость` и требуемых доказательств в трекере.

package/tracker-command-template.md

@@ -1,439 +0,0 @@
-# Tracker Command Template
-
-## 0) Обязательный префикс перед каждой задачей
-Перед любой командой сначала выводится:
-
-```text
-[Agent Auto-Select]
-Selected: <agent role>
-Reason: <short reason>
-
-[Task Agent]
-Name: <agent role>
-```
-
-Без этого префикса выполнение команды запрещено.
-
-## 0.1) Обязательный governance gate
-Перед любой командой сначала выполняется проверка:
-
-```text
-[Agent Auto-Select]
-Selected: Governance Watchdog Agent
-Reason: Обязательная проверка соблюдения PRD и критериев приёмки перед операцией.
-
-[Task Agent]
-Name: Governance Watchdog Agent
-
-Governance Watchdog Agent: verify governance gate,
-task <#issue>,
-required checks "prd_sections_complete, acceptance_defined, user_confirmation_policy_respected",
-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`.
-
-Дополнительно для коммита:
-- для `git_flow_lite` используется цикл `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
-- рабочие ветки: `feature/*`, `release/*`, `hotfix/*`; долгоживущие ветки: `develop`, `main`;
-- правила 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);
-- branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
-- если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
-- если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
-- перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
-- сообщение коммита обязательно содержит `#issue-number`.
-
-Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
-- `TODO`
-- `IN_PROGRESS`
-- `REVIEW`
-- `READY`
-- `BLOCKED`
-- `DONE`
-- `PUBLISH`
-
-Семантика статусов:
-- `READY`: коммит сделан и отправлен (`push`) в `feature/*|release/*|hotfix/*`; открыт PR в `develop` или `main` согласно правилам ветвления.
-- `DONE`: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
-- `PUBLISH`: релиз опубликован и доступен в последней версии пакета.
-
-Правило больших фич (GitHub tracker):
-- если фича крупная, агент обязан предложить `feature issue` + `epic issue` и отдельную ветку;
-- epic в GitHub оформляется как issue с label `type:epic`;
-- feature оформляется как issue с label `type:feature` и ссылкой на epic.
-
-## 2) Канонические команды (через Agile Manager Agent / Reviewer/Judge Agent / MR Review Agent / Publishing Agent / Status Agent)
-### VERIFY_GOVERNANCE_GATE
-```text
-[Agent Auto-Select]
-Selected: Governance Watchdog Agent
-Reason: Нужна обязательная preflight-проверка процесса.
-
-[Task Agent]
-Name: Governance Watchdog Agent
-
-Governance Watchdog Agent: verify governance gate,
-task #12,
-checklist "PRD(Описание+Проверяемость), hard criteria, user confirmation policy",
-result PASS
-```
-
-### RUN_REVIEW_GATE (обязателен перед коммитом)
-```text
-[Agent Auto-Select]
-Selected: Reviewer/Judge Agent
-Reason: Нужен обязательный pre-commit review.
-
-[Task Agent]
-Name: Reviewer/Judge Agent
-
-Reviewer/Judge Agent: run review gate,
-task #12,
-checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
-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 #12,
-approve yes,
-result PASS_CONFIRMED
-```
-
-### CREATE_TASK
-```text
-[Agent Auto-Select]
-Selected: Agile Manager Agent
-Reason: Нужна операция создания задачи в трекере.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-Agile Manager Agent: create task,
-tracker github,
-repo your-org/your-repo,
-short name "API редирект офферов",
-owner "Engineering Agent",
-description "Добавить API редиректа на офферы",
-verifiability "strict: schema+contracts; statistical: p95 latency < 200ms",
-sprint "SPRINT-3"
-```
-
-### SET_STATUS
-```text
-[Agent Auto-Select]
-Selected: Agile Manager Agent
-Reason: Нужна операция смены статуса задачи.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-Agile Manager Agent: set status,
-tracker github,
-task #12,
-status IN_PROGRESS,
-reason "начата реализация"
-```
-
-### PREPARE_TASK_BRANCH (обязателен перед реализацией)
-```text
-[Agent Auto-Select]
-Selected: Agile Manager Agent
-Reason: Нужно проверить соответствие задачи текущей ветке и выбрать корректный Git Flow маршрут.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-Agile Manager Agent: prepare task branch,
-tracker 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]
-Selected: Agile Manager Agent
-Reason: Реализация завершена, задача передаётся в review.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-Agile Manager Agent: set status,
-tracker github,
-task #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]
-Selected: Agile Manager Agent
-Reason: Нужна операция фиксации результата по задаче.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-[User Confirmation]
-Commit Approved: yes
-
-Agile Manager Agent: commit by name,
-tracker github,
-task "API редирект офферов",
-issue 12,
-commit message "#12 | API редирект офферов",
-push yes,
-branch "feature/issue-12-api-redirect",
-open mr "optional",
-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 #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 #12,
-pr 34,
-approve yes,
-result PASS_CONFIRMED
-```
-
-### 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 #12,
-status PUBLISH,
-reason "релиз опубликован в latest"
-```
-
-### SET_STATUS -> DONE (только после подтверждения пользователя)
-```text
-[Agent Auto-Select]
-Selected: Agile Manager Agent
-Reason: Нужна операция закрытия задачи.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-[User Confirmation]
-Close Task Approved: yes
-
-Agile Manager Agent: set status,
-tracker github,
-task #12,
-status DONE,
-reason "пользователь подтвердил закрытие"
-```
-
-### ASSIGN_SPRINT
-```text
-[Agent Auto-Select]
-Selected: Agile Manager Agent
-Reason: Нужна операция назначения задачи в спринт.
-
-[Task Agent]
-Name: Agile Manager Agent
-
-Agile Manager Agent: assign sprint,
-tracker github,
-task #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 "npm run meta:status"
-```
-
-### 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>
-
-### Описание
-- Что и зачем делаем на этом шаге.
-
-### Проверяемость
-- strict:
-- statistical:
-- human:
-- evidence:
-
-### Что сделано
-- [ ] Не начато
-- Ссылки на артефакты:
-- Ссылки на проверки:
-```
-
-## 4) Минимальный операционный цикл
-1. `VERIFY_GOVERNANCE_GATE`.
-2. `CREATE_TASK`.
-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` для всех вошедших задач).