@k0t0vich/meta-agents-template 0.1.2 → 0.1.3

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 ADDED
@@ -0,0 +1,26 @@
1
+ # Changelog
2
+
3
+ All notable changes to this package are documented in this file.
4
+
5
+ ## 0.1.3 - 2026-03-20
6
+
7
+ ### Added
8
+ - Public `CHANGELOG.md` is now part of the npm package payload.
9
+ - Publishing Agent rules now require changelog update before release.
10
+ - Release process now explicitly requires release note + task list + post-publish status update to `PUBLISH`.
11
+
12
+ ### Changed
13
+ - Publishing guidance now includes changelog update and visibility checks for npm consumers.
14
+
15
+ ## 0.1.2 - 2026-03-20
16
+
17
+ ### Added
18
+ - Status semantics: `READY` (commit+push), `DONE` (integrated to main), `PUBLISH` (released latest).
19
+ - Large-feature policy for GitHub tracker: `feature issue` + `epic issue` + dedicated branch.
20
+ - Publishing Agent role with release-note and `PUBLISH` task updates.
21
+
22
+ ## 0.1.1 - 2026-03-20
23
+
24
+ ### Added
25
+ - Trusted Publishing release flow and local post-publish smoke routine.
26
+ - Governance and review-gate hardening with explicit user confirmation rules.
package/README.md CHANGED
@@ -141,3 +141,5 @@ npm run meta:verify-link
141
141
  ## Основные документы шаблона
142
142
  - [agents.md](./agents.md)
143
143
  - [tracker-command-template.md](./tracker-command-template.md)
