code-ai-installer 2.2.0 → 2.4.0

package/domains/product/.agents/workflows/spec.md

@@ -0,0 +1,229 @@
+# /spec — PRD-only Pipeline (1 сессия, без adversarial)
+
+> **Используй, когда стратегия и scope утверждены — нужен формальный PRD.**
+> 1 сессия, без adversarial. Output — PRD (markdown) или PRD PDF (опционально).
+
+## Когда использовать
+
+- Strategy утверждена (в предыдущих сессиях `/ship-right-thing` или из внешнего процесса)
+- Scope утверждён (в `/shape-prioritize` или из roadmap document)
+- Команда готова начинать implementation — нужен PRD для handoff
+- Feature / initiative в рамках approved roadmap theme
+- Team alignment уже достигнут — spec нужен для engineering / UX / QA
+
+## Когда НЕ использовать
+
+- Scope открыт → `/shape-prioritize`
+- Стратегия неясна → `/ship-right-thing`
+- Нужна быстрая оценка без полного PRD → `/quick-pm`
+- Exploratory / discovery-heavy initiative → `/ship-right-thing`
+
+## Decision Tree (уточняющие вопросы в COND-01)
+
+```
+Strategy утверждена?
+  ├── НЕТ → /ship-right-thing
+  └── ДА → продолжаем
+
+Scope утверждён?
+  ├── НЕТ → /shape-prioritize
+  └── ДА → продолжаем
+
+Успех =
+  ├── Full PRD для engineering handoff → /spec (эта workflow)
+  ├── Short brief для discussion → /quick-pm
+  └── Deep strategy rethink → /ship-right-thing
+```
+
+## Пайплайн (1 сессия)
+
+```
+CONDUCTOR → PM → UX_DESIGNER + TECH_LEAD → PRD (markdown)
+             ↓
+            DATA_ANALYST (для success metrics validation)
+```
+
+Последовательно-параллельный:
+- PM запускает PRD draft.
+- UX Designer + Tech Lead работают параллельно на PM output.
+- Data Analyst — sanity check success metrics.
+- PM finaliz'ит PRD, интегрируя UX + Tech + Data input.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Initiative name | ✅ | Что специфицируем |
+| Approved strategy context | ✅ | NSM, OKR, roadmap theme (reference или inline) |
+| Approved scope | ✅ | Backlog / MoSCoW / decision memo |
+| User segments | ✅ | Buyer vs end-user (из Discovery / strategy) |
+| Constraints | ✅ | Timeline, team, NFR (из Tech expectations) |
+| Existing flows / screens | ⬚ | Если extension существующего UI |
+| Success metrics expected | ⬚ | Обычно наследуется из approved strategy NSM |
+
+## Гейты и deliverables
+
+### COND-01 — Clarification + Scope Review
+
+- **Conductor**:
+  - 5+ clarifying questions (scope boundaries, timeline, NFR expectations, audience)
+  - Validate approved scope (sanity check — есть ли open questions?)
+  - Identify dependencies (other teams / external services / compliance)
+  - `$board` создана с 5 гейтами (COND-01 / PM-SPEC / UX-01 / TECH-01 / LITE-RG)
+
+### PM-SPEC — Core PRD
+
+- **PM**: Final PRD через `$prd-template` (10 секций):
+  1. Overview (problem + audience + business context)
+  2. Goals & Success Metrics (NSM / OKR link)
+  3. Solution Approach + non-goals
+  4. User Stories (INVEST) — 5-10 stories
+  5. Acceptance Criteria (Gherkin) per story
+  6. NFR (compact)
+  7. Risks (top 5 с mitigation)
+  8. Rollout Plan (pilot → GA)
+  9. Dependencies
+  10. Open Questions
+
+- **PM** также:
+  - Epic breakdown (3-5 epics)
+  - Out-of-scope явно
+
+### UX-01 — User Flows + Wireframes (параллельно Tech, если UI)
+
+- **UX Designer** через `$user-flow` + `$design-brief`:
+  - User flows для primary + secondary flows
+  - Low-fi wireframes для ключевых screens
+  - Accessibility checklist (WCAG AA baseline)
+  - Design brief для downstream visual designer (опц., если требуется hi-fi)
+  - B2B persona delineation (buyer flows / end-user flows / shared)
+
+Если initiative non-UI (backend / infrastructure) — UX skip, помечен как N/A на `$board`.
+
+### TECH-01 — Feasibility + NFR (параллельно UX)
+
+- **Tech Lead** (neutral mode, без camp):
+  - Architecture review
+  - Feasibility check (Yes / Yes-caveat / No + rationale per item)
+  - NFR (compact — top 5-7 категорий: performance / security / compliance / observability / integrations)
+  - Risk Register (top 3-5 с P×I + mitigation + owner)
+  - Integration map (dependencies на другие сервисы / teams)
+  - Epic breakdown (shallow, shared с PM)
+
+### DATA-01 — Metric Plan (опционально если scope содержит new metrics)
+
+- **Data Analyst**:
+  - Metric tree (NSM + top 3 inputs + guardrails)
+  - Hypothesis formalization (1-3, if applicable)
+  - Instrumentation requirements (events + properties)
+  - Baseline и target values
+
+Если success metrics наследуются as-is из approved strategy и инструментирование уже есть — Data skip, помечен N/A.
+
+### LITE-RG — PRD Finalization
+
+- **PM** merge UX + Tech + Data input
+- Self-review checklist (PRD Content Checklist — ниже)
+- Cross-check acceptance criteria на consistency с user stories
+- User sign-off
+
+### Optional: DS-01 + LY-01 (если нужен PDF)
+
+- Designer: compact design spec (10-15 page PRD layout).
+- Layouter: HTML → PDF.
+- Добавляет +1 сессию (Сессия 2 Spec становится Full A-style document session).
+
+## PRD Content Checklist (LITE-RG criteria)
+
+- [ ] Problem (clear, evidence-backed, из approved Discovery pointer)
+- [ ] Audience (buyer + end-user из Discovery)
+- [ ] Solution approach (1-2 paragraphs, no implementation details)
+- [ ] Success metrics (primary NSM + guardrails — из approved strategy)
+- [ ] User stories (INVEST — Independent / Negotiable / Valuable / Estimable / Small / Testable)
+- [ ] Acceptance criteria (Gherkin Given/When/Then)
+- [ ] Non-functional requirements (performance / security / compliance / accessibility)
+- [ ] Out-of-scope (explicit list)
+- [ ] Risks (top 3-5 с mitigation + owner)
+- [ ] Rollout plan (pilot / beta / GA с criteria + rollback)
+- [ ] Dependencies (other teams / external / compliance)
+- [ ] Open questions (owner + deadline)
+
+## Severity levels
+
+- **P0 Blocker:** PRD без success metrics; user stories без AC; NFR void; audience undefined
+- **P1 Gap:** Skipped UX для initiative, где UI затронут; missing rollout plan; thin dependencies
+- **P2 Note:** Optional PDF; expanded risks beyond top 5
+
+## Escalation paths
+
+- **Scope reveals strategy gap** (новый contradiction с approved strategy) → pause, эскалация к /ship-right-thing мини-сессии
+- **Scope reveals feasibility blocker** (Tech Lead surface hard-no) → pause, escalation к PM / stakeholder для re-scope
+- **Compliance block** обнаружен (SOC 2 / GDPR / HIPAA) → pause, legal review, возврат
+- **Timeline conflict** (scope > capacity) → escalation: cut scope или extend timeline (user decision)
+
+## Health metrics
+
+| Метрика | Здоровый | Проблемный | Действие |
+|---------|:--------:|:----------:|----------|
+| PRD completeness | 10/12 checklist items | < 8 | Не передавать engineering |
+| User stories AC coverage | 100% stories have AC | < 80% | Reverse Handoff PM |
+| NFR coverage | ≥ 5 categories | < 3 | Reverse Handoff Tech Lead |
+| Session duration | ≤ 3h focused | > 6h | Scope too big for Spec → consider split |
+
+## Output
+
+- `prd.md` (main deliverable) — 10-20 pages markdown
+- Optional `prd.pdf` (если добавлены Designer + Layouter сессии)
+- `$board` history
+- Engineering-ready handoff (story IDs, epics, dependencies)
+
+## Пример — TeamFlow AI 1:1 Summary: Q2 Export feature (Spec)
+
+**Запрос:** «Scope утверждён для Q2: add PDF/Notion export для summaries. Нужен PRD для engineering team.»
+
+**Режим:** /spec (strategy + scope уже утверждены; specification-only work)
+
+**Сессия 1:**
+
+- **COND-01**: Scope validation — Q2 roadmap theme «Export», scope include PDF + Notion, out-of-scope Slack. Timeline 3 weeks. WCAG AA. 5 вопросов отработаны.
+
+- **PM-SPEC**:
+  - PRD 12 pages: Problem (support tickets 14 в Q3 asking for export), audience (end-user Manager), solution (native PDF + Notion API).
+  - 5 user stories INVEST: «As a manager I want to export summary as PDF so I can share with report». AC Gherkin per story.
+  - NFR: performance p95 < 3s для PDF gen; Notion API rate limit handling.
+  - Risks: Notion API deprecation risk (mitigation: vendored client); PDF rendering quality (mitigation: preview in UI).
+  - Rollout: opt-in beta для 10 managers, GA при 4.0 rating.
+  - Dependencies: Notion integration (new), PDF service (existing).
+
+- **UX-01**:
+  - User flow: Click «Export» на summary → select format (PDF/Notion) → download/open Notion page.
+  - Low-fi wireframes: 2 screens (summary detail + export modal).
+  - Accessibility: keyboard nav для modal, aria-label для format selector.
+
+- **TECH-01**:
+  - Feasibility: Yes. t-shirt = M (2 team-weeks).
+  - NFR: PDF gen через existing service, Notion integration new (1 week spike для auth OAuth flow).
+  - Risks: Notion API rate limit (mitigation: batch + retry), PDF large file size (mitigation: compression).
+  - Epics: 2 (PDF pipeline, Notion integration).
+
+- **DATA-01 (N/A)**: Metrics наследуются — «export events» logged via existing event pipeline. Skip.
+
+- **LITE-RG**:
+  - PRD checklist: 11/12 ✅ (open questions перечислены, 1 noted «Notion Teams API vs Personal»).
+  - User sign-off получен.
+
+**Итог:** 1 session × 3h = готовый PRD 12 pages, engineering-ready.
+
+---
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| PRD без success metrics | Невозможно оценить win | NSM / OKR link обязателен |
+| Implementation details в PRD | PRD = what/why, не how | How → engineering docs |
+| User stories без AC | AC — контракт с engineers | Gherkin Given/When/Then |
+| Skipping NFR | В B2B SaaS часто deal-breakers | NFR top 5 минимум |
+| Scope reveal in spec session | Нарушение порядка pipeline | Escalate — возврат к /shape-prioritize или /ship-right-thing |
+| No rollout plan | Риск incidents at GA | Pilot → Beta → GA с criteria + rollback |
+| Open questions без owner | Blocked during impl | Owner + deadline per question |

