@zrg-sh/studio 0.1.0

package/template/product-specs/templates/domain/business-rules.md

@@ -0,0 +1,30 @@
+---
+type: business-rules
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+  - business-rule
+---
+
+# Business rules · [Domain name]
+
+## Rules
+
+### [Rule name]
+
+> [!info] Rule: [Rule name]
+> [Описание правила]
+
+- **Rationale:**
+- **Source:** (ADR / decision / legal / product)
+
+> [!bug] Edge case
+> [Описание edge case]
+
+## Policies
+-
+
+## Corner cases
+
+> [!warning] [Corner case name]
+> [Описание corner case и как с ним справляться]

package/template/product-specs/templates/domain/changelog.md

@@ -0,0 +1,25 @@
+---
+type: changelog
+domain: _template
+status: active
+tags:
+  - domain/_template
+  - changelog
+created: YYYY-MM-DD
+---
+
+# Changelog
+
+История изменений домена. Обновляется автоматически agent-merger'ом после закрытия каждого PRDCT/DMNPRDCT.
+
+## Changes
+
+<!-- Автогенерируемый раздел. Формат:
+### DMNPRDCT-XXXX · [title] · [date]
+- **Business rules:** [что добавлено/изменено]
+- **Events:** [новые/изменённые события]
+- **Aggregates:** [изменения структуры]
+- **Invariants:** [новые/изменённые инварианты]
+- **API:** [новые/изменённые endpoints]
+- **DB:** [миграции]
+-->

package/template/product-specs/templates/domain/data-model.md

@@ -0,0 +1,34 @@
+---
+type: data-model
+domain: _template
+status: draft
+tags:
+  - domain/_template
+  - database
+created: YYYY-MM-DD
+---
+
+# Data model
+
+## Tables
+| Table | Description | Owner | Rows estimate |
+|-------|-------------|-------|---------------|
+
+## Schema
+
+### [Table name]
+| Column | Type | Nullable | Default | Description |
+|--------|------|----------|---------|-------------|
+
+## Indexes
+| Table | Index | Columns | Type | Purpose |
+|-------|-------|---------|------|---------|
+
+## Migrations history
+| Migration | Date | PRDCT | Description |
+|-----------|------|-----|-------------|
+
+## ER diagram
+```mermaid
+erDiagram
+```

package/template/product-specs/templates/domain/events.md

@@ -0,0 +1,24 @@
+---
+type: events
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+  - event
+---
+
+# Domain events · [Domain name]
+
+| Event | Producer | Consumers | Payload | Guarantees | Idempotency |
+|---|---|---|---|---|---|
+
+## Event flow
+
+```mermaid
+sequenceDiagram
+    participant P as Producer
+    participant C1 as Consumer 1
+    participant C2 as Consumer 2
+
+    P->>C1: EventName
+    P->>C2: EventName
+```

package/template/product-specs/templates/domain/integrations.md

@@ -0,0 +1,27 @@
+---
+type: integrations
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+  - integration
+---
+
+# Integrations · [Domain name]
+
+## Upstream dependencies
+<!-- Системы, от которых зависит этот домен -->
+
+## Downstream consumers
+<!-- Системы, которые зависят от этого домена -->
+
+## Integration diagram
+
+```mermaid
+graph LR
+    UP1[Upstream 1] --> THIS[This Domain]
+    THIS --> DOWN1[Downstream 1]
+```
+
+## Integration contracts
+| System | Direction | Protocol | Contract | SLA |
+|---|---|---|---|---|

package/template/product-specs/templates/domain/invariants.md

@@ -0,0 +1,14 @@
+---
+type: invariants
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+  - invariant
+---
+
+# Invariants · [Domain name]
+
+> [!danger] Invariants
+> Не могут быть нарушены ни при каких обстоятельствах. Каждое изменение домена ОБЯЗАНО пройти проверку по этому списку.
+
+- [ ] [Описание инварианта]

