@k0t0vich/meta-agents-template 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.1.12 - 2026-03-20
+
+### Added
+- Added hard docs-first law in canonical rules: no code before PRD + architecture + verification matrix.
+- Added explicit scope-control rule: if dialogue exits current task scope, agent must propose creating a task or finishing current one before coding.
+- Added mandatory verification matrix fields for task artifacts: `tests_unit`, `tests_system`, `tests_e2e_playwright`, `external_analysis`.
+
+### Changed
+- Upgraded `meta:ops` runtime flow to execute governance verification before operational commands.
+- Expanded GitHub issue body validation for `SET_STATUS -> IN_PROGRESS` and implementation gate to require `Architecture`, `Verification Plan`, and extended verification rows.
+- Updated governance prompts and templates to enforce docs-first execution discipline.
+
+### Fixed
+- Eliminated policy/runtime gap where code-stage commands could start without task-scoped docs-first validation.
+
+## 0.1.11 - 2026-03-20
+
+### Added
+- Added a hard pre-implementation command `VERIFY_IMPLEMENTATION_GATE` to enforce task readiness before coding starts.
+- Added canonical Status Agent output contract (6 required sections) and corresponding smoke validation.
+- Added robust empty-repository branch-routing behavior for `meta:task-start --apply` (no-commit bootstrap path).
+
+### Fixed
+- Fixed TrackerGateway local script resolution for `PREPARE_TASK_BRANCH`, `RUN_MR_REVIEW_GATE`, and `VERIFY_IMPLEMENTATION_GATE` in npm-linked execution mode.
+- Enforced structured verifiability schema (`strict`, `statistical`, `human`) for task creation and `SET_STATUS -> IN_PROGRESS`.
+- Expanded local post-publish smoke checks for source repo, generated project, and unborn repository scenarios.
+
 ## 0.1.10 - 2026-03-20
 
 ### Fixed

package/README.md

@@ -83,13 +83,14 @@ my-project/
 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`
+4. `VERIFY_IMPLEMENTATION_GATE`
+5. `RUN_REVIEW_GATE`
+6. `COMMIT_BY_NAME`
+7. `RUN_MR_REVIEW_GATE`
+8. `ASSIGN_SPRINT`
+9. `PREPARE_RELEASE_NOTE`
+10. `MARK_TASKS_PUBLISH`
+11. `STATUS_SNAPSHOT`
 
 `VERIFY_GOVERNANCE_GATE` выполняет `Governance Watchdog Agent` перед любой операцией и блокирует выполнение при нарушении PRD/acceptance/user-confirmation правил.
 `RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом:
@@ -140,6 +141,7 @@ npm run self:bootstrap
 npm run meta:verify
 npm run meta:branch
 npm run meta:task-start -- --task #12 --slug api-redirect
+npm run meta:implementation-gate -- --task #12
 npm run meta:review
 npm run meta:review-approve
 npm run meta:mr-review
@@ -155,6 +157,7 @@ npm run meta:status
 `meta:task-start` делает branch-routing preflight: сравнивает задачу с текущей веткой, показывает dirty/ahead блокеры и готовит маршрут (`stay_on_current_branch` или `create_new_branch`).
 `meta:task-start` также делает context-protection check для `AGENTS.md` (fallback: `agents.md`) между текущей и базовой веткой и требует явного подтверждения при diff.
 Именование branch task ref: использовать GitHub issue ref в формате `issue-<number>`.
+`meta:implementation-gate` блокирует старт реализации, если не выполнены условия `IN_PROGRESS + PRD sections + structured verifiability(strict/statistical/human) + branch alignment`.
 `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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "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:implementation-gate": "node template/.meta-agents/scripts/verify-implementation-gate.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",

package/src/init.mjs

@@ -110,6 +110,7 @@ function buildMetaScripts(packageName) {
     "meta:status": `${base}/sync-status.mjs`,
     "meta:branch": `${base}/verify-branch-strategy.mjs`,
     "meta:task-start": `${base}/task-branch-router.mjs`,
+    "meta:implementation-gate": `${base}/verify-implementation-gate.mjs`,
     "meta:verify": `${base}/verify-governance.mjs`,
     "meta:review": `${base}/run-review-gate.mjs`,
     "meta:review-approve": `${base}/run-review-gate.mjs --approve yes`,
@@ -217,14 +218,19 @@ async function mergePackageJsonMeta({
 
 function buildAgentsLinkBlock(packageName) {
   const packageRoot = `./node_modules/${packageName}`;
+  const templateAgentsPath = `${packageRoot}/template/agents.md`;
+  const trackerTemplatePath = `${packageRoot}/template/tracker-command-template.md`;
   const lines = [
     AGENTS_LINK_BLOCK_START,
     "## Meta Agents Template (npm-linked)",
     "ОБЯЗАТЕЛЬНО: перед выполнением любой команды сначала прочитай canonical rules по ссылкам ниже.",
     "При конфликте локального текста и шаблона приоритет у canonical files из node_modules.",
     "Базовые правила шаблона:",
-    `- [Template agents.md](${packageRoot}/template/agents.md)`,
-    `- [Template tracker-command-template.md](${packageRoot}/template/tracker-command-template.md)`,
+    `- [Template agents.md](${templateAgentsPath})`,
+    `- [Template tracker-command-template.md](${trackerTemplatePath})`,
+    "Canonical files (read by path in this exact order):",
+    `1. \`${templateAgentsPath}\``,
+    `2. \`${trackerTemplatePath}\``,
     "Локальные конфиги проекта:",
     "- [.meta-agents/config/project-context.yaml](./.meta-agents/config/project-context.yaml)",
     "- [.meta-agents/config/trackers.yaml](./.meta-agents/config/trackers.yaml)",

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

