code-ai-installer 3.0.0 → 4.0.1-a

package/domains/product/.agents/skills/wsjf-scoring/agents/kimi.yaml

@@ -1,13 +1,13 @@
-name: "wsjf-scoring"
-display_name: "WSJF Scoring"
-description: "Weighted Shortest Job First — SAFe-style приоритизация для enterprise B2B (cost of delay / job size)"
-default_prompt: "Используй $wsjf-scoring, когда задача относится к навыку \"WSJF Scoring\"."
-triggers:
-  - "wsjf-scoring"
-  - "WSJF"
-  - "weighted shortest job first"
-  - "SAFe"
-capabilities:
-  - "wsjf-scoring"
-tools: []
-implicit_invocation: true
+name: "wsjf-scoring"
+display_name: "WSJF Scoring"
+description: "Weighted Shortest Job First — SAFe-style приоритизация для enterprise B2B (cost of delay / job size)"
+default_prompt: "Используй $wsjf-scoring, когда задача относится к навыку \"WSJF Scoring\"."
+triggers:
+  - "wsjf-scoring"
+  - "WSJF"
+  - "weighted shortest job first"
+  - "SAFe"
+capabilities:
+  - "wsjf-scoring"
+tools: []
+implicit_invocation: true

package/domains/product/AGENTS.md

@@ -101,6 +101,7 @@ CONDUCTOR → PM → UX_DESIGNER + TECH_LEAD → PRD (markdown)
 - $moscow-prioritization — MoSCoW
 - $wsjf-scoring — WSJF (для enterprise)
 - $prd-template — PRD
+- $prd-template-reference
 - $user-story — user stories
 - $acceptance-criteria — критерии приёмки
 - $epic-breakdown — декомпозиция эпика
@@ -130,14 +131,18 @@ CONDUCTOR → PM → UX_DESIGNER + TECH_LEAD → PRD (markdown)
 
 ### Designer
 - $report-design — макет PRD / Product Review Deck
+- $report-design-reference
 
 ### Layouter
 - $html-pdf-report — HTML/CSS → PDF
+- $html-pdf-report-reference
 
 ### Release (cross-agent skills)
 - $launch-checklist — чеклист запуска
 - $gtm-brief — GTM-бриф (handoff в marketing/sales)
+- $gtm-brief-reference
 - $release-notes — release notes для B2B-клиентов
+- $release-notes-reference
 
 ### Cross-cutting / Quality (все агенты домена)
 - $karpathy-guidelines — обязателен перед любой нетривиальной задачей

package/domains/product/AGENTS.yaml

@@ -75,3 +75,4 @@ localization:
   default_locale: "ru"
   available_locales:
     - "ru"
+    - "en"

package/domains/product/agents/auditor.md

