@zrg-sh/studio 0.1.0

package/template/product-specs/docs/_meta/domain-map.example.md

@@ -0,0 +1,106 @@
+---
+type: meta
+tags:
+  - meta
+  - map
+---
+
+# Domain Map
+
+5 bounded contexts MVP-системы **zrg** — Telegram-бота для уведомлений из GitHub/Linear.
+
+## Bounded contexts
+
+| Domain | Type | Status | Purpose |
+|---|---|---|---|
+| identity | Supporting | active | User-аккаунты, Connection'ы (GitHub/Linear/Telegram), LinkingToken |
+| workspace | Core | active | Workspaces, Members (RBAC), GroupTargets, refs к Subscription'ам |
+| github-integration | Supporting (ACL) | active | GitHub App, repository binding, webhook ingestion, нормализация в SourceEvent |
+| linear-integration | Supporting (ACL) | active | Linear OAuth, team binding, view polling, webhook ingestion, нормализация в SourceEvent |
+| notifications | Core | active | NotificationRule, Delivery, channel ports, slash-команды |
+
+## Overview
+
+```mermaid
+graph LR
+    subgraph Core
+        WS[workspace]
+        NT[notifications]
+    end
+
+    subgraph Supporting
+        ID[identity]
+    end
+
+    subgraph "Supporting / ACL"
+        GH[github-integration]
+        LN[linear-integration]
+    end
+
+    ID -->|UserCreated, ConnectionAdded, ConnectionRevoked, UserDeleted| WS
+    ID -->|GithubConnectionAdded, ConnectionRevoked| GH
+    ID -->|LinearConnectionAdded, ConnectionRevoked| LN
+    ID -->|TelegramConnectionAdded, ConnectionRevoked, UserDeleted| NT
+
+    WS -->|SubscriptionRequested, SubscriptionRemoved, WorkspaceArchived| GH
+    WS -->|SubscriptionRequested, SubscriptionRemoved, WorkspaceArchived| LN
+    WS -->|MemberRemoved, GroupTargetRegistered/Unregistered, SubscriptionRemoved, WorkspaceArchived| NT
+
+    GH -->|SubscriptionActivated/Failed| WS
+    LN -->|SubscriptionActivated/Failed| WS
+
+    GH -->|SourceEvent source=github| NT
+    LN -->|SourceEvent source=linear| NT
+
+    GH -.->|ACL: GitHub App / Webhooks / REST| EXTGH[(GitHub)]
+    LN -.->|ACL: Linear OAuth / Webhooks / GraphQL| EXTLN[(Linear)]
+    NT -.->|Telegram Bot API| EXTTG[(Telegram)]
+
+    style WS fill:#4a9eff,color:#fff
+    style NT fill:#4a9eff,color:#fff
+    style ID fill:#f5c95b,color:#000
+    style GH fill:#f5c95b,color:#000
+    style LN fill:#f5c95b,color:#000
+    style EXTGH fill:#6c757d,color:#fff
+    style EXTLN fill:#6c757d,color:#fff
+    style EXTTG fill:#6c757d,color:#fff
+```
+
+> [!info] Legend
+> - Синий: Core (содержат основную бизнес-ценность)
+> - Жёлтый: Supporting (поддерживают core, в т.ч. ACL к внешним системам)
+> - Серый: External systems
+
+## Context mapping patterns
+
+| Pair | Pattern | Notes |
+|---|---|---|
+| identity → workspace | Customer/Supplier | identity — supplier; workspace — customer (потребляет UserCreated, ConnectionRevoked, UserDeleted) |
+| identity → github-integration | Customer/Supplier | github-integration индексирует mapping `githubUserId ↔ userId` |
+| identity → linear-integration | Customer/Supplier | linear-integration индексирует mapping `linearUserId ↔ userId`, использует token из Connection |
+| identity → notifications | Customer/Supplier | notifications читает TelegramConnection для DM-доставки, реагирует на revoke |
+| workspace → github-integration | Customer/Supplier | workspace эмитит SubscriptionRequested(github); integration возвращает SubscriptionActivated/Failed |
+| workspace → linear-integration | Customer/Supplier | аналогично; viaConnectionId — это LinearConnection системного аккаунта `WorkspaceLinearBot` |
+| workspace → notifications | Customer/Supplier | notifications реагирует на MemberRemoved, GroupTarget*, SubscriptionRemoved, WorkspaceArchived |
+| github-integration → notifications | Published Language | стабильный контракт `SourceEvent` |
+| linear-integration → notifications | Published Language | стабильный контракт `SourceEvent` |
+| github-integration → GitHub | ACL | webhook payload + REST → нормализация |
+| linear-integration → Linear | ACL | webhook payload + GraphQL → нормализация |
+
+## Shared Kernel
+
+Минимальный:
+- VO: `UserId`, `WorkspaceId`, `MemberId`, `ConnectionId`, `SourceEventId`, `WorkspaceLinearBotId`.
+- Канонический тип `SourceEvent` (см. context-map: published language от integration в notifications).
+- Result/Error type для команд.
+
+НЕ shared: aggregates, репозитории, схемы хранения.
+
+## Active domains list
+
+```dataview
+TABLE owner, status, length(file.inlinks) AS "refs"
+FROM "domains"
+WHERE type = "domain"
+SORT domain
+```

