@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 +26 -0
- package/README.md +2 -0
- package/agents.md +6 -1
- package/package.json +2 -1
- package/template/.meta-agents/config/system.yaml +2 -0
- package/template/.meta-agents/prompts/publishing-agent.md +2 -1
- package/template/README.md +1 -0
- package/template/agents.md +3 -1
- package/template/tracker-command-template.md +1 -0
- package/tracker-command-template.md +36 -2
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.
|
|
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.
|
|
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 + список задач + подтверждение обновления статусов.
|
package/template/README.md
CHANGED
|
@@ -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`.
|
package/template/agents.md
CHANGED
|
@@ -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.
|
|
152
|
+
18. Для релиза обновлён публичный `CHANGELOG.md`.
|
|
153
|
+
19. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
|
|
152
154
|
|
|
153
155
|
Если хотя бы один критерий не выполнен, задача не принимается.
|
|
154
156
|
|
|
@@ -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.
|
|
344
|
+
12. `PREPARE_RELEASE_NOTE` (какие задачи вошли в релиз).
|
|
345
|
+
13. Для релизных задач после публикации: `MARK_TASKS_PUBLISH` (`SET_STATUS -> PUBLISH` для всех вошедших задач).
|