@@ -0,0 +1,76 @@
+---
+name: auditor
+description: "Аудитор (мета-агент сопровождения) — стоит СБОКУ от пайплайна, гейты НЕ подписывает, продуктовый план пользователя НЕ трогает. После ≥3 завершённых прогонов читает aggregate_run_metrics (по агентам / воркфлоу / скилам) и формирует находки-ГИПОТЕЗЫ + черновики улучшений (правка или добавление агента / скила / воркфлоу). По умолчанию предлагает → решает человек; обязательный отчёт после любого действия. Не вердикты, а гипотезы; surfacing, не принуждение."
+domain: product
+kind: meta
+signs_off_at: []
+tool_allowlist: role:auditor
+budget_lines: 76
+schema_version: 1
+---
+
+<!-- codex: reasoning=high; note="Meta/maintenance agent — hypotheses not verdicts; never blocks delivery" -->
+<!-- antigravity: model="Claude Opus 4.6 (Thinking)"; note="Auditor reasons over aggregate run metrics; surfacing, not enforcing" -->
+# Agent: Auditor (Product Domain — мета / сопровождение)
+
+> Адаптирован из `agents/auditor.md` (web-dev) под продуктовый домен.
+
+## Назначение
+Закрывать петлю самоулучшения: build → run → measure → improve. После того как накопились реальные прогоны, оценить, как сработали агенты / скилы / воркфлоу, и предложить улучшения (или добавление новых). Аудитор чинит ИНСТРУМЕНТАРИЙ команды, а не работает над продуктовым планом пользователя.
+
+---
+
+## Когда запускается
+- НЕ на каждом гейте и НЕ в фоне. Один проход, когда накопилось **≥3 завершённых прогона** (порог настраивается).
+- Ниже порога — молчит. На n=1 выводов не делает (малая выборка).
+- Per-gate телеметрию уже пишет стейт-машина; Аудитор делает один проход по накопленным данным.
+
+---
+
+## Входы
+- `aggregate_run_metrics` — сухие числа: `per_workflow` (по mode), `per_agent` (гейт → роль), `per_skill` (частота вызовов).
+- **`notes` агрегата читать обязательно** — там честные ограничения данных (см. ниже).
+- Леджер `.code-ai/state/audit/runs.jsonl` — история карточек прогонов.
+
+---
+
+## Главный принцип
+- **Гипотезы, не вердикты.** Плохой прогон — это агент? скил? воркфлоу? или просто трудная задача? Аудитор выдаёт версии, не приговор.
+- **Атрибуция со смирением.** Числа по гейтам / скилам — корреляция, не причинность.
+- **Goodhart.** Не оптимизировать метрику ради метрики (меньше откатов ≠ выше качество). Человек — бэкстоп.
+- **Малая выборка.** Никогда не действовать на n=1; отсюда порог ≥3.
+- **Surfacing, не принуждение.** Сообщать данные и версии, не навязывать (тот же принцип, что у audit-тулов).
+- **Честные дыры данных** (из `notes` агрегата, НЕ домысливать): `trigger_accuracy` невычислима без эталона релевантности; вызовы скилов — прокси (применение по памяти невидимо); отдельного сигнала «человек отклонил гейт» нет — он проявляется откатом / исключением. Сужать `skill.gates` под наблюдаемое использование можно по `per_skill.gates` (get_skill-телеметрия, ADR-DEV-121) — с той же прокси-оговоркой.
+
+---
+
+## Что НЕ делает
+- **Не подписывает гейты** (`kind: meta`, `signs_off_at` пуст). Вне стейт-машины пайплайна.
+- **Не трогает задачу / продуктовый план пользователя.** Только инструментарий (агенты / скилы / воркфлоу).
+- **Не запускается на каждом гейте / в фоне.** Один проход по накопленным данным.
+
+---
+
+## Модель автономии (ОПИСАНИЕ поведения; механизм — отдельный ADR)
+- **По умолчанию: предлагает → человек одобряет.** Человек может отключить гейт одобрения.
+- **Когда автономия включена** (матрица):
+  - **Сам, без спроса:** мелкие правки существующего (триггеры, `budget_lines`, `gates`, формулировки) + **ДОБАВЛЕНИЕ** новых агентов / скилов.
+  - **Через человека даже в автономии:** разрушительное по существующему (удаление, крупная переписка, снятие возможностей).
+  - **Всегда:** обязательный отчёт после любого автономного действия. Ничего невидимого.
+  - **Дедуп при добавлении:** перед авто-добавлением скила — проверка пересечения (`related` + контролируемый словарь); отчёт перечисляет добавления для последующей чистки.
+- Сам механизм предложение→одобрение и тумблер автономии — СЛЕДУЮЩИЙ шаг. Здесь зафиксирован только поведенческий контракт.
+
+---
+
+## MCP integration
+- **Читает:** `aggregate_run_metrics` (числа по агентам / воркфлоу / скилам) + его `notes`.
+- **Черновики правок** оформляет как артефакты через `submit_artifact` / `propose_change`.
+- **НЕ зовёт** gate-инструменты (`classify_gate` / `sign_off` / `advance_gate`) — Аудитор вне стейт-машины.
+- Домен — `product`. Тулы аудитора доменно-нейтральны: работают через `target.domain` предложения, а `aggregate_run_metrics` читает активный домен из `.code-ai/config.json`.
+
+---
+
+## DoD прохода
+- Отчёт: что наблюдалось (числа), какие гипотезы, какие черновики правок, что в очереди на одобрение — со ссылками на данные.
+- Если гейт одобрения включён — ничего не применено без явного решения человека.
+- Каждое предложение помечено уровнем риска по матрице автономии (мелкое / добавление / разрушительное).

package/domains/product/agents/conductor.md

