@k0t0vich/meta-agents-template 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,13 @@
2
2
 
3
3
  All notable changes to this package are documented in this file.
4
4
 
5
+ ## 0.1.6 - 2026-03-20
6
+
7
+ ### Changed
8
+ - Switched governance/process docs to a single canonical task reference: GitHub `#issue`.
9
+ - Removed mixed prefixed task-id examples (`GOV-*`, `REL-*`, `DOC-*`, `DEV-*`) from workflow commands and policy text.
10
+ - 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).
11
+
5
12
  ## 0.1.5 - 2026-03-20
6
13
 
7
14
  ### Changed
package/README.md CHANGED
@@ -133,7 +133,7 @@ npm run self:bootstrap
133
133
  10. Есть отдельное явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
134
134
  11. Перед merge пройден MR review gate (`RUN_MR_REVIEW_GATE`) с финальным `PASS_CONFIRMED`.
135
135
  12. Есть отдельное явное подтверждение пользователя на MR review (`MR Review Approved: yes`).
136
- 13. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
136
+ 13. Каждый коммит связан с issue (`#issue` в commit message).
137
137
 
138
138
  Если хотя бы один пункт не выполнен, задача не принимается.
139
139
 
@@ -143,14 +143,14 @@ npm run self:bootstrap
143
143
  ```bash
144
144
  npm run meta:verify
145
145
  npm run meta:branch
146
- npm run meta:task-start -- --task GOV-1 --slug api-redirect
146
+ npm run meta:task-start -- --task #12 --slug api-redirect
147
147
  npm run meta:review
148
148
  npm run meta:review-approve
149
149
  npm run meta:mr-review
150
150
  npm run meta:mr-review-approve
151
151
  npm run meta:verify-link
152
- npm run meta:ops -- --command SET_STATUS --payload '{"task":"DEV-12","status":"IN_PROGRESS"}'
153
- npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"GOV-1","slug":"api-redirect"}'
152
+ npm run meta:ops -- --command SET_STATUS --payload '{"task":"#12","status":"IN_PROGRESS"}'
153
+ npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"#12","slug":"api-redirect"}'
154
154
  npm run meta:status
155
155
  ```
156
156
 
@@ -158,7 +158,7 @@ npm run meta:status
158
158
  `meta:branch` валидирует ветку по Git Flow Lite (`main`, `develop`, `feature/*`, `release/*`, `hotfix/*`).
159
159
  `meta:task-start` делает branch-routing preflight: сравнивает задачу с текущей веткой, показывает dirty/ahead блокеры и готовит маршрут (`stay_on_current_branch` или `create_new_branch`).
160
160
  `meta:task-start` также делает context-protection check для `agents.md` между текущей и базовой веткой и требует явного подтверждения при diff.