package/template/product-specs/templates/domain/links.yaml

@@ -0,0 +1,20 @@
+domain: ""
+owner: ""
+
+upstream_domains: []
+downstream_domains: []
+
+aggregates: []
+
+domain_events:
+  produced: []
+  consumed: []
+
+code_refs:
+  backend: []
+  frontend: []
+
+related_adrs: []
+related_changes: []
+
+tags: []

package/template/product-specs/templates/domain/operational-sla.md

@@ -0,0 +1,32 @@
+---
+type: operational-sla
+domain: _template
+status: draft
+tags:
+  - domain/_template
+  - sla
+  - operations
+created: YYYY-MM-DD
+---
+
+# Operational SLA
+
+## Performance targets
+| Metric | Target | Current | Measurement |
+|--------|--------|---------|-------------|
+
+## Timeouts
+| Operation | Timeout | Retry policy | Fallback |
+|-----------|---------|-------------|----------|
+
+## Rate limits
+| Endpoint/Operation | Limit | Per | Burst |
+|-------------------|-------|-----|-------|
+
+## Monitoring
+| Alert | Condition | Severity | Runbook |
+|-------|-----------|----------|---------|
+
+## Dependencies SLA
+| Dependency | Expected uptime | Impact if down |
+|-----------|----------------|----------------|

package/template/product-specs/templates/domain/ownership.md

@@ -0,0 +1,13 @@
+---
+type: ownership
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+---
+
+# Ownership · [Domain name]
+
+## Owner
+## Approves changes
+## Responsible for
+## Escalation path

package/template/product-specs/templates/domain/scenarios.md

@@ -0,0 +1,65 @@
+---
+type: scenarios
+domain: _template
+status: draft
+tags:
+  - domain/_template
+  - scenarios
+created: YYYY-MM-DD
+---
+
+# Scenarios
+
+Каноничные сценарии поведения системы в этом домене. Источник истины для тестов и реализации. Обновляется через distillation после каждого change.
+
+## Core scenarios
+
+### [Scenario name]
+```gherkin
+Given [precondition]
+When [action]
+Then [result]
+And [side effect]
+```
+Source: [[PRDCT-XXXX-name]]
+
+## Edge cases
+
+### [Scenario name]
+```gherkin
+Given [unusual precondition]
+When [action]
+Then [handling]
+```
+Source: [[PRDCT-XXXX-name]]
+
+## Error scenarios
+
+### [Scenario name]
+```gherkin
+Given [precondition]
+When [action that fails]
+Then [error handling]
+And [user sees: message]
+```
+Source: [[PRDCT-XXXX-name]]
+
+## Permission scenarios
+
+### [Role] can/cannot [action]
+```gherkin
+Given user has role [role]
+When user attempts [action]
+Then [result]
+```
+Source: [[PRDCT-XXXX-name]]
+
+## Concurrent scenarios
+
+### [Scenario name]
+```gherkin
+Given [two actors]
+When [simultaneous action]
+Then [resolution]
+```
+Source: [[PRDCT-XXXX-name]]

package/template/product-specs/templates/domain/surfaces.md

@@ -0,0 +1,51 @@
+---
+type: surfaces
+domain: _template
+status: draft
+tags:
+  - domain/_template
+  - surfaces
+created: YYYY-MM-DD
+---
+
+# Surfaces · [Domain name]
+
+## Screens
+
+### [Screen name]
+- **Purpose:**
+- **Entry points:** (how user gets here)
+- **Scenario refs:** [[scenario name]]
+
+#### States
+| State | Description | Trigger |
+|-------|------------|---------|
+| loading | | |
+| success | | |
+| error | | |
+| empty | | |
+
+## Flows
+
+### [Flow name]
+- **Actor:**
+- **Scenario ref:** [[scenario name]]
+
+```mermaid
+stateDiagram-v2
+    [*] --> Screen1
+    Screen1 --> Screen2: action
+    Screen2 --> [*]
+```
+
+1. [step] → [screen]
+2. [step] → [screen]
+
+## Permissions per surface
+
+| Surface | Role | Visible | Editable | Notes |
+|---------|------|---------|----------|-------|
+
+## Error messages
+| Context | User message | Recovery action |
+|---------|-------------|----------------|