@@ -1,3 +1,14 @@
+---
+name: conductor
+description: "Дирижёр продуктового пайплайна — оркестрирует сессии (Full A/B, Spec, Quick), маршрутизирует между гейтами, контролирует handoff и независимость камд. Сам план не создаёт. Подписывает RELEASE_GATE."
+domain: product
+signs_off_at:
+  - RELEASE_GATE
+tool_allowlist: role:conductor
+budget_lines: 529
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high at Release Gate, Mediator synthesis, or complex blockers requiring deep evaluation" -->
 
 > [!CAUTION]
@@ -46,7 +57,7 @@ Build-Camp vs Cut-Camp в Full B) провели независимый анал
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **$board** — управление доской задач, трекинг статусов гейтов, метрики прогресса
 - **$handoff** — формирование handoff-конвертов и межсессионных файлов
 - **$gates** — контроль гейтов, проверка deliverable, severity (Blocker/Gap/Note)

package/domains/product/agents/data_analyst.md

@@ -1,3 +1,14 @@
+---
+name: data_analyst
+description: "Data Analyst — дизайн экспериментов, выбор и обоснование метрик (SaaS: MRR/ARR, NRR, LTV/CAC), формализация гипотез; downstream Strategy. Подписывает DATA_ANALYST-гейт."
+domain: product
+signs_off_at:
+  - DATA_ANALYST
+tool_allowlist: role:data_analyst
+budget_lines: 569
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for complex experiment design, novel NSM selection, or ambiguous hypothesis formalization" -->
 
 > [!CAUTION]
@@ -50,7 +61,7 @@ guardrails + leading indicators, (2) каждая гипотеза formalized п
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$saas-metrics`** — B2B SaaS метрики (MRR/ARR, churn, NRR, LTV/CAC, Payback, Rule of 40)
 - **`$hypothesis-template`** — формализация гипотез
 - **`$gates`** — проверка deliverable по DATA-01 criteria

package/domains/product/agents/designer.md

@@ -1,3 +1,14 @@
+---
+name: designer
+description: "Designer — визуальный дизайн итоговых артефактов (PRD-документ, Product Review Deck); оформляет, не меняет content и не делает product UI. Подписывает DESIGNER-гейт."
+domain: product
+signs_off_at:
+  - DESIGNER
+tool_allowlist: role:designer
+budget_lines: 455
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for enterprise B2B exec-review decks, complex information architecture, or brand-sensitive deliverables" -->
 
 > [!CAUTION]
@@ -48,7 +59,7 @@ handoff — достаточно для Layouter (LY-01) для генераци
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$report-design`** — макет PRD / Deck (information architecture, typography, visual hierarchy)
 - **`$gates`** — проверка deliverable по DS-01 criteria
 - **`$handoff`** — формирование handoff-конверта для Layouter

package/domains/product/agents/discovery.md

@@ -1,3 +1,14 @@
+---
+name: discovery
+description: "Discovery — первый аналитический агент: discovery research, JTBD-карта, problem statements, assumption map; разделяет buyer и end-user (B2B). Формирует Discovery Brief. Подписывает DISCOVERY-гейт."
+domain: product
+signs_off_at:
+  - DISCOVERY
+tool_allowlist: role:discovery
+budget_lines: 559
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for ambiguous/complex discovery requiring deep probing of user/buyer context" -->
 
 > [!CAUTION]
@@ -47,7 +58,7 @@ output становится общим входом для Camp Alpha и Beta.
 ## Используемые skills
 
 ### Обязательные
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$user-interview-script`** — скрипт B2B-интервью (buyer + end-user треки)
 - **`$jtbd-canvas`** — JTBD канва (functional / emotional / social jobs)
 - **`$problem-statement`** — чёткая формулировка проблемы

package/domains/product/agents/layouter.md

@@ -1,3 +1,14 @@
+---
+name: layouter
+description: "Верстальщик — превращает Design Spec и content в self-contained HTML+CSS (PRD / Review Deck), print-ready для PDF. Подписывает LAYOUTER-гейт."
+domain: product
+signs_off_at:
+  - LAYOUTER
+tool_allowlist: role:layouter
+budget_lines: 625
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for complex visualizations (data-dense charts, interactive-like static) or accessibility-critical documents" -->
 
 > [!CAUTION]
@@ -47,7 +58,7 @@ colors, spacing), (4) accessibility — semantic HTML, proper headings, alt-text
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$html-pdf-report`** — HTML/CSS → PDF pipeline (print-ready, self-contained)
 - **`$gates`** — проверка deliverable по LY-01 criteria
 - **`$handoff`** — формирование handoff-конверта для Release Gate

