code-ai-installer 3.0.0 → 4.0.0

package/domains/development/.agents/skills/architecture-doc-reference/SKILL.md

@@ -0,0 +1,384 @@
+---
+name: architecture-doc-reference
+description: Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока.
+type: reference
+domain: development
+owners:
+  - architect
+gates:
+  - ARCH
+tech: []
+topic:
+  - architecture
+triggers:
+  - пример System Context
+  - mermaid diagram architecture
+  - module template
+  - implementation plan dependency graph
+  - scalability bottlenecks
+  - growth plan example
+  - error handling table
+  - testing strategy template
+related:
+  - architecture-doc
+  - adr-log-reference
+  - api-contracts-reference
+  - data-model
+  - n8n-pinecone-qdrant-supabase
+  - n8n-pinecone-qdrant-supabase-reference
+  - react-15-3-wix-iframe
+  - react-15-3-wix-iframe-reference
+  - wix-self-hosted-embedded-script
+  - wix-self-hosted-embedded-script-reference
+budget_lines: 500
+schema_version: 1
+---
+
+
+# Skill: Architecture Document — Reference
+
+Растущая canonical library шаблонов для 11 канонических секций Architecture Document.
+
+**Разделы:**
+1. [Overview](#1-overview)
+2. [System Context](#2-system-context)
+3. [High-level Architecture Diagram](#3-diagram)
+4. [Modules / Components](#4-modules)
+5. [Flow Mapping](#5-flow)
+6. [Integration Patterns](#6-integration)
+7. [Error Handling Strategy](#7-errors)
+8. [Testing Strategy](#8-testing)
+9. [Scalability Bottlenecks](#9-bottlenecks)
+10. [Growth Plan](#10-growth)
+11. [Implementation Plan](#11-implementation)
+12. [Растущая библиотека](#12-growing-library)
+
+> Inputs / Quality Checklist / Red Flags / Deliverables → `$architecture-doc` (workflow-skill).
+
+---
+
+## 1. Overview
+
+```markdown
+## 1. Overview
+
+### What we're building
+<1 абзац: что строим, какую проблему решаем>
+
+### Constraints
+- Stack: React 18 + Vite (FE), Express 4 (BE), MongoDB 7 (DB)
+- Deployment: Docker Compose + Nginx/Caddy
+- Integration: <External platform if any>
+- Timeline: 2 sprints (4 weeks)
+
+### Assumptions
+- Authentication handled via JWT / external provider
+- Single MongoDB instance sufficient for MVP (< 10K users)
+- Admin panel used by team members only (low concurrency)
+```
+
+---
+
+## 2. System Context
+
+```markdown
+## 2. System Context
+
+### Actors
+| Actor | Type | Interaction |
+|-------|------|-------------|
+| Admin | Human | Dashboard: manages settings, content |
+| End User | Human | Public UI: views content, interacts |
+| External Platform | System | Webhooks, OAuth |
+
+### External Integrations
+| System | Protocol | Purpose |
+|--------|----------|---------|
+| External API | HTTPS | Data sync, webhooks |
+| Auth Provider | OAuth 2.0 / JWT | User authentication |
+
+### System Boundary
+Dashboard + API + Public UI = our system.
+External Platform + End User's Browser = external.
+```
+
+---
+
+## 3. High-level Architecture Diagram
+
+```mermaid
+graph TB
+    subgraph "Public (External)"
+        U[End User]
+        PUI[Public UI]
+    end
+
+    subgraph "Our System"
+        subgraph "Gateway (Nginx/Caddy :443)"
+            GW[HTTPS Termination + Routing]
+        end
+        subgraph "Frontend (:3001)"
+            DASH[Admin Dashboard SPA]
+        end
+        subgraph "Backend (:3000)"
+            API[Express API]
+            WH[Webhook Handler]
+        end
+        DB[(MongoDB :27017)]
+    end
+
+    EXT[External Platform]
+
+    U --> PUI
+    PUI -->|GET /api/v1/content/:id| GW
+    DASH -->|REST| GW
+    GW --> API
+    GW --> DASH
+    API --> DB
+    EXT -->|Webhooks| WH
+```
+
+---
+
+## 4. Modules / Components
+
+Для каждого модуля заполни:
+
+```markdown
+## 4. Modules
+
+### 4.1 API Server (Express)
+
+| Аспект | Описание |
+|--------|---------|
+| **Responsibility** | REST API, webhook handling, auth |
+| **NOT responsible for** | UI rendering, static files serving (reverse proxy does this) |
+| **Public API** | See API Contracts doc |
+| **Dependencies** | MongoDB (via Mongoose), External APIs |
+| **Layers** | Router → Controller → Service → Repository |
+| **Test boundary** | Unit: services (mock repos). Integration: repos + DB |
+
+### 4.2 Admin Dashboard (React SPA)
+
+| Аспект | Описание |
+|--------|---------|
+| **Responsibility** | Settings management, content CRUD, preview |
+| **NOT responsible for** | Direct DB access, external API calls |
+| **Public API** | N/A (user-facing UI) |
+| **Dependencies** | API Server (REST) |
+| **State** | Zustand (settings store, content store) |
+| **Test boundary** | Unit: stores, utils. Integration: component render tests |
+
+### 4.3 Public UI (optional)
+
+| Аспект | Описание |
+|--------|---------|
+| **Responsibility** | Fetch config from API, render public-facing content |
+| **NOT responsible for** | Settings management, data persistence |
+| **Dependencies** | API Server (GET /content/:id) |
+| **Test boundary** | Unit: render logic. E2E: browser test |
+```
+
+---
+
+## 5. Flow Mapping
+
+Маппинг UX flow → technical path:
+
+```markdown
+## 5. Flow Mapping
+
+### Flow: Admin saves settings
+
+| Step | UX | Frontend | API | Service | Repository | DB |
+|------|-----|---------|-----|---------|------------|-----|
+| 1 | Click "Save" | `PUT /api/v1/settings/:id` | `settingsRouter` | `configService.update()` | `configRepo.upsert()` | `settings.updateOne()` |
+| 2 | See "Saved!" toast | Response 200 → toast | — | — | — | — |
+| 3 | Preview updates | Re-fetch config | — | — | — | — |
+
+**States:**
+- Loading: spinner on Save button
+- Error: toast "Failed to save" + retry
+- Success: toast "Settings saved" + preview refresh
+
+### Flow: End user views content
+
+| Step | UX | Public UI | API | DB |
+|------|-----|----------------|-----|-----|
+| 1 | Page loads | Public UI bootstrap | — | — |
+| 2 | — | `GET /api/v1/content/:id` | `contentController` | `settings.findOne()` + `items.findOne()` |
+| 3 | Content appears | `renderContent(config)` | — | — |
+| 4 | Click CTA | Execute action | — | — |
+```
+
+---
+
+## 6. Integration Patterns
+
+```markdown
+## 6. Integration Patterns
+
+| Integration | Pattern | Timeout | Retry | Idempotent |
+|------------|---------|---------|-------|------------|
+| Install Webhook | Async POST → process | 10s | No (platform retries) | Yes (upsert) |
+| External API | Sync POST | 5s | 2x with backoff | Yes |
+| Public Content Fetch | Sync GET | 3s | No (fail gracefully) | N/A (read) |
+| Admin REST | Sync CRUD | 5s | No (user retries) | PUT = idempotent |
+```
+
+---
+
+## 7. Error Handling Strategy
+
+```markdown
+## 7. Error Handling
+
+### Error format (API response)
+\`\`\`json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Invalid product name",
+    "details": [{ "field": "name", "message": "Must be 3-100 chars" }]
+  }
+}
+\`\`\`
+
+### Mapping
+| Domain Error | HTTP | Code | UI Message | Log |
+|-------------|------|------|-----------|-----|
+| Validation | 400 | VALIDATION_ERROR | Field-level errors | warn |
+| Not Found | 404 | NOT_FOUND | "Not found" | info |
+| Duplicate | 409 | DUPLICATE | "Already exists" | warn |
+| Auth | 401 | UNAUTHORIZED | "Please log in" | warn |
+| Forbidden | 403 | FORBIDDEN | "Access denied" | warn |
+| Internal | 500 | INTERNAL_ERROR | "Something went wrong" | error |
+
+### Rule: never expose
+- Stack traces
+- DB error messages
+- Internal paths
+- Secret values
+```
+
+---
+
+## 8. Testing Strategy
+
+```markdown
+## 8. Testing Strategy
+
+| Layer | What | Tool | Mock |
+|-------|------|------|------|
+| Unit | Services, utils, validators | Vitest | Repos, external APIs |
+| Integration | API endpoints, DB queries | Vitest + MongoMemoryServer | External APIs |
+| Component | React components | Vitest + RTL | API calls (msw) |
+| E2E | Critical flows | Browser agent / Playwright | Nothing |
+
+### Must-have scenarios
+- [ ] CRUD settings (happy path + validation errors)
+- [ ] CRUD items (happy path + duplicate)
+- [ ] Public content endpoint returns correct payload
+- [ ] Install webhook creates installation + settings
+- [ ] Public UI renders from API payload
+```
+
+---
+
+## 9. Scalability Bottlenecks
+
+```markdown
+## 9. Scalability Bottlenecks
+
+| Bottleneck | Current | When it hurts | Mitigation |
+|-----------|---------|---------------|------------|
+| No DB indexes | Collection scan | > 1K docs | Add compound indexes |
+| Content fetch on every pageview | API load | > 100 rps | Cache-Control + CDN |
+| Single MongoDB | Write throughput | > 10K writes/s | Replica set |
+| Sync processing in webhook | Webhook timeout | Many installs | Background job |
+| No connection pooling | Connection storms | > 50 concurrent | maxPoolSize config |
+```
+
+---
+
+## 10. Growth Plan
+
+```markdown
+## 10. Growth Plan
+
+| Scale | Architecture | Changes needed |
+|-------|-------------|----------------|
+| **< 1K users** | Current: monolith + single Mongo | None |
+| **1K – 10K** | Add indexes, connection pooling, cache | ARCH-xx |
+| **10K – 100K** | Replica set, CDN for public content, Redis cache | ARCH-xx |
+| **100K – 1M** | Separate API from webhook processing, queue | ARCH-xx |
+| **> 1M** | Microservices, sharding, multi-region | Full redesign |
+```
+
+---
+
+## 11. Implementation Plan
+
+```markdown
+## 11. Implementation Plan
+
+### Phase 1: Foundation (Sprint 1)
+| # | Task | Dependencies | Estimate |
+|---|------|-------------|----------|
+| 1 | DB schemas + migrations | None | 2h |
+| 2 | API: CRUD settings | #1 | 4h |
+| 3 | API: CRUD items | #1 | 4h |
+| 4 | API: Widget endpoint | #1 | 2h |
+| 5 | Webhook handler | #1 | 3h |
+
+### Phase 2: Frontend (Sprint 1-2)
+| # | Task | Dependencies | Estimate |
+|---|------|-------------|----------|
+| 6 | Dashboard: Settings page | #2 | 6h |
+| 7 | Dashboard: Item management | #3 | 4h |
+| 8 | Dashboard: Live Preview | #4, #6 | 4h |
+
+### Phase 3: Integration (Sprint 2)
+| # | Task | Dependencies | Estimate |
+|---|------|-------------|----------|
+| 9 | Public UI | #4 | 6h |
+| 10 | External platform integration | #5, #9 | 3h |
+| 11 | E2E testing | All | 4h |
+
+### Dependency graph
+\`\`\`
+#1 → #2 → #6
+#1 → #3 → #7
+#1 → #4 → #8, #9
+#1 → #5 → #10
+#6 + #4 → #8
+#9 + #5 → #10
+All → #11
+\`\`\`
+```
+
+---
+
+## 12. Растущая библиотека
+
+Этот файл — **canonical library, которая растёт**. Архитектор добавляет шаблоны для новых архитектурных стилей через `update_skill` / `create_skill` MCP-инструменты по мере накопления decision categories:
+
+- Realtime architectures (WebSocket / SSE / SignalR / WebRTC topologies)
+- Edge architectures (Cloudflare Workers / Vercel Edge / Deno Deploy)
+- Microservices migration (monolith → modular monolith → microservices boundaries)
+- Multi-tenancy patterns (shared DB / schema-per-tenant / DB-per-tenant)
+- ML serving architectures (online inference / batch / streaming features)
+- Event sourcing + CQRS boundaries
+- Hexagonal / Clean architecture layouts
+- BFF (Backend-For-Frontend) compositions
+- Async messaging architectures (queue / pub-sub / event bus)
+
+Каждый новый стиль — полный template в стиле §1-§11: Overview / Context / Diagram / Modules / Flow / Integration / Errors / Testing / Bottlenecks / Growth / Implementation.
+
+---
+
+## См. также
+- `$architecture-doc` — inputs / structure overview / quality checklist / red flags (workflow-skill)
+- `$adr-log-reference` — примеры ADR (decisions фиксируются inline в архдоке)
+- `$api-contracts-reference` — шаблоны API контрактов (детали §6 Integration)
+- `$data-model` — детальная data model (entities за §5 Flow Mapping)

package/domains/development/.agents/skills/architecture-doc-reference/agents/claude.json

@@ -0,0 +1,18 @@
+{
+  "name": "architecture-doc-reference",
+  "display_name": "Архитектурная документация",
+  "description": "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока.",
+  "default_prompt": "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\".",
+  "triggers": [
+    "architecture-doc-reference",
+    "architecture doc reference",
+    "Архитектурная документация",
+    "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+  ],
+  "capabilities": [
+    "architecture",
+    "doc"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/architecture-doc-reference/agents/copilot.json

@@ -0,0 +1,18 @@
+{
+  "name": "architecture-doc-reference",
+  "display_name": "Архитектурная документация",
+  "description": "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока.",
+  "default_prompt": "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\".",
+  "triggers": [
+    "architecture-doc-reference",
+    "architecture doc reference",
+    "Архитектурная документация",
+    "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+  ],
+  "capabilities": [
+    "architecture",
+    "doc"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/architecture-doc-reference/agents/gemini.json

@@ -0,0 +1,18 @@
+{
+  "name": "architecture-doc-reference",
+  "display_name": "Архитектурная документация",
+  "description": "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока.",
+  "default_prompt": "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\".",
+  "triggers": [
+    "architecture-doc-reference",
+    "architecture doc reference",
+    "Архитектурная документация",
+    "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+  ],
+  "capabilities": [
+    "architecture",
+    "doc"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/architecture-doc-reference/agents/kimi.yaml

@@ -0,0 +1,14 @@
+name: "architecture-doc-reference"
+display_name: "Архитектурная документация"
+description: "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока."
+default_prompt: "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\"."
+triggers:
+  - "architecture-doc-reference"
+  - "architecture doc reference"
+  - "Архитектурная документация"
+  - "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+capabilities:
+  - "architecture"
+  - "doc"
+tools: []
+implicit_invocation: true

package/domains/development/.agents/skills/architecture-doc-reference/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Архитектурная документация"
+  short_description: "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока."
+  default_prompt: "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/development/.agents/skills/architecture-doc-reference/agents/qwen.json

@@ -0,0 +1,18 @@
+{
+  "name": "architecture-doc-reference",
+  "display_name": "Архитектурная документация",
+  "description": "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока.",
+  "default_prompt": "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\".",
+  "triggers": [
+    "architecture-doc-reference",
+    "architecture doc reference",
+    "Архитектурная документация",
+    "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+  ],
+  "capabilities": [
+    "architecture",
+    "doc"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/architecture-doc-reference/agents/skill.yaml

@@ -0,0 +1,22 @@
+version: 1
+name: "architecture-doc-reference"
+display_name: "Архитектурная документация"
+description: "Канонический справочник шаблонов 11 секций Architecture Document — Overview / System Context / Diagram / Modules / Flow Mapping / Integration Patterns / Error Handling / Testing / Bottlenecks / Growth Plan / Implementation Plan. Активируй при поиске шаблона конкретной секции архдока."
+default_prompt: "Используй $architecture-doc-reference, когда задача относится к навыку \"Справочник шаблонов Architecture Document\"."
+triggers:
+  - "architecture-doc-reference"
+  - "architecture doc reference"
+  - "Архитектурная документация"
+  - "Справочник шаблонов Architecture Document по PRD+UX — модули, потоки, данные, интеграции, ошибки, тестируемость, узкие места, план роста и план реализации"
+capabilities:
+  - "architecture"
+  - "doc"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"

package/domains/development/.agents/skills/board/SKILL.md

@@ -1,8 +1,40 @@
 ---
 name: board
-description: Управление Project Board — создание задач с ID, статусы ☐/⏳/☑/⚠️, обновления после каждого шага, видимый чек-лист в каждом сообщении дирижёра.
+description: "Управление Project Board — создание задач с ID, статусы ☐/⏳/☑/❌/⚠️, обновления после каждого шага, видимый чек-лист в каждом сообщении дирижёра."
+type: mandatory
+domain: development
+owners:
+  - conductor
+gates:
+  - PM
+  - UX
+  - ARCH
+  - DEV
+  - REV
+  - OPS
+  - TEST
+  - RG
+tech: []
+topic:
+  - orchestration
+triggers:
+  - обновить board
+  - статус задач
+  - Project Board
+  - чек-лист задач
+  - ID задачи
+  - доска прогресса
+  - статусы задач
+related:
+  - pm-backlog
+  - handoff
+  - gates
+  - release-gate
+budget_lines: 300
+schema_version: 1
 ---
 
+
 # Skill: Project Board (чек-лист дирижёра)
 
 Прозрачный контроль прогресса.
@@ -16,6 +48,7 @@ description: Управление Project Board — создание задач
 6. [Blocker Escalation](#6-blockers)
 7. [Пример](#7-пример)
 8. [Output Template](#8-output)
+9. [Anti-patterns](#9-anti-patterns)
 
 ---
 
@@ -52,6 +85,7 @@ description: Управление Project Board — создание задач
 | `OPS-xx` | DevOps | OPS-01: Docker setup |
 | `TEST-xx` | Tester | TEST-01: Test plan |
 | `RG-xx` | Release Gate | RG-01: Release checklist |
+| `BUG-xx` | Любая роль (баг) | BUG-01: Fix login regression |
 
 ### Task line format
 
@@ -68,6 +102,19 @@ description: Управление Project Board — создание задач
 | New scope → new task (never modify existing scope) | Traceability |
 | Dependencies explicit | List what blocks and what's blocked |
 
+### Subtask spawning
+
+Если задача оказалась сложной — раскрывай её через иерархические подзадачи (не плодя «mega-tasks»):
+
+```markdown
+- ⏳ (DEV-06) Build Login Flow — Owner: DEV
+  - ☑ (DEV-06.1) Setup JWT middleware
+  - ⏳ (DEV-06.2) Create `/login` endpoint
+  - ☐ (DEV-06.3) Frontend Login form
+```
+
+Подзадача наследует Owner и Gate родителя; статус родителя = `⏳` пока хоть одна подзадача `⏳`/`☐`/`⚠️`, и переходит в `☑` только когда **все** подзадачи `☑`/`❌`.
+
 ---
 
 ## 3. Status Rules
@@ -77,6 +124,7 @@ description: Управление Project Board — создание задач
 | `☐` | Not started | Task created, not yet in progress |
 | `⏳` | In progress | Agent started working on this |
 | `☑` | Done | Artifact delivered + accepted by user |
+| `❌` | Canceled | Won't do — out of scope / obsolete / superseded |
 | `⚠️` | Blocked | Cannot proceed — with explicit reason + owner |
 
 ### Transition rules
@@ -86,6 +134,7 @@ description: Управление Project Board — создание задач
 ⏳ → ☑   Artifact delivered + user approved
 ⏳ → ⚠️  Blocker discovered
 ⚠️ → ⏳  Blocker resolved
+☐/⏳/⚠️ → ❌  Task canceled (record reason)
 ☑ → ☐    Requirement changed → new task (don't revert ☑)
 ```
 
@@ -93,6 +142,7 @@ description: Управление Project Board — создание задач
 
 - `☑ → ⏳` is **forbidden** — if rework needed, create a new task
 - `☑ → ☐` is **forbidden** — done is done
+- `❌ → *` is **forbidden** — canceled is final (если нужно вернуться — new task с deps на canceled)
 
 ---
 
@@ -140,17 +190,17 @@ Add to every board update:
 
 ```markdown
 ## 📊 Progress
-| Gate | Total | Done | In Progress | Blocked |
-|------|:-----:|:----:|:-----------:|:-------:|
-| PM | 2 | 2 | 0 | 0 |
-| UX | 2 | 0 | 1 | 0 |
-| ARCH | 2 | 0 | 0 | 0 |
-| DEV | 2 | 0 | 0 | 0 |
-| REV | 2 | 0 | 0 | 0 |
-| OPS | 1 | 0 | 0 | 0 |
-| TEST | 2 | 0 | 0 | 0 |
-| RG | 1 | 0 | 0 | 0 |
-| **Total** | **14** | **2** | **1** | **0** |
+| Gate | Total | Done | In Progress | Blocked | Canceled |
+|------|:-----:|:----:|:-----------:|:-------:|:--------:|
+| PM | 2 | 2 | 0 | 0 | 0 |
+| UX | 2 | 0 | 1 | 0 | 0 |
+| ARCH | 2 | 0 | 0 | 0 | 0 |
+| DEV | 2 | 0 | 0 | 0 | 0 |
+| REV | 2 | 0 | 0 | 0 | 0 |
+| OPS | 1 | 0 | 0 | 0 | 0 |
+| TEST | 2 | 0 | 0 | 0 | 0 |
+| RG | 1 | 0 | 0 | 0 | 0 |
+| **Total** | **14** | **2** | **1** | **0** | **0** |
 
 **Progress: 2/14 (14%) — On Track / At Risk / Blocked**
 ```
@@ -198,7 +248,11 @@ When `⚠️` appears:
 
 ### DEV Gate
 - [☐] (DEV-01) Settings API (CRUD + validation) — Owner: DEV — Deps: ARCH-02
-- [☐] (DEV-02) Settings Dashboard UI — Owner: DEV — Deps: DEV-01, UX-02
+- [⏳] (DEV-02) Settings Dashboard UI — Owner: DEV — Deps: DEV-01, UX-02
+  - [☑] (DEV-02.1) Базовый layout — Owner: DEV
+  - [⏳] (DEV-02.2) State + API wiring — Owner: DEV
+  - [☐] (DEV-02.3) Loading/empty/error states — Owner: DEV
+- [❌] (DEV-03) Drag-and-drop reorder — Canceled: вынесено в backlog следующей итерации
 
 ### 📊 Progress: 3/8 (38%) — On Track
 ```
@@ -216,15 +270,27 @@ When `⚠️` appears:
 <section 5 format>
 
 ## ⚠️ Blockers
-<section 6 format — or "None">
+<section 6 format — или "None">
 
 ## 🔜 Next Steps
-1. <What happens next>
-2. <Next agent to activate>
+1. <Что происходит дальше>
+2. <Следующий агент к активации>
 ```
 
 ---
 
+## 9. Anti-patterns
+
+| ❌ Anti-pattern | ✅ Solution |
+|----------------|------------|
+| **Forgetting the board** — дирижёр отвечает только текстом, пользователь теряет контекст | ВСЕГДА включать Board в начале сообщения дирижёра |
+| **Tasks without IDs** — «Fix login bug» нельзя реферить | Использовать `(BUG-01) Fix login bug` с ID-префиксом по роли |
+| **Vague statuses** — «Pending», «Sort of done», смешанные символы | Только `☐ / ⏳ / ☑ / ❌ / ⚠️` — никаких других |
+| **Silent updates** — `⏳ → ☑` без объяснения как валидировано | Каждое `☑` сопровождается evidence (artifact / handoff envelope / user approval) |
+| **Mega-tasks** — `☐ (DEV-01) Build the entire app` | Разбить через Subtask spawning (section 2) — max 3 задачи на роль на итерацию |
+
+---
+
 ## См. также
 - `$pm-backlog` — backlog (source of tasks)
 - `$handoff` — gate transitions between agents