package/domains/product/AGENTS.md

@@ -0,0 +1,149 @@
+# Оркестратор продуктового домена
+
+## Обзор
+Продуктовый домен — система агентов для **B2B SaaS product management**: от discovery до релиза. Две adversarial-оси дают устойчивость решений:
+- **Customer-Champion vs Business-Champion** — на стратегическом уровне (зачем и для кого).
+- **Build-Camp vs Cut-Camp** — на приоритизации (сколько и какой scope).
+
+Mediator синтезирует результаты обеих камп. Designer+Layouter готовят PRD / Product Review Deck в PDF.
+
+## Пайплайн A — `/ship-right-thing` (Customer-vs-Business, 6 сессий)
+```
+Сессия 1: CONDUCTOR → DISCOVERY                                        → Handoff
+Сессия 2: CONDUCTOR → CUSTOMER-CHAMPION (product_strategist α)         → Handoff
+Сессия 3: CONDUCTOR → BUSINESS-CHAMPION (product_strategist β)         → Handoff
+Сессия 4: CONDUCTOR → MEDIATOR                                         → Handoff
+Сессия 5: CONDUCTOR → PM → UX_DESIGNER + TECH_LEAD + DATA_ANALYST      → Handoff
+Сессия 6: CONDUCTOR → DESIGNER → LAYOUTER                              → PDF
+```
+
+## Пайплайн B — `/shape-prioritize` (Build-vs-Cut, 6 сессий)
+Запуск при уже утверждённой стратегии — дискуссия идёт вокруг scope.
+```
+Сессия 1: CONDUCTOR → DISCOVERY (scope intake)                         → Handoff
+Сессия 2: CONDUCTOR → BUILD-CAMP (pm α + tech_lead α)                  → Handoff
+Сессия 3: CONDUCTOR → CUT-CAMP (pm β + tech_lead β)                    → Handoff
+Сессия 4: CONDUCTOR → MEDIATOR                                         → Handoff
+Сессия 5: CONDUCTOR → PM → UX_DESIGNER + DATA_ANALYST                  → Handoff
+Сессия 6: CONDUCTOR → DESIGNER → LAYOUTER                              → PDF (PRD)
+```
+
+## Пайплайн Quick — `/quick-pm` (1 сессия, без adversarial)
+```
+CONDUCTOR → DISCOVERY → product_strategist → PM → TECH_LEAD → DATA_ANALYST → PDF
+```
+
+## Пайплайн Spec — `/spec` (1 сессия, только PRD)
+```
+CONDUCTOR → PM → UX_DESIGNER + TECH_LEAD → PRD (markdown)
+```
+
+## Команды (adversarial)
+
+| Команда | Активна в | Состав | Задача |
+|---------|-----------|--------|--------|
+| Customer-Champion (Alpha) | /ship-right-thing | product_strategist α | Стратегия вокруг user value, JTBD, adoption |
+| Business-Champion (Beta) | /ship-right-thing | product_strategist β | Стратегия вокруг revenue, margin, strategic moats |
+| Build-Camp (Alpha) | /shape-prioritize | pm α + tech_lead α | Максимальный scope: каждая фича оправдана |
+| Cut-Camp (Beta) | /shape-prioritize | pm β + tech_lead β | Минимальный scope: вырезать всё, что можно |
+| Верстальщики | все пайплайны с PDF | Designer → Layouter | Макет и вёрстка PRD / Product Review Deck |
+
+## Агенты
+
+| Роль | Файл | Зона ответственности |
+|------|-------|---------------------|
+| Дирижёр | agents/conductor.md | Оркестрация, роутинг сессий, гейт-контроль |
+| Discovery | agents/discovery.md | Scope, user research intake, jobs, assumptions |
+| Product Strategist | agents/product_strategist.md | Vision, OKR, NSM, roadmap. Играет обе стороны в Customer-vs-Business |
+| PM | agents/pm.md | Приоритизация, PRD, stories. Играет обе стороны в Build-vs-Cut |
+| UX Designer | agents/ux_designer.md | Wireframes, user flows, design brief |
+| Tech Lead | agents/tech_lead.md | Feasibility, breakdown, risk, non-functional requirements |
+| Data Analyst | agents/data_analyst.md | Experiment design, SaaS metrics, AARRR, hypothesis validation |
+| Медиатор | agents/mediator.md | Impartial synthesis Customer/Business и Build/Cut |
+| Designer | agents/designer.md | Макет PRD / Product Review Deck, визуализации |
+| Layouter | agents/layouter.md | HTML/CSS → PDF, графики, сборка документа |
+
+## Воркфлоу
+
+| Команда | Режим | Adversarial ось |
+|---------|-------|-----------------|
+| /ship-right-thing | Full Pipeline A (6 сессий) | Customer-Champion vs Business-Champion |
+| /shape-prioritize | Full Pipeline B (6 сессий) | Build-Camp vs Cut-Camp |
+| /spec | PRD Only (1 сессия) | — |
+| /quick-pm | Quick Pipeline (1 сессия) | — |
+
+## Скилы по агентам
+
+### Дирижёр
+- $board — доска задач
+- $handoff — передача между гейтами/сессиями
+- $gates — контроль гейтов
+- $session-prompt-generator — промпт следующей сессии
+
+### Discovery
+- $user-interview-script — скрипт B2B-интервью
+- $jtbd-canvas — Jobs-to-be-Done
+- $opportunity-solution-tree — дерево возможностей-решений
+- $problem-statement — формулировка проблемы
+- $assumption-mapping — карта допущений
+- $board, $handoff
+
+### Product Strategist
+- $product-vision — видение продукта
+- $okr-framework — OKR
+- $north-star-metric — NSM
+- $product-roadmap — дорожная карта
+- $kano-model — модель Кано
+- $handoff
+
+### PM
+- $rice-scoring — RICE
+- $moscow-prioritization — MoSCoW
+- $wsjf-scoring — WSJF (для enterprise)
+- $prd-template — PRD
+- $user-story — user stories
+- $acceptance-criteria — критерии приёмки
+- $epic-breakdown — декомпозиция эпика
+- $kano-model — модель Кано (для scope-дискуссий)
+- $handoff
+
+### UX Designer
+- $design-brief — бриф для дизайнера
+- $user-flow — user flows
+- $handoff
+
+### Tech Lead
+- $epic-breakdown — декомпозиция эпика
+- $handoff
+
+### Data Analyst
+- $hypothesis-template — гипотеза
+- $ab-test-design — дизайн A/B-теста
+- $saas-metrics — B2B SaaS метрики
+- $aarrr-metrics — AARRR
+- $north-star-metric — NSM (для metric design)
+- $handoff
+
+### Медиатор
+- $handoff — получение результатов обеих камп
+- $gates — финальная проверка
+
+### Designer
+- $report-design — макет PRD / Product Review Deck
+
+### Layouter
+- $html-pdf-report — HTML/CSS → PDF
+
+### Release (cross-agent skills)
+- $launch-checklist — чеклист запуска
+- $gtm-brief — GTM-бриф (handoff в marketing/sales)
+- $release-notes — release notes для B2B-клиентов
+
+## MCP-интеграции (ожидаемые)
+- **mempalace** — долгосрочная память по продукту, решения, discovery-артефакты
+- **shadcn + tailwindcss + stitch** — для UI-мокапов через UX-designer
+- **scheduled-tasks** — discovery cadence, регулярные review
+
+## Локализация
+- Default: `ru`
+- Available: `ru` (v1.0), `en` (v1.1+)