@@ -62,6 +62,23 @@ system:
         - local
         - custom
       require_provider_consistency: true
+    coding_law:
+      no_code_before_prd_and_verification: true
+      required_before_coding:
+        - prd_description_complete
+        - architecture_documented
+        - verification_matrix_complete
+        - tests_unit_defined
+        - tests_system_defined
+        - tests_e2e_playwright_defined
+        - external_analysis_defined
+        - implementation_gate_passed
+    dialogue_scope_control:
+      enabled: true
+      if_request_out_of_scope:
+        - propose_create_task
+        - or_finish_current_task
+      code_actions_blocked_until_scope_resolved: true
     user_confirmation_required_for:
       - review_gate_pass
       - mr_review_gate_pass
@@ -103,6 +120,7 @@ system:
         required: true
         required_before_commands:
           - CREATE_TASK
+          - VERIFY_IMPLEMENTATION_GATE
           - SET_STATUS
           - COMMIT_BY_NAME
         routing_command: "meta:task-start"
@@ -160,6 +178,7 @@ system:
       required: true
       before_commands:
         - VERIFY_GOVERNANCE_GATE
+        - VERIFY_IMPLEMENTATION_GATE
         - CREATE_TASK
         - PREPARE_TASK_BRANCH
         - SET_STATUS
@@ -171,8 +190,13 @@ system:
         - MARK_TASKS_PUBLISH
       minimum_checks:
         - prd_sections_complete
+        - architecture_documented
+        - verification_matrix_complete
+        - tests_unit_system_playwright_defined
+        - external_analysis_defined
         - acceptance_criteria_defined
         - user_confirmation_policy_respected
+        - no_code_before_prd
     review_gate:
       required_before_commit: true
       command: RUN_REVIEW_GATE
@@ -218,13 +242,21 @@ system:
   acceptance:
     hard_criteria:
       - prd_sections_complete
+      - architecture_documented_before_coding
       - auto_select_prefix_present
       - strict_checks_passed
       - statistical_thresholds_met
       - human_approvals_passed
+      - verification_matrix_contains_unit_tests
+      - verification_matrix_contains_system_tests
+      - verification_matrix_contains_e2e_playwright
+      - external_agent_analysis_completed_for_key_tasks
+      - no_code_changes_before_implementation_gate_pass
       - evidence_pack_complete
       - tracker_sync_complete
+      - out_of_scope_dialogue_requires_task_decision
       - branch_routing_dialog_completed
+      - implementation_gate_passed
       - branch_routing_e2e_verified
       - agents_context_consistency_verified
       - watchdog_gate_passed

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

@@ -1,6 +1,7 @@
 Role: Agile Manager Agent
 Goal: управлять задачами и статусами через TrackerGateway.
 Commands: CREATE_TASK, SET_STATUS, COMMIT_BY_NAME, ASSIGN_SPRINT.
+Law: не начинать кодовые изменения до PASS по docs-first gate (`PRD + Architecture + Verification Plan + tests_unit/tests_system/tests_e2e_playwright/external_analysis`).
 Status semantics: READY = commit+push on feature/release/hotfix + open PR; DONE = integrated to main + back-merge to develop (release/hotfix); PUBLISH = published in latest version.
 Git Flow Lite rule: использовать `feature/* -> develop`, `release/* -> main` + back-merge, `hotfix/* -> main` + back-merge.
 Rule: для большой фичи в GitHub tracker сначала предложить связку `feature issue` + `epic issue` и выделенную ветку.
