@zrg-sh/studio 0.1.0

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

@@ -0,0 +1,108 @@
+---
+type: meta
+status: active
+tags:
+  - meta
+  - onboarding
+created: 2026-04-08
+---
+
+# Onboarding guide
+
+## System overview
+
+**Documentation-first development** --- подход, при котором любое изменение в системе начинается с документа, а не с кода. Документация --- это не артефакт после разработки, а конвейер, через который проходит каждая фича. Нет документа --- нет задачи, физически.
+
+**Domain-Driven Design (DDD) для документации** означает, что бизнес-логика описывается на языке предметной области, а не на языке реализации. Каждый домен имеет свой ubiquitous language, агрегаты, события и инварианты. Это позволяет разработчикам и бизнесу говорить на одном языке.
+
+**Change packages (PRDCT-XXXX)** --- иммутабельные наборы из 5 бизнес-документов, описывающих одно конкретное изменение. Каждый change package проходит через конвейер из 5 стадий. После завершения executor пишет код, а merger обновляет domain docs.
+
+> [!danger] Ключевой принцип
+> **Нет документа --- нет задачи.** PR без ссылки на PRDCT-* не мержится.
+
+## Process 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)"]
+
+    style S01 fill:#e8f5e9,stroke:#2e7d32
+    style S02 fill:#fff3e0,stroke:#e65100
+    style S03 fill:#e3f2fd,stroke:#1565c0
+    style S04 fill:#e8eaf6,stroke:#283593
+    style S05 fill:#fce4ec,stroke:#c62828
+    style S06 fill:#f3e5f5,stroke:#6a1b9a
+    style S07 fill:#e0f2f1,stroke:#00695c
+```
+
+> [!info] Каждая стадия --- это документ
+> На каждой стадии AI-агент создаёт конкретный файл внутри change package. Переход к следующей стадии возможен только после завершения предыдущей.
+
+## Repository structure
+
+```
+docs/
+├── domains/      -> Бизнес-домены (DDD): что делает бизнес
+├── changes/      -> Change packages: как система меняется
+├── adrs/         -> Architecture Decision Records: почему так решили
+├── contexts/     -> Платформенное знание: как устроена платформа
+studio/
+├── agents/       -> AI-роли (PM, Analyst, Designer, Executor, Merger)
+├── rules/        -> Правила для AI-агентов
+├── hooks/        -> Валидация при изменении документов
+└── workflows/    -> Pipeline-ы
+```
+
+> [!info] Разделение знаний
+> - **domains/** содержат ТОЛЬКО бизнес-знание --- никакого UI, никаких имён сервисов
+> - **contexts/** содержат платформенное знание --- стек, архитектуру, инструменты
+> - **changes/** содержат бизнес-описание изменений --- иммутабельны после мержа
+
+## Your first change package
+
+1. **Запусти** `/pm добавить [описание фичи]` --- ответь на вопросы PM-агента
+2. **Получи PRDCT-XXXX** --- агент создаст папку и 01-intent.md
+3. **Запусти** `/scenarios PRDCT-XXXX` --- Gherkin scenarios (02-scenarios.md)
+4. **Запусти** `/analyst PRDCT-XXXX` --- system analysis (03-analysis.md)
+5. **Запусти** `/domain-framer PRDCT-XXXX` --- domain modeling (04-domain.md)
+6. **Запусти** `/designer PRDCT-XXXX` --- UX mockups (05-ux.md + mockups/)
+7. **Запусти** `/review PRDCT-XXXX` --- проверка целостности
+8. Status -> done. Executor пишет код, merger обновляет domain docs.
+
+> [!tip] Быстрый запуск
+> Можно запустить весь pipeline одной командой: `/feature [описание]`
+
+## Key rules
+
+> [!danger] Rule 1: Domain docs --- только бизнес-знание
+> Domain docs содержат ТОЛЬКО бизнес-знание + surfaces. Никаких деталей реализации. API contracts и data model обновляются из кода, не из change docs.
+
+> [!danger] Rule 2: Change packages иммутабельны
+> Change packages иммутабельны после мержа --- никогда не удаляются и не редактируются.
+
+> [!danger] Rule 3: Техника не в change package
+> Change package содержит ТОЛЬКО бизнес-документы (intent, scenarios, analysis, domain, UX). Технические решения принимает executor при написании кода.
+
+> [!danger] Rule 4: PR привязан к PRDCT
+> PR без ссылки на PRDCT-* не мержится. Нет документа --- нет задачи.
+
+## 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/state.md

@@ -0,0 +1,19 @@
+# Studio State
+
+## Status: idle
+## Current PRDCT: none
+## Current Phase: none
+## Current Actor: none
+
+## Performance Metrics
+- Changes completed: 0
+- Domains documented: 0
+
+## Accumulated Context
+- Decisions: none yet
+- Pending TODOs: none
+- Blockers: none
+
+## Session Continuity
+- Last stopped: never
+- Resume point: none

package/template/product-specs/workflows/conflict-resolution.md

@@ -0,0 +1,10 @@
+# Workflow: Conflict Resolution
+
+## Trigger
+Automatic when studio-stage-gate or studio-conflict-detect hook finds domain overlap.
+
+## Process
+1. Identify conflicting PRDCTs and shared domains
+2. Spawn studio-conflict-resolver agent
+3. Present recommendation to user
+4. Update metadata.yaml of both PRDCTs based on decision

package/template/product-specs/workflows/domain-update.md

@@ -0,0 +1,15 @@
+# Workflow: Domain Update
+
+Обновление domain docs после merge change package.
+
+## Trigger
+After PRDCT status → done and PR merged.
+
+## Process
+1. Read 03-domain-impact.md — what should change
+2. For each affected domain:
+   - Read all 8 domain files
+   - Apply changes described in domain-impact
+   - Add wikilinks back to PRDCT
+3. Verify: ubiquitous-language no conflicts, invariants consistent
+4. Commit domain doc updates

package/template/product-specs/workflows/map-codebase.md

@@ -0,0 +1,17 @@
+# Workflow: Map Codebase
+
+Параллельный анализ кодовой базы по зонам.
+
+## Input
+Путь к проекту.
+
+## Process
+1. Bootstrap: mkdir product-specs/docs/_onboard/zones product-specs/docs/_onboard/synthesis
+2. Codebase map: stats, stack, directory structure → 00-codebase-map.md
+3. Zone definition: split into zones → 01-zones.md
+4. Parallel zone analysis: spawn studio-codebase-mapper agent per zone (up to 3 parallel)
+5. Verify all zone files created and non-empty
+6. Track progress in synthesis/progress.md
+
+## Resume
+If product-specs/docs/_onboard/synthesis/progress.md exists → read it, skip completed zones.