@k0t0vich/meta-agents-template 0.1.6 → 0.1.8

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` для всех вошедших задач).