package/domains/product/AGENTS.yaml

@@ -0,0 +1,77 @@
+version: 1
+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, когда задача требует оркестрации продуктового пайплайна."
+triggers:
+  - "AGENTS.md"
+  - "оркестратор продукта"
+  - "продуктовый пайплайн"
+  - "product management"
+  - "B2B SaaS"
+  - "PRD"
+  - "roadmap"
+  - "discovery"
+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"
+invocation:
+  explicit: false
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"

package/domains/product/CONTEXT.md

@@ -0,0 +1,40 @@
+# Обзор проекта
+
+| Поле | Значение |
+|------|----------|
+| **Домен** | Product Management (B2B SaaS) |
+| **Описание** | Система агентов для продуктового менеджмента с двумя adversarial-осями |
+| **Текущая фаза** | MVP |
+
+## Результаты пайплайна A — `/ship-right-thing` (Customer-vs-Business)
+
+| Сессия | Gate | Статус | Ключевой результат | Дата |
+|--------|------|--------|---------------------|------|
+| 1 | Conductor | ☐ | — | — |
+| 1 | Discovery | ☐ | — | — |
+| 2 | Customer-Champion: Strategist | ☐ | — | — |
+| 3 | Business-Champion: Strategist | ☐ | — | — |
+| 4 | Mediator (Strategy Synthesis) | ☐ | — | — |
+| 5 | PM (prioritization + PRD) | ☐ | — | — |
+| 5 | UX Designer (wireframes) | ☐ | — | — |
+| 5 | Tech Lead (feasibility) | ☐ | — | — |
+| 5 | Data Analyst (metric plan) | ☐ | — | — |
+| 6 | Designer | ☐ | — | — |
+| 6 | Layouter | ☐ | — | — |
+| 6 | Release Gate | ☐ | — | — |
+
+## Результаты пайплайна B — `/shape-prioritize` (Build-vs-Cut)
+
+| Сессия | Gate | Статус | Ключевой результат | Дата |
+|--------|------|--------|---------------------|------|
+| 1 | Conductor | ☐ | — | — |
+| 1 | Discovery (scope intake) | ☐ | — | — |
+| 2 | Build-Camp: PM + Tech Lead | ☐ | — | — |
+| 3 | Cut-Camp: PM + Tech Lead | ☐ | — | — |
+| 4 | Mediator (Scope Synthesis) | ☐ | — | — |
+| 5 | PM (final PRD) | ☐ | — | — |
+| 5 | UX Designer | ☐ | — | — |
+| 5 | Data Analyst | ☐ | — | — |
+| 6 | Designer | ☐ | — | — |
+| 6 | Layouter | ☐ | — | — |
+| 6 | Release Gate | ☐ | — | — |