package/template/product-specs/docs/_meta/glossary.example.md

@@ -0,0 +1,72 @@
+---
+type: meta
+tags:
+  - meta
+  - glossary
+---
+
+# Glossary
+
+Cross-domain shared terms zrg. Для терминов внутри одного BC — см. `domains/<BC>/ubiquitous-language.md`.
+
+## Auto-index (all UL terms)
+
+```dataview
+TABLE domain AS "Domain"
+FROM "domains"
+WHERE type = "ubiquitous-language"
+SORT domain
+```
+
+## Cross-domain shared terms
+
+| Term | Definition | Owner domain | Used by |
+|---|---|---|---|
+| User | Физическое лицо, аутентифицированное в web. Глобальная identity. | identity | workspace (как Member.userId), notifications, integrations (mapping) |
+| UserId | Reference to identity.User | identity | все домены через ID-references |
+| Connection | Привязка User к внешнему аккаунту (GitHub/Linear/Telegram). Discriminated by type. | identity | github-integration, linear-integration, notifications |
+| Workspace | Основная организационная единица. Контейнер Member'ов и привязок ресурсов. | workspace | все домены |
+| WorkspaceId | Reference to Workspace | workspace | все домены через ID-references |
+| Member | User+role+workspaceId. NOT синоним «User» — Member per-workspace. | workspace | notifications (target.kind='member'), authorization checks |
+| MemberRole | RBAC роль: `owner` / `admin` / `member`. Простой RBAC (Q17), без custom-permissions. | workspace | все мутирующие commands |
+| Subscription | Привязка внешнего ресурса (GitHub repo / Linear team) к Workspace. **Reference в workspace; aggregate в integration**. | workspace + integration | notifications (filter), workspace (read-projection) |
+| SubscriptionState | `pending` / `active` / `broken` / `removed`. | github-integration / linear-integration | workspace (read-projection) |
+| GroupTarget | Зарегистрированный групповой Telegram-чат, привязанный к Workspace. | workspace | notifications (target.kind='group') |
+| WorkspaceLinearBot | Per-workspace системный Linear OAuth-токен (сервисный аккаунт `workspace-bot@…`). Авторитет для polling/webhook. **НЕ User'ский Connection** (Q10). | linear-integration | workspace (read-projection «bot connected»), notifications (косвенно через SourceEvent) |
+| SourceEvent | Канонический нормализованный event из integration в notifications (Published Language). source ∈ {'github', 'linear'}. | github-integration / linear-integration | notifications (consumer) |
+| SourceEventId | UUID v4, наш id (НЕ external delivery id). | integration | notifications (dedup key) |
+| NotificationRule | Декларативное правило: trigger+filter+target+channel. Owner = Member или Workspace. | notifications | — |
+| NotificationTarget | Discriminated union: `MemberTarget | GroupTarget` (Q16). | notifications | — |
+| NotificationChannel | Port (interface). MVP реализация — `TelegramChannel`. | notifications | — |
+| Delivery | Экземпляр доставки. Дедуп по `(ruleId, sourceEventId, targetSnapshot.id)`. Retention 30 дней (Q15). | notifications | — |
+| Channel (enum value) | `'telegram'` в MVP. Расширяется на `'slack'`/`'discord'`/`'email'`. | notifications | — |
+| LinkingToken | Одноразовый short-lived токен для связки Telegram через deep-link `t.me/<bot>?start=<token>`. TTL 10 мин. | identity | bot (consume) |
+| WebhookEvent | Запись о факте получения webhook'а (для дедупликации и аудита). Per-source (github/linear), но общая семантика. | github-integration / linear-integration | — |
+
+## Integration / source-of-truth quick reference
+
+| Question | Where |
+|---|---|
+| Кто User и какие у него Connection? | identity |
+| В каком Workspace состоит User и с какой ролью? | workspace |
+| Какие репо/команды привязаны к Workspace? | workspace (refs) + github-integration / linear-integration (aggregates) |
+| Кому отправлять уведомление? | notifications.NotificationRule |
+| Что доставлено / что failed? | notifications.Delivery |
+| Какие issues просрочены? | linear-integration.GetOverdueIssues (live GraphQL) |
+| Тело issue / PR / comment? | live fetch via integration query (Q9: не зеркалим) |
+
+## Meta terms
+
+| Term | Definition | Notes |
+|---|---|---|
+| PRDCT | Change package — immutable набор документов одного изменения | Формат: `PRDCT-XXXX` |
+| ADR | Architecture Decision Record | Формат: `ADR-XXX` |
+| Bounded Context | Явная граница, внутри которой модель имеет определённый смысл | DDD-термин |
+| Aggregate | Кластер доменных объектов, обрабатываемых как единица | DDD-термин |
+| Invariant | Правило, которое не может быть нарушено ни при каких обстоятельствах | Строже чем business rule |
+| Ubiquitous Language | Общий словарь терминов в пределах BC | DDD-термин |
+| Shared Kernel | Паттерн: общее ядро (структуры/сущности) между двумя BC | DDD context mapping |
+| Published Language | Стабильный контракт, которым BC обменивается с потребителями | DDD context mapping |
+| ACL (Anti-Corruption Layer) | Изоляция от внешней модели через адаптер | DDD context mapping |
+| Outbox | Таблица, в которую в той же транзакции что и агрегат пишется integration event | Затем publisher читает и публикует в Redis pub/sub |
+| Idempotency Key | Ключ, по которому повторная доставка одного и того же события не порождает дубликата эффекта | Применяется в WebhookEvent + Delivery dedup |