161
- Именование branch task ref: по умолчанию использовать префиксные ID (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); для чистого GitHub issue fallback формат `issue-<number>`.
161
+ Именование branch task ref: использовать GitHub issue ref в формате `issue-<number>`.
162
162
  `meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
163
163
  `meta:status` отдаёт единый статус-срез: trackers used, current sprint, current task, current branch context, git uncommitted и summary.
164
164
  В `github` режиме локальные `tasks/*` по умолчанию считаются cache/legacy и не являются источником истины.
package/agents.md CHANGED
@@ -148,7 +148,7 @@ Name: <agent role>
148
148
  - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
149
149
  - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
150
150
  - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
151
- - сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
151
+ - сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
152
152
  - `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
153
153
  - `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
154
154
  - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
@@ -165,8 +165,8 @@ Name: <agent role>
165
165
  ## 10.2) Обязательная маршрутизация ветки для Agile Manager Agent
166
166
  Перед началом реализации агент обязан:
167
167
  1. Проверить веточный контекст через `meta:status`.
168
- 2. Запустить branch-routing preflight через `meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
169
- 3. В названии рабочей ветки использовать task ref с префиксом (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); если есть только issue number, использовать `issue-<number>`.
168
+ 2. Запустить branch-routing preflight через `meta:task-start -- --task <#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
169
+ 3. В названии рабочей ветки использовать GitHub issue ref в формате `issue-<number>` (например, `feature/issue-21-canonical-github-issue-id`).
170
170
  4. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
171
171
  5. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
172
172
  6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
@@ -199,7 +199,7 @@ Name: <agent role>
199
199
  19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
200
200
  20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
201
201
  21. Для релиза обновлён публичный `CHANGELOG.md`.
202
- 22. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
202
+ 22. Коммит содержит ссылку на issue (`#issue`).
203
203
  23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
204
204
  24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
205
205
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k0t0vich/meta-agents-template",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "description": "Template system for verification-first agentic development",
5
5
  "type": "module",
6
6
  "bin": {
@@ -87,12 +87,8 @@ system:
87
87
  release: "release/vX.Y.Z"
88
88
  hotfix: "hotfix/<task-ref>-<slug>"
89
89
  task_ref_policy:
90
- preferred_format:
91
- - "GOV-<n>"
92
- - "REL-<n>"
93
- - "DOC-<n>"
94
- - "DEV-<n>"
95
- issue_fallback_format: "issue-<number>"
90
+ canonical_format: "#<number>"
91
+ branch_format: "issue-<number>"
96
92
  allowed_branch_patterns:
97
93
  - "^main$"
98
94
  - "^develop$"
@@ -212,7 +208,6 @@ system:
212
208
  commit_linkage:
213
209
  required: true
214
210
  accepted_patterns:
215
- - "TASK-ID"
216
211
  - "#issue"
217
212
  publish_flow:
218
213
  changelog_required: true
@@ -7,7 +7,7 @@ Rule: для большой фичи в GitHub tracker сначала предл
7
7
 
8
8
  Branch routing protocol (обязателен для задач реализации):
9
9
  1. Сначала снять контекст: `npm run meta:status -- --json`.
10
- 2. Проверить маршрут ветки: `npm run meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic`.
10
+ 2. Проверить маршрут ветки: `npm run meta:task-start -- --task <#issue> --slug <slug> --kind atomic`.
11
11
  3. Если `route=stay_on_current_branch`, задача считается атомарной внутри текущей feature-ветки.
12
12
  4. Если `route=create_new_branch`, перед началом реализации обязательно перейти на базовую ветку (`develop` для feature/release, `main` для hotfix), обновить её и создать новую рабочую ветку.
13
13
  5. Создание/переключение ветки выполнять только после явного подтверждения пользователя (`--apply`).
@@ -19,8 +19,8 @@ Mandatory user dialogue before branch switch:
19
19
  - подтвердить финальный switch/create.
20
20
 
21
21
  Task ref naming rule:
22
- - для веток использовать task ref с префиксом (`GOV-1`, `REL-5`, `DOC-2`, `DEV-12`);
23
- - если есть только номер issue, использовать fallback `issue-<number>` в имени ветки.
22
+ - использовать GitHub issue ref как единственный канонический идентификатор (`#<number>`);
23
+ - в имени ветки использовать формат `issue-<number>`.
24
24
 
25
25
  Pre-merge rule:
26
26
  - после commit+push и открытия PR обязательно выполнить `RUN_MR_REVIEW_GATE`;
@@ -21,7 +21,7 @@ Output format (обязательный):
21
21
  Tooling:
22
22
  - Основной путь: `npm run meta:status`.
23
23
  - Для machine-readable вывода можно использовать `npm run meta:status -- --json`.
24
- - Для веточного preflight по конкретной задаче: `npm run meta:task-start -- --task <TASK-ID|#issue> --slug <slug>`.
24
+ - Для веточного preflight по конкретной задаче: `npm run meta:task-start -- --task <#issue> --slug <slug>`.
25
25
 
26
26
  Rule:
27
27
  - В `github` режиме локальные `tasks/*` не считать авторитетным источником по умолчанию; рассматривать только как cache/legacy artifacts.
@@ -390,9 +390,9 @@ function buildPlan(options, gitContext) {
390
390
  );
391
391
  }
392
392
 
393
- if (/^ISSUE-\d+$/.test(taskRef)) {
393
+ if (!/^ISSUE-\d+$/.test(taskRef)) {
394
394
  namingWarnings.push(
395
- "Task ref is issue-based. Branch name will use issue-<number>; prefer domain task refs like GOV-1/REL-1/DOC-1 when available.",
395
+ "Canonical task ref should be GitHub issue number (#<number>) so branch naming stays issue-<number>.",
396
396
  );
397
397
  }
398
398
 
@@ -8,8 +8,7 @@ function readLastCommitSubject(ref = "HEAD") {
8
8
 
9
9
  function validateMessage(message) {
10
10
  const hasIssueNumber = /#\d+\b/.test(message);
11
- const hasTaskId = /\b[A-Z][A-Z0-9_]*-\d+\b/.test(message);
12
- return hasIssueNumber || hasTaskId;
11
+ return hasIssueNumber;
13
12
  }
14
13
 
15
14
  function parseArgs(argv) {
@@ -49,7 +48,7 @@ function main() {
49
48
  }
50
49
 
51
50
  if (!validateMessage(message)) {
52
- console.error("Commit link FAIL: message must contain TASK-ID or #issue.");
51
+ console.error("Commit link FAIL: message must contain #issue.");
53
52
  console.error(`Message: ${message}`);
54
53
  process.exit(1);
55
54
  }
@@ -50,14 +50,14 @@
50
50
  ```bash
51
51
  npm run meta:verify
52
52
  npm run meta:branch
53
- npm run meta:task-start -- --task GOV-1 --slug api-redirect
53
+ npm run meta:task-start -- --task #12 --slug api-redirect
54
54
  npm run meta:review
55
55
  npm run meta:review-approve
56
56
  npm run meta:mr-review
57
57
  npm run meta:mr-review-approve
58
58
  npm run meta:verify-link
59
- npm run meta:ops -- --command SET_STATUS --payload '{"task":"DEV-12","status":"IN_PROGRESS"}'
60
- npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"GOV-1","slug":"api-redirect"}'
59
+ npm run meta:ops -- --command SET_STATUS --payload '{"task":"#12","status":"IN_PROGRESS"}'
60
+ npm run meta:ops -- --command PREPARE_TASK_BRANCH --payload '{"task":"#12","slug":"api-redirect"}'
61
61
  npm run meta:status
62
62
  ```
63
63
 
@@ -66,7 +66,7 @@ npm run meta:status
66
66
  `meta:branch` валидирует ветку по Git Flow Lite (`main`, `develop`, `feature/*`, `release/*`, `hotfix/*`).
67
67
  `meta:task-start` делает branch-routing preflight: сравнивает задачу с текущей веткой, показывает dirty/ahead блокеры и готовит маршрут (`stay_on_current_branch` или `create_new_branch`).
68
68
  `meta:task-start` также делает context-protection check для `agents.md` между текущей и базовой веткой и требует явного подтверждения при diff.
69
- Именование branch task ref: по умолчанию использовать префиксные ID (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); для чистого GitHub issue fallback формат `issue-<number>`.
69
+ Именование branch task ref: использовать GitHub issue ref в формате `issue-<number>`.
70
70
  `meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
71
71
 
72
72
  `meta:status` выдаёт сводный статус:
@@ -148,7 +148,7 @@ Name: <agent role>
148
148
  - без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
149
149
  - `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
150
150
  - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой рабочий поток на `develop`/`main` не допускается.
151
- - сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
151
+ - сообщение коммита обязано содержать ссылку на задачу (`#issue-number`).
152
152
  - `READY` означает: коммит сделан и отправлен (`push`) в `feature/*`, `release/*` или `hotfix/*` с открытым PR по правилам ветвления.
153
153
  - `DONE` означает: изменения интегрированы в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
154
154
  - `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
@@ -165,8 +165,8 @@ Name: <agent role>
165
165
  ## 10.2) Обязательная маршрутизация ветки для Agile Manager Agent
166
166
  Перед началом реализации агент обязан:
167
167
  1. Проверить веточный контекст через `meta:status`.
168
- 2. Запустить branch-routing preflight через `meta:task-start -- --task <TASK-ID|#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
169
- 3. В названии рабочей ветки использовать task ref с префиксом (`GOV-1`, `REL-1`, `DOC-1`, `DEV-1`); если есть только issue number, использовать `issue-<number>`.
168
+ 2. Запустить branch-routing preflight через `meta:task-start -- --task <#issue> --slug <slug> --kind atomic|feature|release|hotfix`.
169
+ 3. В названии рабочей ветки использовать GitHub issue ref в формате `issue-<number>` (например, `feature/issue-21-canonical-github-issue-id`).
170
170
  4. Если задача относится к текущей feature-ветке (атомарная подзадача), продолжить в этой ветке только после подтверждения пользователя.
171
171
  5. Если задача не относится к текущей ветке, проверить незакоммиченные изменения и непушенные коммиты.
172
172
  6. Согласовать с пользователем способ обработки (`commit/stash/discard/push`).
@@ -199,7 +199,7 @@ Name: <agent role>
199
199
  19. Для статуса `DONE` подтверждена интеграция в `main`; для `release/*` и `hotfix/*` подтверждён back-merge в `develop`.
200
200
  20. Для статуса `PUBLISH` подтверждена публикация в последней версии.
201
201
  21. Для релиза обновлён публичный `CHANGELOG.md`.
202
- 22. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
202
+ 22. Коммит содержит ссылку на issue (`#issue`).
203
203
  23. Для branch routing собран e2e evidence по двум сценариям: `same feature` и `different feature`.
204
204
  24. Перед `--apply` подтверждена консистентность контекста `agents.md` (или явно подтверждён осознанный switch при diff).
205
205
 
@@ -1,3 +1,3 @@
1
1
  # Task Status Log
2
2
 
3
- - Format: YYYY-MM-DD | TASK-ID | STATUS | short note
3
+ - Format: YYYY-MM-DD | #issue | STATUS | short note
@@ -26,7 +26,7 @@ Reason: Обязательная проверка соблюдения PRD и к
26
26
  Name: Governance Watchdog Agent
27
27
 
28
28
  Governance Watchdog Agent: verify governance gate,
29
- task <TASK-ID>,
29
+ task <#issue>,
30
30
  required checks "prd_sections_complete, acceptance_defined, user_confirmation_policy_respected",
31
31
  result PASS
32
32
  ```
@@ -64,11 +64,11 @@ result PASS
64
64
  - merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
65
65
  - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
66
66
  - перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
67
- - branch naming policy: использовать task ref с префиксом (`GOV-1`,`REL-1`,`DOC-1`,`DEV-1`); для issue-only задач использовать `issue-<number>`;
67
+ - branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
68
68
  - если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
69
69
  - если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
70
70
  - перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
71
- - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
71
+ - сообщение коммита обязательно содержит `#issue-number`.
72
72
 
73
73
  Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
74
74
  - `TODO`
@@ -100,7 +100,7 @@ Reason: Нужна обязательная preflight-проверка проц
100
100
  Name: Governance Watchdog Agent
101
101
 
102
102
  Governance Watchdog Agent: verify governance gate,
103
- task DEV-12,
103
+ task #12,
104
104
  checklist "PRD(Описание+Проверяемость), hard criteria, user confirmation policy",
105
105
  result PASS
106
106
  ```
@@ -115,7 +115,7 @@ Reason: Нужен обязательный pre-commit review.
115
115
  Name: Reviewer/Judge Agent
116
116
 
117
117
  Reviewer/Judge Agent: run review gate,
118
- task DEV-12,
118
+ task #12,
119
119
  checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
120
120
  result PASS_CANDIDATE,
121
121
  report "posted to issue #12"
@@ -133,7 +133,7 @@ Reason: Подтверждение review пользователем получ
133
133
  Name: Reviewer/Judge Agent
134
134
 
135
135
  Reviewer/Judge Agent: run review gate,
136
- task DEV-12,
136
+ task #12,
137
137
  approve yes,
138
138
  result PASS_CONFIRMED
139
139
  ```
@@ -168,7 +168,7 @@ Name: Agile Manager Agent
168
168
 
169
169
  Agile Manager Agent: set status,
170
170
  tracker __DEFAULT_TRACKER__,
171
- task DEV-12,
171
+ task #12,
172
172
  status IN_PROGRESS,
173
173
  reason "начата реализация"
174
174
  ```
@@ -184,9 +184,9 @@ Name: Agile Manager Agent
184
184
 
185
185
  Agile Manager Agent: prepare task branch,
186
186
  tracker __DEFAULT_TRACKER__,
187
- task "GOV-1",
187
+ task "#12",
188
188
  task kind "atomic",
189
- command "npm run meta:task-start -- --task GOV-1 --slug api-redirect",
189
+ command "npm run meta:task-start -- --task #12 --slug api-redirect",
190
190
  user dialogue "confirm branch context + dirty/ahead handling + agents.md context warning + switch decision"
191
191
  ```
192
192
 
@@ -201,7 +201,7 @@ Name: Agile Manager Agent
201
201
 
202
202
  Agile Manager Agent: set status,
203
203
  tracker __DEFAULT_TRACKER__,
204
- task DEV-12,
204
+ task #12,
205
205
  status REVIEW,
206
206
  reason "готово к review gate"
207
207
  ```
@@ -257,9 +257,9 @@ Agile Manager Agent: commit by name,
257
257
  tracker __DEFAULT_TRACKER__,
258
258
  task "API редирект офферов",
259
259
  issue 12,
260
- commit message "DEV-12 | API редирект офферов (#12)",
260
+ commit message "#12 | API редирект офферов",
261
261
  push yes,
262
- branch "feature/DEV-12-api-redirect",
262
+ branch "feature/issue-12-api-redirect",
263
263
  open mr "optional",
264
264
  target status READY,
265
265
  what done "добавлен endpoint, тесты, обработка ошибок"
@@ -275,7 +275,7 @@ Reason: Нужен обязательный pre-merge review по MR/PR с пр
275
275
  Name: MR Review Agent
276
276
 
277
277
  MR Review Agent: run MR review gate,
278
- task DEV-12,
278
+ task #12,
279
279
  pr 34,
280
280
  checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
281
281
  result PASS_CANDIDATE
@@ -293,7 +293,7 @@ Reason: Подтверждение MR review пользователем полу
293
293
  Name: MR Review Agent
294
294
 
295
295
  MR Review Agent: run MR review gate,
296
- task DEV-12,
296
+ task #12,
297
297
  pr 34,
298
298
  approve yes,
299
299
  result PASS_CONFIRMED
@@ -310,7 +310,7 @@ Name: Agile Manager Agent
310
310
 
311
311
  Agile Manager Agent: set status,
312
312
  tracker __DEFAULT_TRACKER__,
313
- task DEV-12,
313
+ task #12,
314
314
  status PUBLISH,
315
315
  reason "релиз опубликован в latest"
316
316
  ```
@@ -329,7 +329,7 @@ Close Task Approved: yes
329
329
 
330
330
  Agile Manager Agent: set status,
331
331
  tracker __DEFAULT_TRACKER__,
332
- task DEV-12,
332
+ task #12,
333
333
  status DONE,
334
334
  reason "пользователь подтвердил закрытие"
335
335
  ```
@@ -345,7 +345,7 @@ Name: Agile Manager Agent
345
345
 
346
346
  Agile Manager Agent: assign sprint,
347
347
  tracker __DEFAULT_TRACKER__,
348
- task DEV-12,
348
+ task #12,
349
349
  sprint SPRINT-3
350
350
  ```
351
351
 
@@ -26,7 +26,7 @@ Reason: Обязательная проверка соблюдения PRD и к
26
26
  Name: Governance Watchdog Agent
27
27
 
28
28
  Governance Watchdog Agent: verify governance gate,
29
- task <TASK-ID>,
29
+ task <#issue>,
30
30
  required checks "prd_sections_complete, acceptance_defined, user_confirmation_policy_respected",
31
31
  result PASS
32
32
  ```
@@ -64,11 +64,11 @@ result PASS
64
64
  - merge разрешён только после `RUN_MR_REVIEW_GATE: PASS_CONFIRMED`;
65
65
  - для задач реализации по умолчанию используется отдельная ветка `feature/*`; прямой поток на `develop`/`main` запрещён;
66
66
  - перед началом реализации обязателен `PREPARE_TASK_BRANCH` (веточный preflight и user dialogue);
67
- - branch naming policy: использовать task ref с префиксом (`GOV-1`,`REL-1`,`DOC-1`,`DEV-1`); для issue-only задач использовать `issue-<number>`;
67
+ - branch naming policy: использовать только GitHub issue ref в формате `issue-<number>`;
68
68
  - если задача атомарная и относится к текущей feature-ветке, допускается выполнение в текущей ветке после явного подтверждения пользователя;
69
69
  - если задача не относится к текущей ветке, требуется: проверить dirty/ahead, согласовать действие с пользователем, перейти на `develop` (или `main` для hotfix), обновить и создать новую ветку;
70
70
  - перед `--apply` обязателен контекстный check: сравнить `agents.md` текущей и базовой ветки, при diff запросить явное подтверждение пользователя;
71
- - сообщение коммита обязательно содержит `TASK-ID` и/или `#issue-number`.
71
+ - сообщение коммита обязательно содержит `#issue-number`.
72
72
 
73
73
  Для GitHub трекера статус issue задаётся label-ом (одновременно только один статус из набора):
74
74
  - `TODO`
@@ -100,7 +100,7 @@ Reason: Нужна обязательная preflight-проверка проц
100
100
  Name: Governance Watchdog Agent
101
101
 
102
102
  Governance Watchdog Agent: verify governance gate,
103
- task DEV-12,
103
+ task #12,
104
104
  checklist "PRD(Описание+Проверяемость), hard criteria, user confirmation policy",
105
105
  result PASS
106
106
  ```
@@ -115,7 +115,7 @@ Reason: Нужен обязательный pre-commit review.
115
115
  Name: Reviewer/Judge Agent
116
116
 
117
117
  Reviewer/Judge Agent: run review gate,
118
- task DEV-12,
118
+ task #12,
119
119
  checklist "what_done_summary, critical_findings, potential_risks, issue_link_presence",
120
120
  result PASS_CANDIDATE,
121
121
  report "posted to issue #12"
@@ -133,7 +133,7 @@ Reason: Подтверждение review пользователем получ
133
133
  Name: Reviewer/Judge Agent
134
134
 
135
135
  Reviewer/Judge Agent: run review gate,
136
- task DEV-12,
136
+ task #12,
137
137
  approve yes,
138
138
  result PASS_CONFIRMED
139
139
  ```
@@ -168,7 +168,7 @@ Name: Agile Manager Agent
168
168
 
169
169
  Agile Manager Agent: set status,
170
170
  tracker github,
171
- task DEV-12,
171
+ task #12,
172
172
  status IN_PROGRESS,
173
173
  reason "начата реализация"
174
174
  ```
@@ -184,9 +184,9 @@ Name: Agile Manager Agent
184
184
 
185
185
  Agile Manager Agent: prepare task branch,
186
186
  tracker github,
187
- task "GOV-1",
187
+ task "#12",
188
188
  task kind "atomic",
189
- command "npm run meta:task-start -- --task GOV-1 --slug api-redirect",
189
+ command "npm run meta:task-start -- --task #12 --slug api-redirect",
190
190
  user dialogue "confirm branch context + dirty/ahead handling + agents.md context warning + switch decision"
191
191
  ```
192
192
 
@@ -201,7 +201,7 @@ Name: Agile Manager Agent
201
201
 
202
202
  Agile Manager Agent: set status,
203
203
  tracker github,
204
- task DEV-12,
204
+ task #12,
205
205
  status REVIEW,
206
206
  reason "готово к review gate"
207
207
  ```
@@ -257,9 +257,9 @@ Agile Manager Agent: commit by name,
257
257
  tracker github,
258
258
  task "API редирект офферов",
259
259
  issue 12,
260
- commit message "DEV-12 | API редирект офферов (#12)",
260
+ commit message "#12 | API редирект офферов",
261
261
  push yes,
262
- branch "feature/DEV-12-api-redirect",
262
+ branch "feature/issue-12-api-redirect",
263
263
  open mr "optional",
264
264
  target status READY,
265
265
  what done "добавлен endpoint, тесты, обработка ошибок"
@@ -275,7 +275,7 @@ Reason: Нужен обязательный pre-merge review по MR/PR с пр
275
275
  Name: MR Review Agent
276
276
 
277
277
  MR Review Agent: run MR review gate,
278
- task DEV-12,
278
+ task #12,
279
279
  pr 34,
280
280
  checklist "mr_context, task_linkage, prd_evidence, critical_findings, potential_risks",
281
281
  result PASS_CANDIDATE
@@ -293,7 +293,7 @@ Reason: Подтверждение MR review пользователем полу
293
293
  Name: MR Review Agent
294
294
 
295
295
  MR Review Agent: run MR review gate,
296
- task DEV-12,
296
+ task #12,
297
297
  pr 34,
298
298
  approve yes,
299
299
  result PASS_CONFIRMED
@@ -310,7 +310,7 @@ Name: Agile Manager Agent
310
310
 
311
311
  Agile Manager Agent: set status,
312
312
  tracker github,
313
- task DEV-12,
313
+ task #12,
314
314
  status PUBLISH,
315
315
  reason "релиз опубликован в latest"
316
316
  ```
@@ -329,7 +329,7 @@ Close Task Approved: yes
329
329
 
330
330
  Agile Manager Agent: set status,
331
331
  tracker github,
332
- task DEV-12,
332
+ task #12,
333
333
  status DONE,
334
334
  reason "пользователь подтвердил закрытие"
335
335
  ```
@@ -345,7 +345,7 @@ Name: Agile Manager Agent
345
345
 
346
346
  Agile Manager Agent: assign sprint,
347
347
  tracker github,
348
- task DEV-12,
348
+ task #12,
349
349
  sprint SPRINT-3
350
350
  ```
351
351
 
@@ -362,7 +362,7 @@ Status Agent: status snapshot,
362
362
  tracker github,
363
363
  source policy "github/mcp/custom -> external tracker first, local -> tasks first",
364
364
  include "trackers_used,current_sprint,current_task,current_branch_context,git_uncommitted,summary",
365
- command "node .meta-agents/scripts/sync-status.mjs"
365
+ command "npm run meta:status"
366
366
  ```
367
367
 
368
368
  ### PREPARE_RELEASE_NOTE