package/template/product-specs/templates/domain/ubiquitous-language.md

@@ -0,0 +1,12 @@
+---
+type: ubiquitous-language
+domain: DOMAIN_NAME
+tags:
+  - domain/DOMAIN_NAME
+  - language
+---
+
+# Ubiquitous language · [Domain name]
+
+| Term | Definition | Forbidden synonyms | Conflicts with |
+|---|---|---|---|

package/template/product-specs/templates/meta/capability-map.md

@@ -0,0 +1,55 @@
+---
+type: meta
+tags:
+  - meta
+  - map
+---
+
+# Capability Map
+
+## Platform capabilities
+
+```mermaid
+mindmap
+  root((AI Web Studio))
+    Training
+      Session lifecycle
+      Turn management
+      AI facilitation
+    Content
+      Scenario catalog
+      Prompt templates
+      Role definitions
+    Assessment
+      Session scoring
+      Feedback generation
+      Progress tracking
+    Platform
+      Authentication
+      LLM Gateway
+      Analytics
+      Billing
+```
+
+## Capability → Domain mapping
+
+| Capability | Domain | Status |
+|---|---|---|
+| Session lifecycle | training-session | active |
+| Turn management | training-session | active |
+| AI facilitation | training-session | active |
+| Scenario catalog | scenario-catalog | planned |
+| Session scoring | assessment | planned |
+| Feedback generation | assessment | planned |
+| Progress tracking | learner-progress | planned |
+| Authentication | auth (infrastructure) | planned |
+| LLM Gateway | llm-gateway (infrastructure) | planned |
+
+## Domains by status
+
+```dataview
+TABLE status, owner
+FROM "domains"
+WHERE type = "domain"
+GROUP BY status
+```

package/template/product-specs/templates/meta/doc-schema.md