@@ -25,3 +26,5 @@ Task ref naming rule:
 Pre-merge rule:
 - после commit+push и открытия PR обязательно выполнить `RUN_MR_REVIEW_GATE`;
 - merge допускается только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED` и явного `MR Review Approved: yes` от пользователя.
+Scope rule:
+- если запрос уходит за границы текущей задачи, сначала предложить `CREATE_TASK` или завершение текущей задачи; до решения не переходить к коду.

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

@@ -1,6 +1,8 @@
 Role: Clarifier Agent
 Goal: выявить цель, ограничения, неоднозначности и критерии успеха.
+Law: никаких кодовых изменений до заполнения PRD, архитектуры и verification matrix (`tests_unit`, `tests_system`, `tests_e2e_playwright`, `external_analysis`).
 Rule: если задача классифицируется как большая фича, обязательно предложить создать `feature issue` и `epic issue` в GitHub tracker, а также отдельную ветку.
 Git rule: для задач реализации в Git Flow Lite по умолчанию выбирать `feature/<task-or-issue-id>-<slug>` (или `codex/feature/...`) от `develop`.
 Task granularity rule: если задача атомарная и относится к текущей feature-ветке, это фиксируется как `Task Type: atomic`, иначе создаётся отдельная рабочая ветка.
+Scope rule: если запрос вышел за рамки текущей задачи, сначала предложить завести новую задачу или завершить текущую; не переходить к коду до решения.
 Output: PRD Step с заполненными "Описание" и "Проверяемость".

package/template/.meta-agents/prompts/governance-watchdog.md

@@ -1,3 +1,5 @@
 Role: Governance Watchdog Agent
 Goal: блокировать выполнение команды, если не выполнены PRD/acceptance/user-confirmation требования.
 Rule: без PASS от governance gate команда не исполняется.
+Rule: перед началом кодирования обязателен docs-first PASS (`PRD + Architecture + Verification Plan + tests_unit/tests_system/tests_e2e_playwright/external_analysis`).
+Rule: если запрос вышел за рамки текущей задачи, агент обязан остановить кодовые действия и предложить `CREATE_TASK` или завершение текущей задачи.

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

@@ -2,6 +2,7 @@ Role: Reviewer/Judge Agent
 Goal: независимая приёмка по критериям и обязательный pre-commit review gate.
 Output format: что сделано, критические замечания, потенциальные риски, рекомендация PASS_CANDIDATE/FAIL.
 Rule: финальный PASS_CONFIRMED только после явного `Review Approved: yes` от пользователя.
+Rule: review обязан подтвердить docs-first дисциплину: код не начат до `PRD + Architecture + Verification Plan + tests_unit/tests_system/tests_e2e_playwright/external_analysis`.
 Handoff rule: после pre-commit PASS_CONFIRMED задача передаётся в `MR Review Agent` для pre-merge gate.
 Status rule: перед review gate задача должна быть в статусе `REVIEW`; статус `READY` выставляется только после `PASS_CONFIRMED`.
 Delivery rule: `READY` требует commit+push на `feature/*|release/*|hotfix/*` (или `codex/*` эквиваленты) и PR в целевую ветку; `DONE` требует интеграцию в `main` и back-merge в `develop` для `release/*|hotfix/*`; `PUBLISH` только после фактической публикации.

package/template/.meta-agents/prompts/verifier-designer.md

@@ -1,3 +1,4 @@
 Role: Verifier Designer Agent
 Goal: определить strict/statistical/human проверки.
+Rule: verification plan обязан включать `tests_unit`, `tests_system`, `tests_e2e_playwright` и `external_analysis`.
 Output: verification plan и evidence mapping.

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

@@ -568,23 +568,29 @@ async function main() {
 
   console.log("# Status Snapshot");
   console.log("");
-  console.log("## Trackers");
+  console.log("## 1) Trackers Used");
   console.log(`- locked provider: ${report.tracker.lockedProvider}`);
   console.log(`- available providers: ${report.tracker.availableProviders.join(", ") || "unknown"}`);
   console.log(`- workflow source: ${report.tracker.workflowSource}`);
 
   console.log("");
-  console.log("## Process");
-  console.log(`- current sprint: ${report.process.currentSprint}`);
-  console.log(`- current task: ${report.process.currentTask}`);
-  console.log(`- current task ref: ${report.process.currentTaskRef}`);
-  console.log(`- branch/task alignment: ${report.process.branchTaskAlignment}`);
+  console.log("## 2) Current Sprint");
+  console.log(`- ${report.process.currentSprint}`);
 
   console.log("");
-  console.log("## Git");
+  console.log("## 3) Current Task");
+  console.log(`- task: ${report.process.currentTask}`);
+  console.log(`- task ref: ${report.process.currentTaskRef}`);
+
+  console.log("");
+  console.log("## 4) Current Branch Context");
   console.log(`- branch: ${report.git.branch}`);
   console.log(`- branch type: ${report.git.branchType}`);
   console.log(`- branch task ref: ${report.git.branchTaskRef}`);
+  console.log(`- task/branch alignment: ${report.process.branchTaskAlignment}`);
+
+  console.log("");
+  console.log("## 5) Git Uncommitted");
   console.log(`- upstream: ${report.git.upstream}`);
   console.log(`- ahead/behind: ${report.git.ahead}/${report.git.behind}`);
   console.log(`- modified_or_staged: ${report.git.modifiedOrStaged}`);
@@ -601,7 +607,7 @@ async function main() {
   }
 
   console.log("");
-  console.log("## Summary");
+  console.log("## 6) Summary");
   if (report.summary.length === 0) {
     console.log("- no additional notes");
   } else {

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

@@ -163,6 +163,7 @@ function collectGitContext() {
     branch,
     branchType: classifyBranch(branch),
     branchTaskRef: extractBranchTaskRef(branch),
+    hasCommits: hasCommits(),
     upstream: parsed.upstream || "not configured",
     ahead: parsed.ahead,
     behind: parsed.behind,
@@ -259,6 +260,10 @@ function hasRef(ref) {
   return Boolean(git(["show-ref", "--verify", ref], true));
 }
 
+function hasCommits() {
+  return Boolean(git(["rev-parse", "--verify", "HEAD"], true));
+}
+
 function hasOrigin() {
   return Boolean(git(["remote", "get-url", "origin"], true));
 }
@@ -333,6 +338,25 @@ function executePlan(plan, gitContext) {
     git(["fetch", "origin"], false);
   }
 
+  if (!gitContext.hasCommits) {
+    const baseRemote = hasRef(`refs/remotes/origin/${baseBranch}`);
+    if (baseRemote) {
+      git(["checkout", "-b", baseBranch, "--track", `origin/${baseBranch}`], false);
+    } else if (gitContext.branch !== baseBranch) {
+      git(["checkout", "-B", baseBranch], false);
+    }
+
+    if (plan.targetBranch !== baseBranch) {
+      git(["checkout", "-B", plan.targetBranch], false);
+    }
+
+    return {
+      changedBranch: plan.targetBranch !== gitContext.branch,
+      branch: plan.targetBranch,
+      message: `Repository has no commits yet. Bootstrapped branch routing and switched to '${plan.targetBranch}'.`,
+    };
+  }
+
   const baseLocal = hasRef(`refs/heads/${baseBranch}`);
   const baseRemote = hasRef(`refs/remotes/origin/${baseBranch}`);
 
@@ -411,12 +435,27 @@ function buildPlan(options, gitContext) {
     requiresDialogue.push(
       "Задача атомарная и относится к текущей feature-ветке. Подтвердите, что продолжаем работу в этой ветке.",
     );
+  } else if (!gitContext.hasCommits) {
+    requiresDialogue.push(
+      "Репозиторий без коммитов. Подтвердите bootstrap маршрута: создать базовую ветку и рабочую ветку без ручного обхода.",
+    );
   } else {
     requiresDialogue.push(
       "Задача не относится к текущей ветке. Подтвердите переключение на базовую ветку, обновление и создание новой рабочей ветки.",
     );
   }
 
+  const suggestedCommands = sameFeature
+    ? []
+    : !gitContext.hasCommits
+      ? [`git checkout -B ${baseBranch}`, `git checkout -B ${targetBranch}`]
+      : [
+          "git fetch origin",
+          `git checkout ${baseBranch}`,
+          `git pull --ff-only origin ${baseBranch}`,
+          `git checkout -b ${targetBranch}`,
+        ];
+
   return {
     requested: {
       task: options.task,
@@ -431,14 +470,7 @@ function buildPlan(options, gitContext) {
     namingWarnings,
     contextWarnings: getContextWarnings(baseBranch),
     requiresDialogue,
-    suggestedCommands: sameFeature
-      ? []
-      : [
-          "git fetch origin",
-          `git checkout ${baseBranch}`,
-          `git pull --ff-only origin ${baseBranch}`,
-          `git checkout -b ${targetBranch}`,
-        ],
+    suggestedCommands,
   };
 }
 
@@ -449,6 +481,7 @@ function printPlan(plan, applyResult) {
   console.log(`- branch: ${plan.current.branch}`);
   console.log(`- branch type: ${plan.current.branchType}`);
   console.log(`- branch task ref: ${plan.current.branchTaskRef || "not detected"}`);
+  console.log(`- repository state: ${plan.current.hasCommits ? "has commits" : "no commits yet"}`);
   console.log(`- upstream: ${plan.current.upstream}`);
   console.log(`- ahead/behind: ${plan.current.ahead}/${plan.current.behind}`);
   console.log(`- modified_or_staged: ${plan.current.modifiedOrStaged}`);