code-ai-installer 3.0.0 → 4.0.0

package/domains/development/.agents/skills/adr-log-reference/SKILL.md

@@ -0,0 +1,272 @@
+---
+name: adr-log-reference
+description: Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix.
+type: reference
+domain: development
+owners:
+  - architect
+gates:
+  - ARCH
+tech: []
+topic:
+  - architecture
+triggers:
+  - пример ADR
+  - как оформить ADR для
+  - decision matrix пример
+  - ADR weighted scoring
+  - ADR supersedes пример
+  - образец ADR
+  - ADR template пример
+related:
+  - adr-log
+  - architecture-doc
+  - architecture-doc-reference
+  - design-patterns-reference
+  - current-state-analysis
+budget_lines: 500
+schema_version: 1
+---
+
+
+# Skill: ADR Log — Reference
+
+Растущая canonical library примеров ADR: полные образцы решений, decision matrix с weighted scoring, расширенный index, supersedes-цепочки.
+
+**Разделы:**
+1. [Полные примеры ADR](#1-примеры)
+2. [Decision Matrix](#2-decision-matrix)
+3. [ADR Index](#3-adr-index)
+4. [Растущая библиотека](#4-growing-library)
+
+> Формат, lifecycle, anti-patterns → `$adr-log` (workflow-skill).
+
+---
+
+## 1. Полные примеры ADR
+
+### ADR-001: Use MongoDB as primary database
+
+```markdown
+# ADR-001: Use MongoDB as primary database
+
+## Status
+Accepted
+
+## Date
+2025-06-15
+
+## Context
+The application needs persistent storage for tenants, settings,
+and products. Requirements:
+- Flexible schema (settings structure varies per configuration)
+- Low operational overhead (small team)
+- Good Node.js ecosystem support
+- No complex joins needed (data is per-tenant)
+
+## Decision
+Use MongoDB 7 with Mongoose ODM.
+- Single database, collections: tenants, settings, products
+- Hosted via Docker (dev) / MongoDB Atlas (production)
+
+## Consequences
+
+### Positive
+- Flexible schema fits varying template settings
+- Excellent Mongoose ecosystem (validators, middleware, lean queries)
+- Easy Docker setup for local development
+- Native JSON — minimal serialization overhead
+
+### Negative
+- No ACID transactions across collections (need replica set)
+- No joins — must denormalize or do application-level joins
+- Schema discipline required (strict mode + Zod validation)
+
+### Risks
+- Schema drift without validation → mitigated by strict: 'throw'
+- 16MB document limit → mitigated by reference strategy for unbounded arrays
+
+## Alternatives Considered
+
+### Option A: PostgreSQL
+- ✅ ACID, complex queries, strong typing
+- ❌ Schema migrations more complex for flexible settings
+- ❌ JSON column less ergonomic than native MongoDB documents
+- 💡 Overkill for current use case (no joins, no complex queries)
+
+### Option B: SQLite
+- ✅ Zero infrastructure, file-based
+- ❌ No concurrent writes in Docker
+- ❌ No production scaling path
+- 💡 Too limiting for multi-service architecture
+
+## References
+- PRD: Data requirements section
+- Related: ADR-002 (Mongoose strict mode)
+```
+
+---
+
+### ADR-018: Use Wix ImageViewer for dashboard images
+
+```markdown
+# ADR-018: Use Wix ImageViewer for dashboard images
+
+## Status
+Accepted
+
+## Date
+2025-12-20
+
+## Context
+Dashboard needs to display template preview images.
+The app runs inside Wix iframe where standard <img> tags may have
+CORS issues with Wix media URLs (wixstatic.com).
+
+## Decision
+Use WDS (Wix Design System) ImageViewer component for all
+dashboard images instead of native <img> tags.
+
+## Consequences
+
+### Positive
+- Handles Wix media URLs natively (no CORS issues)
+- Consistent with Wix design system (visual parity)
+- Built-in loading states and error handling
+
+### Negative
+- Dependency on WDS component library
+- Different API than standard <img> (onLoad, src format)
+
+## Alternatives Considered
+
+### Option A: Native <img> with proxy
+- ✅ Simple, no dependency
+- ❌ CORS errors with wixstatic.com
+- ❌ Need custom proxy endpoint
+- 💡 Unnecessary complexity
+
+## References
+- Bug: Dashboard images not loading (blank src)
+- Wix Design System docs: ImageViewer component
+```
+
+---
+
+### ADR-019: CSS overflow containment for popup templates
+
+```markdown
+# ADR-019: CSS overflow containment for popup
+
+## Status
+Accepted
+
+## Date
+2025-12-20
+
+## Context
+Popup templates render inside Wix embedded script.
+CSS overflow from popup elements leaks outside the container,
+causing scrollbars on the Wix page.
+
+## Decision
+Apply containment strategy:
+1. `overflow: hidden` on popup container
+2. `contain: layout style` on root widget element
+3. `box-sizing: border-box` on all popup children
+
+## Consequences
+
+### Positive
+- No visual leaking outside container
+- No unexpected scrollbars on host page
+- Each template isolated
+
+### Negative
+- Must test each template for clipping issues
+- Shadow effects near edges may be cut off
+
+## Alternatives Considered
+
+### Option A: Shadow DOM
+- ✅ Complete style isolation
+- ❌ Complex to implement for dynamic templates
+- ❌ Limited shadow DOM support for legacy browsers
+- 💡 Overkill for current 3-template scope
+
+## References
+- Bug: Scrollbar appearing on Wix site when popup opens
+- Related: ADR-018 (ImageViewer)
+```
+
+---
+
+## 2. Decision Matrix
+
+Для сложных решений с 3+ альтернативами используй weighted matrix:
+
+```markdown
+## Decision Matrix: State Management
+
+### Criteria (weighted)
+| Criteria | Weight | Description |
+|----------|--------|-------------|
+| Simplicity | 3 | Learning curve, boilerplate |
+| Performance | 2 | Re-render efficiency |
+| DevTools | 1 | Debugging experience |
+| Ecosystem | 1 | Community, plugins |
+| Bundle size | 2 | KB added |
+
+### Scoring (1-5, higher = better)
+
+| Option | Simplicity (×3) | Performance (×2) | DevTools (×1) | Ecosystem (×1) | Bundle (×2) | **Total** |
+|--------|:---:|:---:|:---:|:---:|:---:|:---:|
+| **Zustand** | 5 (15) | 4 (8) | 4 (4) | 3 (3) | 5 (10) | **40** |
+| Redux Toolkit | 3 (9) | 4 (8) | 5 (5) | 5 (5) | 3 (6) | **33** |
+| Context + useReducer | 4 (12) | 2 (4) | 3 (3) | 5 (5) | 5 (10) | **34** |
+| Jotai | 4 (12) | 5 (10) | 3 (3) | 2 (2) | 5 (10) | **37** |
+
+### Decision
+Zustand wins (40 points). Best simplicity + performance + bundle size.
+```
+
+---
+
+## 3. ADR Index
+
+Полный пример индекса с разными статусами и supersedes-связями:
+
+```markdown
+# Architecture Decision Records
+
+| # | Title | Status | Date |
+|---|-------|--------|------|
+| ADR-001 | Use MongoDB as primary database | Accepted | 2025-06-15 |
+| ADR-008 | Use CSS Modules for styling | Superseded by ADR-025 | 2025-07-01 |
+| ADR-018 | Use WDS ImageViewer | Accepted | 2025-12-20 |
+| ADR-019 | CSS overflow containment | Accepted | 2025-12-20 |
+| ADR-025 | Migrate to Tailwind | Accepted | 2026-01-15 |
+```
+
+---
+
+## 4. Растущая библиотека
+
+Этот файл — **canonical library, которая растёт**. Архитектор добавляет новые примеры ADR через `update_skill` / `create_skill` MCP-инструменты по мере накопления новых decision categories:
+
+- Realtime (WebSocket vs SSE vs Long-poll)
+- Edge (Cloudflare Workers vs Vercel Edge vs Deno Deploy)
+- Observability stacks (OpenTelemetry vs vendor SDKs)
+- AI infra (LLM provider, vector DB, prompt management)
+- Event sourcing / CQRS boundary decisions
+- Multi-tenancy isolation strategies
+
+Каждый новый пример — полный ADR в стиле §1: Status / Date / Context / Decision / Consequences (Positive/Negative/Risks) / Alternatives / References.
+
+---
+
+## См. также
+- `$adr-log` — формат, naming, lifecycle, anti-patterns (workflow-skill)
+- `$architecture-doc` — Architecture Document (где ADR встречаются inline)
+- `$design-patterns-reference` — каталог паттернов (часто фиксируется в ADR)
+- `$current-state-analysis` — аудит перед новыми ADR

package/domains/development/.agents/skills/adr-log-reference/agents/claude.json

@@ -0,0 +1,19 @@
+{
+  "name": "adr-log-reference",
+  "display_name": "Справочник примеров ADR",
+  "description": "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix.",
+  "default_prompt": "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\".",
+  "triggers": [
+    "adr-log-reference",
+    "adr log reference",
+    "Справочник примеров ADR",
+    "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+  ],
+  "capabilities": [
+    "adr",
+    "reference",
+    "examples"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/adr-log-reference/agents/copilot.json

@@ -0,0 +1,19 @@
+{
+  "name": "adr-log-reference",
+  "display_name": "Справочник примеров ADR",
+  "description": "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix.",
+  "default_prompt": "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\".",
+  "triggers": [
+    "adr-log-reference",
+    "adr log reference",
+    "Справочник примеров ADR",
+    "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+  ],
+  "capabilities": [
+    "adr",
+    "reference",
+    "examples"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/adr-log-reference/agents/gemini.json

@@ -0,0 +1,19 @@
+{
+  "name": "adr-log-reference",
+  "display_name": "Справочник примеров ADR",
+  "description": "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix.",
+  "default_prompt": "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\".",
+  "triggers": [
+    "adr-log-reference",
+    "adr log reference",
+    "Справочник примеров ADR",
+    "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+  ],
+  "capabilities": [
+    "adr",
+    "reference",
+    "examples"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/adr-log-reference/agents/kimi.yaml

@@ -0,0 +1,15 @@
+name: "adr-log-reference"
+display_name: "Справочник примеров ADR"
+description: "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix."
+default_prompt: "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\"."
+triggers:
+  - "adr-log-reference"
+  - "adr log reference"
+  - "Справочник примеров ADR"
+  - "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+capabilities:
+  - "adr"
+  - "reference"
+  - "examples"
+tools: []
+implicit_invocation: true

package/domains/development/.agents/skills/adr-log-reference/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Справочник примеров ADR"
+  short_description: "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix."
+  default_prompt: "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/development/.agents/skills/adr-log-reference/agents/qwen.json

@@ -0,0 +1,19 @@
+{
+  "name": "adr-log-reference",
+  "display_name": "Справочник примеров ADR",
+  "description": "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix.",
+  "default_prompt": "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\".",
+  "triggers": [
+    "adr-log-reference",
+    "adr log reference",
+    "Справочник примеров ADR",
+    "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+  ],
+  "capabilities": [
+    "adr",
+    "reference",
+    "examples"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/adr-log-reference/agents/skill.yaml

@@ -0,0 +1,23 @@
+version: 1
+name: "adr-log-reference"
+display_name: "Справочник примеров ADR"
+description: "Канонический справочник примеров ADR — 3 полных образца (database / iframe / CSS containment), weighted decision matrix, расширенный ADR Index. Активируй при поиске формата конкретного типа ADR или примера decision matrix."
+default_prompt: "Используй $adr-log-reference, когда задача относится к навыку \"Справочник примеров ADR\"."
+triggers:
+  - "adr-log-reference"
+  - "adr log reference"
+  - "Справочник примеров ADR"
+  - "Канонический справочник примеров ADR — 3 образца, decision matrix, ADR Index"
+capabilities:
+  - "adr"
+  - "reference"
+  - "examples"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"

package/domains/development/.agents/skills/api-contract-compliance-review/SKILL.md

@@ -1,8 +1,34 @@
 ---
 name: api-contract-compliance-review
-description: Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация.
+description: "Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация."
+type: triggered
+domain: development
+owners:
+  - reviewer
+gates:
+  - REV
+tech: []
+topic:
+  - review
+  - security
+triggers:
+  - ревью API
+  - соответствие контракту
+  - схема ответа
+  - коды ошибок API
+  - проверь эндпоинт
+  - валидация запроса
+  - идемпотентность endpoint
+related:
+  - api-contracts
+  - code-review-checklist
+  - security-review
+  - review-reference-snippets
+budget_lines: 300
+schema_version: 1
 ---
 
+
 # Skill: API Contract Compliance Review
 
 Ревью: реализация API соответствует заявленным контрактам.
@@ -96,7 +122,7 @@ description: Проверка соответствия реализации API
 
 ---
 
-## 3. Verification Methods
+## 3. Verification Methods <a id="3-methods"></a>
 
 ### Endpoint comparison table
 
@@ -155,7 +181,7 @@ grep_search: Query="auth" Includes=["*/routes/*"]
 
 ---
 
-## 4. Common Mismatches
+## 4. Common Mismatches <a id="4-mismatches"></a>
 
 | Mismatch | Example | Severity | Fix |
 |----------|---------|----------|-----|
@@ -171,7 +197,7 @@ grep_search: Query="auth" Includes=["*/routes/*"]
 
 ---
 
-## 5. Output Template
+## 5. Output Template <a id="5-output"></a>
 
 ```markdown
 # API Contract Compliance Review
@@ -214,9 +240,6 @@ grep_search: Query="auth" Includes=["*/routes/*"]
 - ⚠️ DEVIATIONS — minor mismatches to fix
 - ❌ NON-COMPLIANT — critical contract violations
 ```
-
----
-
 ## См. также
 - `$api-contracts` — API contract definitions (source of truth)
 - `$code-review-checklist` — general review (API section)

package/domains/development/.agents/skills/api-contract-compliance-review/agents/kimi.yaml

@@ -1,16 +1,16 @@
-name: "api-contract-compliance-review"
-display_name: "Проверка соответствия API-контрактам"
-description: "Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация."
-default_prompt: "Используй $api-contract-compliance-review, когда задача относится к навыку \"Проверка соответствия API-контрактам\"."
-triggers:
-  - "api-contract-compliance-review"
-  - "api contract compliance review"
-  - "Проверка соответствия API-контрактам"
-  - "Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация"
-capabilities:
-  - "api"
-  - "contract"
-  - "compliance"
-  - "review"
-tools: []
-implicit_invocation: true
+name: "api-contract-compliance-review"
+display_name: "Проверка соответствия API-контрактам"
+description: "Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация."
+default_prompt: "Используй $api-contract-compliance-review, когда задача относится к навыку \"Проверка соответствия API-контрактам\"."
+triggers:
+  - "api-contract-compliance-review"
+  - "api contract compliance review"
+  - "Проверка соответствия API-контрактам"
+  - "Проверка соответствия реализации API контрактам — схемы, коды ошибок, валидация, авторизация, идемпотентность, пагинация"
+capabilities:
+  - "api"
+  - "contract"
+  - "compliance"
+  - "review"
+tools: []
+implicit_invocation: true