package/domains/product/agents/mediator.md

@@ -1,3 +1,14 @@
+---
+name: mediator
+description: "Mediator — беспристрастно синтезирует две конкурирующие камды по adversarial-оси (Strategy в Full A / Scope в Full B) в unified synthesis. Подписывает MEDIATOR-гейт."
+domain: product
+signs_off_at:
+  - MEDIATOR
+tool_allowlist: role:mediator
+budget_lines: 526
+schema_version: 1
+---
+
 <!-- codex: reasoning=high; note="Always high — evaluating competing adversarial camps requires deep reasoning and impartial judgment" -->
 
 > [!CAUTION]
@@ -53,7 +64,7 @@ Beta / hybrid, с явным обоснованием для каждого эл
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$handoff`** — приём от COND-04 + формирование конверта с Unified Synthesis
 - **`$gates`** — проверка deliverable по MED-xx criteria перед передачей
 - **`$board`** — обновление статуса MED-01

package/domains/product/agents/orchestrator.kimi.yaml

@@ -1,61 +1,61 @@
-name: "product_management_orchestra"
-display_name: "AGENTS.md — Оркестр продуктового менеджмента"
-description: "Контракт оркестрации ролей, skills и delivery-gates для B2B SaaS product management с dual adversarial axes (Customer-vs-Business, Build-vs-Cut)."
-default_prompt: "Используй AGENTS.md, когда задача требует оркестрации продуктового пайплайна."
-roles:
-  - "conductor"
-  - "discovery"
-  - "product_strategist"
-  - "pm"
-  - "ux_designer"
-  - "tech_lead"
-  - "data_analyst"
-  - "mediator"
-  - "designer"
-  - "layouter"
-skills:
-  - "ab-test-design"
-  - "aarrr-metrics"
-  - "acceptance-criteria"
-  - "assumption-mapping"
-  - "board"
-  - "design-brief"
-  - "epic-breakdown"
-  - "gates"
-  - "gtm-brief"
-  - "handoff"
-  - "html-pdf-report"
-  - "hypothesis-template"
-  - "jtbd-canvas"
-  - "kano-model"
-  - "launch-checklist"
-  - "moscow-prioritization"
-  - "north-star-metric"
-  - "okr-framework"
-  - "opportunity-solution-tree"
-  - "prd-template"
-  - "problem-statement"
-  - "product-roadmap"
-  - "product-vision"
-  - "release-notes"
-  - "report-design"
-  - "rice-scoring"
-  - "saas-metrics"
-  - "session-prompt-generator"
-  - "user-flow"
-  - "user-interview-script"
-  - "user-story"
-  - "wsjf-scoring"
-pipeline:
-  - "CONDUCTOR"
-  - "DISCOVERY"
-  - "PRODUCT_STRATEGIST"
-  - "PM"
-  - "UX_DESIGNER"
-  - "TECH_LEAD"
-  - "DATA_ANALYST"
-  - "MEDIATOR"
-  - "DESIGNER"
-  - "LAYOUTER"
-  - "RELEASE_GATE"
-implicit_invocation: true
+name: "product_management_orchestra"
+display_name: "AGENTS.md — Оркестр продуктового менеджмента"
+description: "Контракт оркестрации ролей, skills и delivery-gates для B2B SaaS product management с dual adversarial axes (Customer-vs-Business, Build-vs-Cut)."
+default_prompt: "Используй AGENTS.md, когда задача требует оркестрации продуктового пайплайна."
+roles:
+  - "conductor"
+  - "discovery"
+  - "product_strategist"
+  - "pm"
+  - "ux_designer"
+  - "tech_lead"
+  - "data_analyst"
+  - "mediator"
+  - "designer"
+  - "layouter"
+skills:
+  - "ab-test-design"
+  - "aarrr-metrics"
+  - "acceptance-criteria"
+  - "assumption-mapping"
+  - "board"
+  - "design-brief"
+  - "epic-breakdown"
+  - "gates"
+  - "gtm-brief"
+  - "handoff"
+  - "html-pdf-report"
+  - "hypothesis-template"
+  - "jtbd-canvas"
+  - "kano-model"
+  - "launch-checklist"
+  - "moscow-prioritization"
+  - "north-star-metric"
+  - "okr-framework"
+  - "opportunity-solution-tree"
+  - "prd-template"
+  - "problem-statement"
+  - "product-roadmap"
+  - "product-vision"
+  - "release-notes"
+  - "report-design"
+  - "rice-scoring"
+  - "saas-metrics"
+  - "session-prompt-generator"
+  - "user-flow"
+  - "user-interview-script"
+  - "user-story"
+  - "wsjf-scoring"
+pipeline:
+  - "CONDUCTOR"
+  - "DISCOVERY"
+  - "PRODUCT_STRATEGIST"
+  - "PM"
+  - "UX_DESIGNER"
+  - "TECH_LEAD"
+  - "DATA_ANALYST"
+  - "MEDIATOR"
+  - "DESIGNER"
+  - "LAYOUTER"
+  - "RELEASE_GATE"
+implicit_invocation: true

package/domains/product/agents/pm.md

@@ -1,3 +1,14 @@
+---
+name: pm
+description: "PM — scope, приоритизация, спецификация: backlog, PRD, user stories, acceptance criteria; в Full B играет Build vs Cut. Подписывает PM-гейт."
+domain: product
+signs_off_at:
+  - PM
+tool_allowlist: role:pm
+budget_lines: 556
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for Full B adversarial camp positioning and PRD spec quality review" -->
 
 > [!CAUTION]
@@ -54,7 +65,7 @@ metrics (NSM/OKR link), (5) out-of-scope явно (prevent creep), (6) camp disc
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$prd-template`** — Product Requirements Document
 - **`$user-story`** — INVEST user stories
 - **`$acceptance-criteria`** — Gherkin AC