@@ -0,0 +1,134 @@
+# Documentation Schema
+
+## Philosophy
+
+Документация -- конвейер, не архив.
+Каждый переход между ролями -- это документ.
+Нет документа -- нет задачи, физически.
+
+В системе две оси:
+- **Knowledge base** -- стабильное описание системы как она есть
+- **Change packages** -- описание системы как она меняется
+
+## Folder separation rules
+
+```
+/domains      -> ЧТО делает бизнес (язык, правила, события, инварианты, сценарии, surfaces)
+               БЕЗ реализации. БЕЗ имён сервисов.
+
+/contexts     -> КАК устроена платформа по дисциплинам
+               Стабильное архитектурное знание по каждой дисциплине.
+
+/changes      -> ПОЧЕМУ и КАК бизнес решил что-то изменить
+               Только бизнес-документы. Иммутабельно после мержа.
+
+/adrs         -> ПОЧЕМУ принято кросс-доменное архитектурное решение
+               Иммутабельно после принятия.
+```
+
+## Hard rules
+
+1. PR без ссылки на PRDCT-* не мержится
+2. Domain docs обновляются merger'ом после кода, не напрямую
+3. Нет документа -- нет задачи
+4. Change package содержит ТОЛЬКО бизнес-документы (5 файлов)
+5. Техническая архитектура -- ответственность executor'а, не change package
+6. API contracts и data model в domain docs обновляются из кода, не из change docs
+
+## Stage pipeline
+
+```
+Stage 1 · Intent             -> 01-intent.md           (PM)
+Stage 2 · Scenarios          -> 02-scenarios.md         (Scenario Writer)
+Stage 3 · System Analysis    -> 03-analysis.md          (Analyst)
+Stage 4 · Domain framing     -> 04-domain.md           (Domain Framer)
+Stage 5 · UX                 -> 05-ux.md + mockups/     (Designer)
+        · Status -> done
+Post    · Code               -> backend + frontend      (Executor)
+Post    · Domain docs update -> domain files updated    (Merger)
+```
+
+## AI Studio · Roles & Skills
+
+AI-роли реализованы как Claude Code Skills. Каждая роль -- отдельный скилл с уникальной экспертизой и тоном.
+
+### Roles
+
+```
+┌─────────────────┐     ┌────────────────┐     ┌──────────────────┐     ┌────────────────┐     ┌────────────────┐
+│  /pm             │────>│  /scenarios    │────>│  /analyst         │────>│ /domain-framer │────>│  /designer     │
+│  Product Manager │     │  Scenario      │     │  System Analyst   │     │  Domain Framer │     │  UI/UX         │
+│  Intent          │     │  Writer        │     │  Analysis         │     │  Domain Model  │     │  Designer      │
+│  01-intent.md    │     │  02-scenarios  │     │  03-analysis.md   │     │  04-domain.md  │     │  05-ux.md      │
+└─────────────────┘     └────────────────┘     └──────────────────┘     └────────────────┘     └───────┬────────┘
+                                                                                                        │ done
+                         ┌──────────────┐                                                      ┌───────▼────────┐
+                         │  /merger     │<────────────────────────────────────────────────────│  /executor     │
+                         │  Domain      │                                                      │  Full-Stack    │
+                         │  Merger      │                                                      │  Developer     │
+                         └──────────────┘                                                      └────────────────┘
+```
+
+### Skill reference
+
+| Skill | Role | Input | Output | Tone |
+|-------|------|-------|--------|------|
+| `/pm` | Product Manager | Описание фичи | 01-intent.md, metadata.yaml | Дружелюбный, настойчивый |
+| `/scenarios` | Scenario Writer | PRDCT-XXXX | 02-scenarios.md | Перфекционист поведения |
+| `/analyst` | System Analyst | PRDCT-XXXX | 03-analysis.md | Педант + системный мыслитель |
+| `/domain-framer` | Domain Framer | PRDCT-XXXX | 04-domain.md | DDD-эксперт |
+| `/designer` | UI/UX Designer | PRDCT-XXXX | 05-ux.md + mockups/ | UX-перфекционист |
+| `/executor` | Full-Stack Developer | PRDCT-XXXX | Backend + frontend code | Прагматик |
+| `/merger` | Domain Merger | PRDCT-XXXX | Updated domain docs | Педантичный библиотекарь |
+| `/review` | Reviewer | PRDCT-XXXX | Cross-reference report | Жёсткий reviewer |
+| `/verify` | Verifier | PRDCT-XXXX | VERIFICATION.md | Строгий аудитор |
+| `/feature` | Orchestrator | Описание фичи | Полный change package | Меняет роль на каждом этапе |
+| `/bug` | Bug Hunter | Баг / Sentry URL | Root cause + fix | Шерлок Холмс |
+
+### Usage patterns
+
+**Full pipeline (новая фича):**
+```
+/feature добавить систему оценки тренировок
+```
+Или поэтапно:
+```
+/pm добавить систему оценки тренировок
+/analyst PRDCT-0002
+/scenarios PRDCT-0002
+/designer PRDCT-0002
+/review PRDCT-0002
+```
+
+**Bug investigation:**
+```
+/bug https://sentry.io/issues/PROJ-123/
+```
+
+### AI role per stage
+
+```
+Stage 1 · /pm             -> Генерирует intent, задаёт бизнес-вопросы
+Stage 2 · /scenarios      -> Gherkin scenarios: happy, edge, error, permission, concurrent
+Stage 3 · /analyst        -> System analysis: technical constraints, integration points
+Stage 4 · /domain-framer  -> Domain framing: aggregates, rules, events, invariants, UL
+Stage 5 · /designer       -> UX: surfaces, flows, states, mockups, permissions per surface
+Post    · /executor       -> Код: backend + frontend, выводит технику из бизнес-документов
+Post    · /merger         -> Обновляет domain docs из change package
+```
+
+## What lives where
+
+```
+Question                                     -> Location
+----------------------------------------------------------
+Что делает этот домен?                       -> domains/[name]/README.md
+Какие бизнес-правила?                        -> domains/[name]/business-rules.md
+Что не может быть нарушено?                  -> domains/[name]/invariants.md
+Какие события генерирует домен?              -> domains/[name]/events.md
+Какие экраны есть в домене?                  -> domains/[name]/surfaces.md
+Какие сценарии поведения?                    -> domains/[name]/scenarios.md
+Как устроен фронтенд?                        -> contexts/frontend/architecture.md
+Почему принято это архитектурное решение?    -> adrs/ADR-XXX.md
+Что изменилось в этой фиче?                 -> changes/PRDCT-XXXX/
+```