144
+ - [CHANGELOG.md](./CHANGELOG.md)
145
+ - [GitHub Releases](https://github.com/k0t0vich/meta-agents-template/releases)
package/agents.md CHANGED
@@ -30,6 +30,8 @@
30
30
  - `Engineering Agent`: реализация по контракту.
31
31
  - `QA Agent`: проверка выполнения критериев и качество тестового покрытия.
32
32
  - `Reviewer/Judge Agent`: независимая приёмка по заранее согласованным правилам.
33
+ - `Publishing Agent`: готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
34
+ - `Publishing Agent`: обновляет публичный `CHANGELOG.md`, готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
33
35
  - `Documentation Agent`: поддержка и синхронизация артефактов.
34
36
 
35
37
  ## 4) Жёсткий Auto-Select и показ имени агента
@@ -98,6 +100,8 @@ Name: <agent role>
98
100
  3. `RUN_REVIEW_GATE`
99
101
  4. `COMMIT_BY_NAME`
100
102
  5. `ASSIGN_SPRINT`
103
+ 6. `PREPARE_RELEASE_NOTE`
104
+ 7. `MARK_TASKS_PUBLISH`
101
105
 
102
106
  ## 10) Коммиты и закрытие задач: только по подтверждению пользователя
103
107
  Запрещено выполнять автоматически:
@@ -145,7 +149,8 @@ Name: <agent role>
145
149
  15. Для статуса `READY` подтверждены `commit + push` и путь интеграции (`main` или открытый MR/PR).
146
150
  16. Для статуса `DONE` подтверждена интеграция в `main` (direct commit или merged MR/PR).
147
151
  17. Для статуса `PUBLISH` подтверждена публикация в последней версии.
148
- 18. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
152
+ 18. Для релиза обновлён публичный `CHANGELOG.md`.
153
+ 19. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
149
154
 
150
155
  Если хотя бы один критерий не выполнен, задача не принимается.
151
156
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k0t0vich/meta-agents-template",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Template system for verification-first agentic development",
5
5
  "type": "module",
6
6
  "bin": {
@@ -14,6 +14,7 @@
14
14
  },
15
15
  "files": [
16
16
  "README.md",
17
+ "CHANGELOG.md",
17
18
  "agents.md",
18
19
  "tracker-command-template.md",
19
20
  "bin",
@@ -97,6 +97,7 @@ system:
97
97
  - "TASK-ID"
98
98
  - "#issue"
99
99
  publish_flow:
100
+ changelog_required: true
100
101
  release_note_required: true
101
102
  release_note_must_include_tasks: true
102
103
  mark_included_tasks_publish: true
@@ -115,6 +116,7 @@ system:
115
116
  - review_user_acknowledged
116
117
  - ready_has_commit_and_push
117
118
  - done_integrated_to_main
119
+ - release_changelog_updated
118
120
  - release_note_created
119
121
  - release_note_includes_tasks
120
122
  - release_tasks_marked_publish
@@ -1,7 +1,8 @@
1
1
  Role: Publishing Agent
2
2
  Goal: подготовить релиз, зафиксировать release notes и перевести вошедшие задачи в статус PUBLISH.
3
3
  Rule:
4
+ - перед публикацией обновить пользовательский `CHANGELOG.md` (что вошло в версию);
4
5
  - перед публикацией создать release note со списком issue/tasks, вошедших в релиз;
5
6
  - после подтверждённой публикации обновить статусы всех вошедших задач на `PUBLISH` в GitHub tracker;
6
7
  - для каждого релиза оставлять ссылку на release note и версию.
7
- Output: release note path + список задач + подтверждение обновления статусов.
8
+ Output: changelog update + release note path + список задач + подтверждение обновления статусов.
@@ -30,6 +30,7 @@
30
30
  7. Для больших фич (GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
31
31
  8. В GitHub epic оформляется как issue с label `type:epic`, а feature связывается с ним ссылкой (`type:feature`).
32
32
  9. Для релиза используется `Publishing Agent`: он создаёт release note с вошедшими задачами и переводит эти задачи в `PUBLISH`.
33
+ 10. Перед релизом `Publishing Agent` обязан обновить публичный `CHANGELOG.md`.
33
34
 
34
35
  ## Команды
35
36
  Смотри `tracker-command-template.md`.
@@ -31,6 +31,7 @@
31
31
  - `QA Agent`: проверка выполнения критериев и качество тестового покрытия.
32
32
  - `Reviewer/Judge Agent`: независимая приёмка по заранее согласованным правилам.
33
33
  - `Publishing Agent`: готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
34
+ - `Publishing Agent`: обновляет публичный `CHANGELOG.md`, готовит release notes, фиксирует вошедшие задачи и переводит их в `PUBLISH`.
34
35
  - `Documentation Agent`: поддержка и синхронизация артефактов.
35
36
 
36
37
  ## 4) Жёсткий Auto-Select и показ имени агента
@@ -148,7 +149,8 @@ Name: <agent role>
148
149
  15. Для статуса `READY` подтверждены `commit + push` и путь интеграции (`main` или открытый MR/PR).
149
150
  16. Для статуса `DONE` подтверждена интеграция в `main` (direct commit или merged MR/PR).
150
151
  17. Для статуса `PUBLISH` подтверждена публикация в последней версии.
151
- 18. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
152
+ 18. Для релиза обновлён публичный `CHANGELOG.md`.
153
+ 19. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
152
154
 
153
155
  Если хотя бы один критерий не выполнен, задача не принимается.
154
156
 
@@ -290,6 +290,7 @@ Publishing Agent: prepare release note,
290
290
  tracker github,
291
291
  version v0.1.2,
292
292
  included tasks "#2,#3,#4,#5,#6,#7,#8",
293
+ changelog "CHANGELOG.md updated for v0.1.2",
293
294
  output "docs/internal/release-notes/v0.1.2.md"
294
295
  ```
295
296
 
@@ -68,7 +68,7 @@ result PASS
68
68
  - epic в GitHub оформляется как issue с label `type:epic`;
69
69
  - feature оформляется как issue с label `type:feature` и ссылкой на epic.
70
70
 
71
- ## 2) Канонические команды (через Agile Manager Agent)
71
+ ## 2) Канонические команды (через Agile Manager Agent / Publishing Agent)
72
72
  ### VERIFY_GOVERNANCE_GATE
73
73
  ```text
74
74
  [Agent Auto-Select]
@@ -277,6 +277,39 @@ task DEV-12,
277
277
  sprint SPRINT-3
278
278
  ```
279
279
 
280
+ ### PREPARE_RELEASE_NOTE
281
+ ```text
282
+ [Agent Auto-Select]
283
+ Selected: Publishing Agent
284
+ Reason: Нужно зафиксировать состав релиза и задачи, вошедшие в поставку.
285
+
286
+ [Task Agent]
287
+ Name: Publishing Agent
288
+
289
+ Publishing Agent: prepare release note,
290
+ tracker github,
291
+ version v0.1.2,
292
+ included tasks "#2,#3,#4,#5,#6,#7,#8",
293
+ changelog "CHANGELOG.md updated for v0.1.2",
294
+ output "docs/internal/release-notes/v0.1.2.md"
295
+ ```
296
+
297
+ ### MARK_TASKS_PUBLISH
298
+ ```text
299
+ [Agent Auto-Select]
300
+ Selected: Publishing Agent
301
+ Reason: После релиза нужно перевести вошедшие задачи в статус PUBLISH.
302
+
303
+ [Task Agent]
304
+ Name: Publishing Agent
305
+
306
+ Publishing Agent: mark tasks publish,
307
+ tracker github,
308
+ tasks "#2,#3,#4,#5,#6,#7,#8",
309
+ status PUBLISH,
310
+ reason "вошло в релиз v0.1.2"
311
+ ```
312
+
280
313
  ## 3) PRD-блок для каждого шага (обязателен)
281
314
  ```markdown
282
315
  ## PRD Step: <stage-name>
@@ -308,4 +341,5 @@ sprint SPRINT-3
308
341
  9. `COMMIT_BY_NAME` только после review PASS_CONFIRMED и отдельного подтверждения пользователя на коммит.
309
342
  10. `SET_STATUS -> READY`.
310
343
  11. `SET_STATUS -> DONE` только после подтверждения пользователя.
311
- 12. Для релизных задач после публикации: `SET_STATUS -> PUBLISH`.
344
+ 12. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
345
+ 13. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).