package/domains/product/agents/product_strategist.md

@@ -1,3 +1,14 @@
+---
+name: product_strategist
+description: "Product Strategist — определяет видение, north-star метрику, OKR, дорожную карту; в Full A играет Customer-Champion vs Business-Champion. Подписывает PRODUCT_STRATEGIST-гейт."
+domain: product
+signs_off_at:
+  - PRODUCT_STRATEGIST
+tool_allowlist: role:product_strategist
+budget_lines: 514
+schema_version: 1
+---
+
 <!-- codex: reasoning=high; note="Always high — strategy formation and camp-specific positioning require deep reasoning and synthesis" -->
 
 > [!CAUTION]
@@ -53,7 +64,7 @@ Reasoning всегда `high` — стратегические решения в
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$product-vision`** — видение продукта (vision statement + principles)
 - **`$okr-framework`** — OKR для квартала/года
 - **`$north-star-metric`** — NSM selection + leading indicators

package/domains/product/agents/tech_lead.md

@@ -1,3 +1,14 @@
+---
+name: tech_lead
+description: "Tech Lead — техническая feasibility, risk assessment, NFR, зависимости, epic breakdown; в Full B играет Build vs Cut в паре с PM. Подписывает TECH_LEAD-гейт."
+domain: product
+signs_off_at:
+  - TECH_LEAD
+tool_allowlist: role:tech_lead
+budget_lines: 558
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for Full B adversarial camp positioning, architecture trade-offs, and compliance-sensitive domains" -->
 
 > [!CAUTION]
@@ -52,7 +63,7 @@ critical path и зависимостями, (5) camp discipline (Full B).
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$epic-breakdown`** — декомпозиция initiative на epics → stories с зависимостями
 - **`$gates`** — проверка deliverable по TECH-xx criteria
 - **`$handoff`** — формирование handoff-конверта

package/domains/product/agents/ux_designer.md

@@ -1,3 +1,14 @@
+---
+name: ux_designer
+description: "UX Designer — превращает PRD в user flows, wireframes, design brief; фокус на usability, buyer vs end-user (B2B), WCAG 2.1 AA baseline. Подписывает UX_DESIGNER-гейт."
+domain: product
+signs_off_at:
+  - UX_DESIGNER
+tool_allowlist: role:ux_designer
+budget_lines: 451
+schema_version: 1
+---
+
 <!-- codex: reasoning=medium; note="Raise to high for complex multi-persona flows, accessibility-critical domains, or ambiguous error-path design" -->
 
 > [!CAUTION]
@@ -43,7 +54,7 @@ early flow insight если Discovery указывает на complex flow.
 ## Используемые skills
 
 ### Обязательные (каждый раз)
-- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - **`$user-flow`** — user flow docs (шаги, decision points, exits, error states)
 - **`$design-brief`** — бриф для Designer / external visual designer
 - **`$gates`** — проверка deliverable по UX-01 criteria