package/template/product-specs/docs/_meta/onboarding.example.md

@@ -0,0 +1,142 @@
+---
+type: meta
+status: active
+tags:
+  - meta
+  - onboarding
+created: 2026-04-28
+---
+
+# Onboarding · zrg
+
+## Что это за проект
+
+**zrg** — Telegram-бот для уведомлений из GitHub/Linear с глубокой интеграцией. Workspace = ключевая сущность, к ней привязываются GitHub-репозитории и Linear-команды. Member'ы подключают свои GitHub/Linear/Telegram. Бот доставляет уведомления (DM или в групповой чат) по настраиваемым правилам и подсвечивает просроченные тикеты Linear.
+
+## MVP scope
+
+- workspaces, members, привязка GH/Linear/TG через web;
+- уведомления о новых GH issues;
+- уведомления по Linear views;
+- подсветка просроченных Linear тикетов;
+- slash-команды в групповых чатах (`/status`, `/overdue`, `/views`, `/register`).
+
+**НЕ делаем в MVP:** Claude-агенты, чат-функционал между пользователями, Slack/Discord/Email каналы (architecture-ready, реализаций нет), биллинг.
+
+## Documentation-first development
+
+Любое изменение начинается с документа, не с кода. Каждый change package (PRDCT-XXXX) — immutable набор бизнес-документов, проходящих pipeline:
+
+```mermaid
+flowchart LR
+    S01["01 Intent\n/pm"] --> S02["02 Scenarios\n/scenarios"]
+    S02 --> S03["03 Analysis\n/analyst"]
+    S03 --> S04["04 Domain\n/domain-framer"]
+    S04 --> S05["05 UX\n/designer"]
+    S05 --> S06["Executor\n(code)"]
+    S06 --> S07["Merger\n(domain docs)"]
+```
+
+> [!danger] Правило 1
+> **Нет документа — нет задачи.** PR без ссылки на PRDCT-* не мержится.
+
+## Структура документации
+
+```
+product-specs/
+├── docs/
+│   ├── domains/                Бизнес-домены (5 BC):
+│   │   ├── identity/           User, Connection, LinkingToken
+│   │   ├── workspace/          Workspace, Member, GroupTarget, refs
+│   │   ├── github-integration/ Installation, Subscription, WebhookEvent, ACL
+│   │   ├── linear-integration/ WorkspaceLinearBot, Subscription, WatchedView, ACL
+│   │   └── notifications/      NotificationRule, Delivery, channels, slash
+│   ├── changes/                PRDCT-XXXX: immutable
+│   ├── adrs/                   Architecture Decision Records
+│   ├── contexts/               Платформенное знание (стек):
+│   │   ├── backend/            Bun + NestJS + Prisma + tRPC + GraphQL
+│   │   └── frontend/           Next.js 16 + Apollo + shadcn + FSD
+│   └── _meta/                  Схема, карты, глоссарий, onboarding
+├── agents/                     AI-роли (PM, Analyst, Designer, Merger)
+├── rules/                      Правила документации
+├── references/                 DDD/pipeline conventions
+└── templates/                  Шаблоны (change, domain, meta)
+```
+
+## Зафиксированные архитектурные решения
+
+| Q | Решение | Где применено |
+|---|---|---|
+| Q1 | Telegram ↔ User строго **1:1** | identity/business-rules, identity/invariants |
+| Q4 | User ↔ Workspace = **1:N** (User в нескольких WS) | workspace/business-rules |
+| Q5 | Owner покидает workspace → **auto-promote самого старшего admin'а**; нет admin'ов → archive | workspace/business-rules, events |
+| Q9 | НЕ зеркалим тело issue/ticket. **Metadata + ссылка**, тело on-demand | github-integration/business-rules, linear-integration/business-rules |
+| Q10 | Linear OAuth-токен привязан к **WorkspaceLinearBot** (per workspace), не к User | linear-integration/aggregates, business-rules |
+| Q12 | Polling Linear views — **5 минут** (env `LINEAR_VIEW_POLL_INTERVAL_MS=300000`) | linear-integration/operational-sla, business-rules |
+| Q13 | Дедупликация — **N сообщений на N rules** (без агрегации) | notifications/business-rules |
+| Q15 | Retention Delivery — **30 дней** (env `DELIVERY_RETENTION_DAYS=30`) | notifications/operational-sla, invariants |
+| Q16 | Target = **MemberTarget \| GroupTarget** (first-class discriminated union) | notifications/aggregates |
+| Q17 | Authz — **простой RBAC** (`owner`/`admin`/`member`), без ABAC | workspace/business-rules |
+
+## Стэк (зафиксирован)
+
+**Backend:** Bun runtime · NestJS (DDD) · Prisma + PostgreSQL · nestjs-trpc (бот ↔ backend) · @nestjs/graphql code-first (web ↔ backend) · @nestjs/cqrs · BullMQ + Redis · Outbox + Redis pub/sub.
+
+**Bot:** Grammy на Bun (тонкий клиент, вся логика в backend через tRPC).
+
+**Web:** Next.js 16 App Router · Apollo Client (graphql-codegen, near-operation-file) · shadcn/ui + Radix + Tailwind · FSD по доменам · prod runtime `node:20-alpine` (build на Bun, runtime Node — из-за Bun memory leak в Next.js prod апрель 2026).
+
+**Интеграции:** GitHub App (не OAuth App) · Linear OAuth + webhook + polling · Telegram deep-link.
+
+См. `contexts/backend/README.md` и `contexts/frontend/README.md` для деталей.
+
+## Что лежит где
+
+```
+Question                                           -> Location
+---------------------------------------------------------------
+Что делает домен X?                                -> domains/<X>/README.md
+Какие агрегаты и state machines в X?              -> domains/<X>/aggregates.md
+Какие бизнес-правила X?                            -> domains/<X>/business-rules.md
+Что не может быть нарушено в X?                   -> domains/<X>/invariants.md
+Какие события эмитит/потребляет X?                 -> domains/<X>/events.md
+Какие термины в X?                                 -> domains/<X>/ubiquitous-language.md
+Какие SLA / лимиты у X?                            -> domains/<X>/operational-sla.md
+Кто владеет доменом X?                             -> domains/<X>/ownership.md
+
+Cross-domain карта связей                         -> _meta/domain-map.md
+Cross-domain термины                              -> _meta/glossary.md
+Что система УМЕЕТ?                                -> _meta/capability-map.md
+
+Backend stack & conventions                       -> contexts/backend/
+Frontend stack & conventions                      -> contexts/frontend/
+Архитектурные решения (почему так)                 -> adrs/ADR-XXX.md
+Что изменилось в фиче Y?                          -> changes/PRDCT-XXXX/
+```
+
+## Pipeline команды (когда появятся agents)
+
+1. `/pm <описание фичи>` → 01-intent.md (PRDCT-XXXX создан)
+2. `/scenarios PRDCT-XXXX` → 02-scenarios.md (Gherkin)
+3. `/analyst PRDCT-XXXX` → 03-analysis.md
+4. `/domain-framer PRDCT-XXXX` → 04-domain.md
+5. `/designer PRDCT-XXXX` → 05-ux.md + mockups/
+6. `/review PRDCT-XXXX` → проверка целостности
+7. Status → done. Executor пишет код, merger обновляет domain docs.
+
+> [!tip] Быстрый запуск
+> `/feature <описание>` — весь pipeline одной командой.
+
+## Key rules
+
+> [!danger] Domain docs — только бизнес-знание
+> domains/* содержат бизнес-правила, агрегаты, события, инварианты. Никаких Prisma-схем, NestJS-модулей, file paths, REST/GraphQL endpoints в `business-rules.md`/`aggregates.md`/`events.md`/`invariants.md`. Реализационные детали — в `data-model.md`/`api-contracts.md` (заполняются из кода).
+
+> [!danger] Change packages иммутабельны
+> После мержа никогда не редактируются. Фиксы — отдельный PRDCT.
+
+> [!danger] Техника не в change package
+> Change package содержит ТОЛЬКО бизнес-документы. Технические решения принимает executor.
+
+> [!danger] PR привязан к PRDCT
+> PR без ссылки на PRDCT-* не мержится.

package/template/product-specs/docs/_meta/product-vision.example.md

@@ -0,0 +1,136 @@
+---
+type: meta
+status: active
+tags:
+  - meta
+  - vision
+  - north-star
+created: 2026-04-30
+---
+
+# Product Vision · zrg
+
+> Верхнеуровневое «куда мы идём». Читается агентами пайплайна (PM, Analyst, Domain Framer, Designer) как контекст для принятия решений по доменам и фичам. Это **не roadmap** — это вектор, объясняющий, почему домены устроены именно так, и куда они эволюционируют.
+
+---
+
+## Что мы строим (одной фразой)
+
+**Коллаборативный инструмент vibe-coding'а спецификаций продукта и больших систем** — платформа, где **колоды AI-агентов** ведут команду через пайплайн разработки спеки (intent → scenarios → analysis → domain → ux → …), а **люди в команде отыгрывают свои роли**, отвечая на вопросы агентов и валидируя их выводы.
+
+Продукт — это и есть тот pipeline, который сейчас лежит в `product-specs/` и которым этот репозиторий пользуется сам на себе (dogfooding).
+
+---
+
+## North Star
+
+Команда заходит в workspace, заводит фичу/систему, и **колода агентов прогоняет спеку через пайплайн**. Агенты задают вопросы конкретным ролям (PM-у — про intent, бэкенд-разработчику — про инварианты, дизайнеру — про UX), люди отвечают в удобном канале (Telegram DM, групповой чат, web — что подключено), и через несколько итераций получается **immutable change package со всеми бизнес-документами**, готовый к executor'у.
+
+Спецификация **живёт в git-репозитории команды как код** (markdown + структура), а не в нашей БД. Мы — оркестратор агентов и канал коммуникации, не хранилище спек.
+
+---
+
+## Ключевые сдвиги в модели
+
+Чтобы было однозначно — это **не** «Telegram-бот для уведомлений из GitHub/Linear». Текущий MVP (workspace + GH/Linear/notifications) — это **фундамент инфраструктуры**, на котором поедет настоящий продукт. Реальный продукт это:
+
+| Что | Описание |
+|---|---|
+| **Колоды агентов — first-class** | Люди ассистируют агентам, не наоборот. Агент инициирует диалог, человек отвечает в своей роли. |
+| **Спека = код в git** | Документы спеки коммитятся в репозиторий команды. Мы не master-копия, мы — оркестратор. |
+| **Workspace = команда над одним проектом** | Не «организация с N проектами». Один workspace — одна продуктовая инициатива / система. |
+| **Интеграции — двусторонние каналы Q&A** | GH/Linear/Telegram/etc. — не источники уведомлений, а каналы общения агента с конкретным человеком в его роли. |
+| **Notifications — это призывы, не дайджесты** | «Агент задал вопрос», «требуется ваше внимание», «спека прошла стадию». Не «вышло 5 новых issues». |
+
+---
+
+## Не-цели
+
+- ❌ **Не issue tracker.** GitHub/Linear остаются source-of-truth для тикетов; мы синхронизируемся, но не заменяем.
+- ❌ **Не платформа для исполнения кода / CI.** Executor (тот, кто пишет код по спеке) — отдельная стадия, может быть человеком, может быть Claude Code, нашей задачей не является.
+- ❌ **Не SaaS с биллингом / multi-tenant стратегией.** Монетизация не в фокусе.
+- ❌ **Не messenger.** Мы используем Telegram (и в будущем другие каналы) как транспорт диалога агент↔человек, не строим внутрикомандный чат.
+- ❌ **Не master-хранилище спек.** Спека живёт в git у команды; мы оркестрируем процесс, не владеем артефактами.
+- ❌ **Не universal product management tool.** Фокус — техническая разработка продуктов и систем, где спецификация = архитектурный артефакт.
+
+---
+
+## Эволюция доменов
+
+Текущие 5 bounded contexts (`identity`, `workspace`, `github-integration`, `linear-integration`, `notifications`) — это **инфраструктурный слой** для настоящего продукта. По мере реализации vision добавятся домены, отражающие ядро.
+
+### Существующие домены (фундамент)
+
+#### `identity`
+- **Сегодня:** auth + connections (GitHub/Linear/Telegram).
+- **Дальше:** SSO для команд, identity по ролям внутри workspace (кто PM, кто backend, кто designer — для маршрутизации вопросов от агентов), новые provider'ы интеграций.
+
+#### `workspace`
+- **Сегодня:** workspace = команда + RBAC + group target.
+- **Дальше:** **role assignments** (member→{PM, backend, frontend, designer, …} — агент знает, кому задавать какой вопрос), привязка к git-репозиторию команды (где живёт спека), workspace-level настройки колоды агентов.
+
+#### `github-integration` / `linear-integration`
+- **Сегодня:** webhook + binding + ACL + уведомления о событиях.
+- **Дальше:** двусторонняя связь со спекой — PRDCT в спеке порождает issue/тикет в трекере и наоборот; статус спеки синхронизируется со статусом тикета; comment в issue → context для агента.
+
+#### `notifications`
+- **Сегодня:** rules + Telegram delivery + slash-команды.
+- **Дальше:** notification = **призыв к действию** (агент ждёт ответа), а не информационный поток. Каналы расширяются (Slack, Discord, Email, web push), интерактивность — inline-actions для ответа агенту прямо из канала.
+
+### Новые домены (ядро будущего продукта)
+
+Появятся как только инфраструктурный фундамент будет готов:
+
+- **`agents`** — колода агентов, их роли, конфигурация, активные сессии, состояние диалога с командой.
+- **`specifications`** — change packages (PRDCT-*), стадии pipeline, связь с git-репозиторием команды, immutability rules.
+- **`pipeline`** — оркестрация прогона спеки через стадии (intent→scenarios→analysis→…), gate validation, переходы.
+- **`conversations`** — диалоги агентов с людьми (вопрос→ответ→follow-up), маршрутизация по ролям, контекст диалога, история.
+- **`integrations`** *(вероятно эволюция)* — обобщение GH/Linear/Telegram в общую модель «канал двустороннего Q&A», под которую подключаются новые источники.
+
+Названия и границы — предварительные, фиксируются при реальном PRDCT, который их вводит.
+
+---
+
+## Продуктовые принципы
+
+Решения по доменам и фичам сверяются с этими принципами:
+
+1. **Агент ведёт, человек отыгрывает роль.** Если фича заставляет человека инициировать каждый шаг — это противоречит модели.
+2. **Спека — код, не данные.** Артефакты спеки живут в git у команды. Мы можем читать/писать в репо команды, но не дублируем спеку у себя как master-копию.
+3. **Команда работает над одним проектом.** Workspace ≡ project. Если у команды два проекта — два workspace'а. Это упрощает RBAC, ownership и контекст агентов.
+4. **Каналы — first-class, но взаимозаменяемы.** Telegram сегодня основной транспорт диалога, но домен `conversations` спроектирован под N каналов. Slack/Discord/Email/web push — новая реализация порта, не редизайн.
+5. **Source-of-truth — внешние системы.** GitHub/Linear/git — источники правды. Конфликт = переспросить источник, не разруливать локально.
+6. **Колода агентов сегодня фиксирована.** PM, Scenario Writer, Analyst, Domain Framer, Designer, Merger. Кастомизация колод — далёкое будущее, не закладываемся сейчас.
+7. **Documentation-first внутри продукта-про-документацию.** Любая фича — через PRDCT. Vision (этот документ) — контекст для PM при создании intent.
+8. **YAGNI на агентов и pipeline.** Не закладываем абстракции под несуществующие роли/стадии. Фиксированный набор расширяется через PRDCT, когда возникнет реальная потребность.
+
+---
+
+## Как этот документ используется
+
+- **PM (`/pm`)** — сверяет новый intent с не-целями и принципами; если фича уводит от ядра (vibe-coding спек) — оформляется отказом или эскалацией.
+- **Domain Framer (`/domain-framer`)** — при добавлении aggregate / события сверяется с траекторией домена (раздел «Эволюция»). Особенно при появлении нового BC — должен матчить «Новые домены» или явно расширять vision.
+- **Analyst (`/analyst`)** — держит north-star в голове при анализе scenarios, чтобы не уводить фичу в сторону.
+- **Designer (`/designer`)** — UX следует «агент ведёт, человек отыгрывает роль»; экраны проектируются как ответы на призывы, а не как dashboard'ы.
+- **Reviewer / merger** — отказывает PRDCT, противоречащему vision, без отдельного change-process'а.
+
+---
+
+## Когда обновлять vision
+
+Vision **живой**, но **редко меняется**. Обновляется когда:
+- появляется новый bounded context, не описанный в «Эволюции» (добавить раздел);
+- меняется north-star (стратегический пивот → ADR + апдейт здесь);
+- одно из «не-целей» становится целью (осознанное решение + ADR);
+- расширяется колода агентов или модель спеки.
+
+Обычные фичи (новый PRDCT в существующей траектории) **не обновляют** vision.
+
+---
+
+## Связанные документы
+
+- `_meta/onboarding.md` — что такое проект сегодня (MVP scope, стек, pipeline)
+- `_meta/capability-map.md` — что система УМЕЕТ (по доменам, текущее состояние)
+- `_meta/domain-map.md` — связи между bounded contexts
+- `adrs/` — архитектурные решения, обосновывающие текущее устройство

package/template/product-specs/hooks/studio-conflict-detect.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Studio Conflict Detector
+# PostToolUse hook: checks for domain conflicts when metadata.yaml is written
+# Exit 0 always (advisory, non-blocking)
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+# Only check metadata.yaml in change packages
+if [[ ! "$FILE_PATH" == *"product-specs/docs/changes/"*"metadata.yaml" ]]; then
+  exit 0
+fi
+
+# Skip templates
+if [[ "$FILE_PATH" == *"_template/"* ]] || [[ "$FILE_PATH" == *"_example/"* ]] || [[ "$FILE_PATH" == *"_golden/"* ]]; then
+  exit 0
+fi
+
+# Extract current PRDCT domains
+CURRENT_PRDCT_DIR=$(dirname "$FILE_PATH")
+CURRENT_PRDCT=$(basename "$CURRENT_PRDCT_DIR")
+CURRENT_DOMAINS=$(grep "^domains:" "$FILE_PATH" 2>/dev/null | sed 's/^domains:[[:space:]]*\[//' | sed 's/\]//' | tr ',' '\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | grep -v '^$')
+
+if [[ -z "$CURRENT_DOMAINS" ]]; then
+  exit 0
+fi
+
+# Check other active PRDCTs
+CHANGES_DIR=$(dirname "$CURRENT_PRDCT_DIR")
+CONFLICTS=""
+
+for meta in "$CHANGES_DIR"/PRDCT-*/metadata.yaml; do
+  OTHER_PRDCT_DIR=$(dirname "$meta")
+  OTHER_PRDCT=$(basename "$OTHER_PRDCT_DIR")
+
+  # Skip self, templates, done
+  [[ "$OTHER_PRDCT" == "$CURRENT_PRDCT" ]] && continue
+  [[ "$OTHER_PRDCT" == "_template" ]] && continue
+  [[ "$OTHER_PRDCT" == "_example" ]] && continue
+  [[ "$OTHER_PRDCT" == "_golden" ]] && continue
+
+  OTHER_STATUS=$(grep "^status:" "$meta" 2>/dev/null | head -1 | sed 's/^status:[[:space:]]*//' | sed 's/[[:space:]]*#.*//')
+  [[ "$OTHER_STATUS" == "done" ]] && continue
+
+  OTHER_DOMAINS=$(grep "^domains:" "$meta" 2>/dev/null | sed 's/^domains:[[:space:]]*\[//' | sed 's/\]//' | tr ',' '\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | grep -v '^$')
+
+  for domain in $CURRENT_DOMAINS; do
+    if echo "$OTHER_DOMAINS" | grep -q "^${domain}$"; then
+      CONFLICTS="$CONFLICTS\n  ⚠️ $CURRENT_PRDCT and $OTHER_PRDCT both touch domain '$domain'"
+    fi
+  done
+done
+
+if [[ -n "$CONFLICTS" ]]; then
+  echo "DOMAIN CONFLICT DETECTED:$CONFLICTS" >&2
+  echo "Recommended: /studio-review to check overlaps" >&2
+fi
+
+exit 0

package/template/product-specs/hooks/studio-context-monitor.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+'use strict';
+
+// Studio Context Monitor
+// PostToolUse hook: warns when context window is running low
+// 35% = WARNING, 25% = CRITICAL
+
+const input = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
+
+// Only check after significant operations
+const significantTools = ['Read', 'Edit', 'Write', 'Agent', 'Bash'];
+const toolName = input.tool_name || '';
+if (!significantTools.some(t => toolName.startsWith(t))) {
+  process.exit(0);
+}
+
+// Check session metrics if available
+const sessionId = input.session_id || '';
+const tmpFile = `/tmp/claude-ctx-${sessionId}.json`;
+
+try {
+  const fs = require('fs');
+  if (fs.existsSync(tmpFile)) {
+    const metrics = JSON.parse(fs.readFileSync(tmpFile, 'utf8'));
+    const remaining = metrics.remaining_pct || 100;
+
+    if (remaining <= 25) {
+      process.stderr.write(`\n⚠️ CRITICAL: Context window at ${remaining}%. Save state to STATE.md immediately and wrap up.\n`);
+    } else if (remaining <= 35) {
+      process.stderr.write(`\n⚠️ WARNING: Context window at ${remaining}%. Consider completing current stage soon.\n`);
+    }
+  }
+} catch (e) {
+  // Silently ignore - metrics may not be available
+}
+
+process.exit(0);

package/template/product-specs/hooks/studio-domain-guard.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Hook: PostToolUse for Write/Edit in product-specs/docs/domains/
+# Validates domain doc conventions
+#
+# Input: JSON on stdin with tool_input
+# Exit 0 = ok, Exit 2 = block with message
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+# Only check docs/domains files
+if [[ ! "$FILE_PATH" == *"product-specs/docs/domains/"* ]]; then
+  exit 0
+fi
+
+# Skip templates
+if [[ "$FILE_PATH" == *"_template/"* ]]; then
+  exit 0
+fi
+
+DOMAIN_DIR=$(dirname "$FILE_PATH")
+DOMAIN_NAME=$(basename "$DOMAIN_DIR")
+
+# Check that all required files exist in domain
+REQUIRED_FILES=("README.md" "ubiquitous-language.md" "aggregates.md" "business-rules.md" "events.md" "invariants.md" "integrations.md" "ownership.md")
+
+MISSING=""
+for f in "${REQUIRED_FILES[@]}"; do
+  if [[ ! -f "$DOMAIN_DIR/$f" ]]; then
+    MISSING="$MISSING $f"
+  fi
+done
+
+if [[ -n "$MISSING" ]]; then
+  echo "Domain '$DOMAIN_NAME' missing files:$MISSING" >&2
+  # Don't block — just warn (exit 0 with stderr output shown to Claude)
+  exit 0
+fi
+
+exit 0

package/template/product-specs/hooks/studio-prompt-guard.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+'use strict';
+
+// Studio Prompt Guard
+// PreToolUse hook for Task/Agent: detects potential prompt injection
+// Advisory only — warns but does not block
+
+const input = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
+const toolName = input.tool_name || '';
+
+if (toolName !== 'Task' && toolName !== 'Agent') {
+  process.exit(0);
+}
+
+const prompt = (input.tool_input && input.tool_input.prompt) || '';
+
+// Injection patterns
+const patterns = [
+  /ignore\s+(previous|above|all)\s+instructions/i,
+  /you\s+are\s+now\s+/i,
+  /system\s*:\s*/i,
+  /\bdo\s+not\s+follow\b/i,
+  /override\s+(safety|rules|instructions)/i,
+  /pretend\s+(you|to\s+be)/i,
+  /jailbreak/i,
+  /base64\s+decode/i
+];
+
+for (const pattern of patterns) {
+  if (pattern.test(prompt)) {
+    process.stderr.write(`\n⚠️ STUDIO PROMPT GUARD: Suspicious pattern detected in agent prompt: ${pattern.source}\nThis is advisory — review the prompt if unexpected.\n`);
+    break;
+  }
+}
+
+process.exit(0);