package/template/product-specs/templates/meta/domain-map.md

@@ -0,0 +1,67 @@
+---
+type: meta
+tags:
+  - meta
+  - map
+---
+
+# Domain Map
+
+## Overview
+
+```mermaid
+graph TB
+    subgraph Core
+        TS[Training Session]
+    end
+
+    subgraph Planned
+        SC[Scenario Catalog]
+        AS[Assessment]
+        LP[Learner Progress]
+    end
+
+    subgraph Infrastructure
+        LLM[LLM Gateway]
+        AUTH[Auth / Identity]
+        AN[Analytics]
+    end
+
+    SC -->|provides scenario| TS
+    AUTH -->|validates user| TS
+    TS -->|generates responses| LLM
+    TS -->|SessionFinished| AS
+    TS -->|SessionFinished| LP
+    TS -->|all events| AN
+
+    style TS fill:#4a9eff,color:#fff
+    style SC fill:#ffc107,color:#000
+    style AS fill:#ffc107,color:#000
+    style LP fill:#ffc107,color:#000
+    style LLM fill:#6c757d,color:#fff
+    style AUTH fill:#6c757d,color:#fff
+    style AN fill:#6c757d,color:#fff
+```
+
+> [!info] Legend
+> - Синий: Active (домен задокументирован)
+> - Жёлтый: Planned (упоминается в интеграциях, но не создан)
+> - Серый: Infrastructure (внешние сервисы)
+
+## Active domains
+
+```dataview
+TABLE owner, status, length(file.inlinks) AS "refs"
+FROM "domains"
+WHERE type = "domain"
+SORT domain
+```
+
+## Domain relationships
+
+```dataview
+TABLE domain, file.folder AS "path"
+FROM "domains"
+WHERE type = "integrations"
+SORT domain
+```

package/template/product-specs/templates/meta/glossary.md

@@ -0,0 +1,30 @@
+---
+type: meta
+tags:
+  - meta
+  - glossary
+---
+
+# Glossary
+
+> [!tip] Auto-index
+> Этот глоссарий автоматически собирает термины из всех доменов.
+
+## All terms across domains
+
+```dataview
+TABLE domain AS "Domain"
+FROM "domains"
+WHERE type = "ubiquitous-language"
+SORT domain
+```
+
+## Manual cross-domain terms
+
+| Term | Definition | Domain | Notes |
+|---|---|---|---|
+| PRDCT | Change package — иммутабельный набор документов, описывающий одно изменение | _meta | Формат: PRDCT-XXXX |
+| ADR | Architecture Decision Record — запись архитектурного решения | _meta | Формат: ADR-XXX |
+| Bounded Context | Явная граница, внутри которой модель имеет определённый смысл | _meta | DDD-термин |
+| Aggregate | Кластер доменных объектов, обрабатываемых как единица | _meta | DDD-термин |
+| Invariant | Правило, которое не может быть нарушено ни при каких обстоятельствах | _meta | Строже чем business rule |