code-ai-installer 2.5.0 → 4.0.0

package/domains/development/.agents/skills/design-patterns-architectural-reference/SKILL.md

@@ -0,0 +1,332 @@
+---
+name: design-patterns-architectural-reference
+description: Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня.
+type: reference
+domain: development
+owners:
+  - architect
+gates:
+  - ARCH
+tech: []
+topic:
+  - architecture
+triggers:
+  - архитектурный паттерн
+  - microservice паттерн
+  - Repository паттерн
+  - Service Layer
+  - Dependency Injection
+  - Event-Driven
+  - CQRS
+  - Saga
+  - Circuit Breaker
+  - Mediator
+related:
+  - design-patterns-reference
+  - design-patterns-solid-reference
+  - design-patterns-gof-reference
+  - adr-log
+  - architecture-doc
+  - api-contracts
+budget_lines: 500
+schema_version: 1
+---
+
+
+# Skill: Design Patterns — Architectural + Microservices Reference
+
+Растущая canonical library архитектурных и microservice паттернов с DO/DON'T pseudocode. Service / component-scale.
+
+**Разделы:**
+1. [Repository](#1-repository)
+2. [Service Layer](#2-service-layer)
+3. [Dependency Injection (DI)](#3-di)
+4. [Event-Driven](#4-event-driven)
+5. [CQRS](#5-cqrs)
+6. [Saga](#6-saga)
+7. [Circuit Breaker](#7-circuit-breaker)
+8. [Mediator](#8-mediator)
+9. [Растущая библиотека](#9-growing-library)
+
+> Selection rule + taxonomy → `$design-patterns-reference` (meta-index).
+> SOLID + cross-cutting principles → `$design-patterns-solid-reference`.
+> GoF паттерны → `$design-patterns-gof-reference`.
+
+---
+
+## 1. Repository — изоляция доступа к данным
+```
+// ✅ DO: репозиторий инкапсулирует работу с хранилищем
+interface UserRepository
+  findById(id) → User | null
+  findByEmail(email) → User | null
+  save(user) → User
+  delete(id) → void
+
+class PostgresUserRepository implements UserRepository
+  findById(id) → db.query("SELECT ... WHERE id = $1", [id])
+
+class MongoUserRepository implements UserRepository
+  findById(id) → collection.findOne({ _id: id })
+
+// Бизнес-логика не знает про SQL/Mongo
+class UserService
+  constructor(repo: UserRepository)
+  getUser(id) → this.repo.findById(id)
+```
+
+```
+// ❌ DON'T: SQL в бизнес-логике
+class UserService
+  getUser(id)
+    result = db.query("SELECT * FROM users WHERE id = $1", [id])
+    // Привязан к PostgreSQL, нельзя тестировать без БД
+```
+
+**Когда:** изоляция бизнес-логики от деталей хранилища; возможность подмены БД; тестируемость.
+
+---
+
+## 2. Service Layer — бизнес-логика не в контроллерах
+```
+// ✅ DO: контроллер → сервис → репозиторий
+class OrderController
+  constructor(orderService)
+  handleCreateOrder(req)
+    order = this.orderService.create(req.body)
+    return Response(201, order)
+
+class OrderService
+  constructor(orderRepo, paymentGateway, inventory)
+  create(data)
+    this.inventory.reserve(data.items)
+    order = Order.create(data)
+    this.paymentGateway.charge(order.total)
+    this.orderRepo.save(order)
+    return order
+
+// ❌ DON'T: бизнес-логика в контроллере
+class OrderController
+  handleCreateOrder(req)
+    db.query("INSERT INTO orders ...")    // SQL в контроллере
+    stripe.charge(...)                     // платёж в контроллере
+    sendEmail(...)                         // и email тоже
+```
+
+**Когда:** REST API с не-тривиальной бизнес-логикой; контроллер должен только маппить HTTP в domain.
+
+---
+
+## 3. Dependency Injection (DI)
+```
+// ✅ DO: зависимости передаются извне
+class Application
+  start()
+    db = new PostgresConnection(config.db)
+    userRepo = new PostgresUserRepository(db)
+    emailService = new SmtpEmailService(config.smtp)
+    userService = new UserService(userRepo, emailService)
+    controller = new UserController(userService)
+    server.register(controller)
+
+// Каждый компонент принимает зависимости через конструктор
+// Легко тестировать: подставляем mock-репозиторий
+```
+
+```
+// ❌ DON'T: компоненты сами создают зависимости
+class UserService
+  repo = new PostgresUserRepository(new PostgresConnection("hardcoded"))
+  email = new SmtpEmailService("smtp://hardcoded")
+  // Нельзя протестировать без реальных PostgreSQL и SMTP
+```
+
+**Когда:** слабая связь между компонентами; тестируемость; возможность подмены реализаций.
+
+---
+
+## 4. Event-Driven — реакция на события
+```
+// ✅ DO: слабая связанность через события
+// Сервис создаёт заказ и публикует событие
+class OrderService
+  createOrder(data)
+    order = Order.create(data)
+    orderRepo.save(order)
+    eventBus.publish("order.created", { orderId: order.id })
+
+// Независимые обработчики подписаны на событие
+class InventoryHandler
+  on("order.created") → reserveItems(event.orderId)
+
+class NotificationHandler
+  on("order.created") → sendConfirmation(event.orderId)
+
+class AnalyticsHandler
+  on("order.created") → trackConversion(event.orderId)
+
+// Добавляем новый обработчик → ни одна строка в OrderService не меняется
+```
+
+```
+// ❌ DON'T: OrderService знает обо всех зависимых компонентах
+class OrderService
+  createOrder(data)
+    order = Order.create(data)
+    orderRepo.save(order)
+    inventoryService.reserve(order)      // жёсткая связь
+    notificationService.send(order)       // жёсткая связь
+    analyticsService.track(order)         // жёсткая связь
+```
+
+**Когда:** реакция на бизнес-события без жёсткой связи; добавление новых обработчиков не должно ломать producer.
+
+---
+
+## 5. CQRS — Command Query Responsibility Segregation
+```
+// ✅ DO: разные модели для записи и чтения
+// Command side — нормализованная модель; бизнес-правила
+class CreateOrderCommand
+  execute(data)
+    order = Order.create(data)
+    orderRepo.save(order)
+    eventBus.publish("order.created", order)
+
+// Query side — денормализованная модель; оптимизирована под чтение
+class OrderQueryService
+  getOrderSummary(id) →
+    readDb.query("SELECT ... FROM order_summaries WHERE id = $1", [id])
+
+  getOrdersByUser(userId, page) →
+    readDb.query("SELECT ... FROM user_orders_view WHERE user_id = $1 LIMIT ...", [userId])
+
+// Записи обновляют read-модель через events
+on("order.created") → updateOrderSummaryView(event)
+```
+
+**Когда:** паттерны чтения и записи сильно различаются; высокая нагрузка на чтение; нужна денормализация для быстрых запросов.
+
+---
+
+## 6. Saga — распределённые транзакции через компенсации
+```
+// ✅ DO: каждый шаг имеет компенсацию (откат)
+class OrderSaga
+  steps = [
+    { action: reserveInventory,    compensate: releaseInventory },
+    { action: chargePayment,       compensate: refundPayment },
+    { action: createShipment,      compensate: cancelShipment },
+    { action: sendConfirmation,    compensate: sendCancellation },
+  ]
+
+  execute(orderData)
+    completed = []
+    for step in steps
+      try
+        step.action(orderData)
+        completed.push(step)
+      catch error
+        // Откатываем все выполненные шаги в обратном порядке
+        for s in completed.reverse()
+          s.compensate(orderData)
+        throw SagaFailedError(error)
+```
+
+**Когда:** транзакция охватывает несколько сервисов; нельзя использовать распределённый 2PC.
+
+---
+
+## 7. Circuit Breaker — защита от каскадных сбоев
+```
+// ✅ DO: Circuit Breaker перед вызовом внешнего сервиса
+class CircuitBreaker
+  state = CLOSED        // нормальная работа
+  failureCount = 0
+  threshold = 5
+  resetTimeout = 30s
+
+  call(fn)
+    if state == OPEN
+      if elapsed > resetTimeout → state = HALF_OPEN
+      else → throw ServiceUnavailableError   // не шлём запрос
+
+    try
+      result = fn()
+      if state == HALF_OPEN → state = CLOSED; failureCount = 0
+      return result
+    catch error
+      failureCount++
+      if failureCount >= threshold → state = OPEN; startTimer()
+      throw error
+
+// Использование
+breaker = new CircuitBreaker()
+userData = breaker.call(() => externalUserApi.getUser(id))
+```
+
+**Когда:** зависимость от внешнего сервиса, который может упасть; предотвращение каскадного отказа.
+
+---
+
+## 8. Mediator — центральный координатор взаимодействий
+```
+// ✅ DO: компоненты общаются через медиатор, не напрямую
+class OrderMediator
+  handlers = Map<string, Handler>
+
+  register(commandType, handler)
+  send(command)
+    handler = this.handlers.get(command.type)
+    return handler.handle(command)
+
+// Регистрация
+mediator.register("CreateOrder", new CreateOrderHandler(orderRepo, inventory))
+mediator.register("CancelOrder", new CancelOrderHandler(orderRepo, payment))
+
+// Вызов — контроллер не знает про конкретные обработчики
+class OrderController
+  handleCreate(req) → mediator.send(new CreateOrderCommand(req.body))
+  handleCancel(req) → mediator.send(new CancelOrderCommand(req.params.id))
+```
+
+**Когда:** много взаимодействующих компонентов; нужно централизовать координацию и убрать прямые зависимости.
+
+---
+
+## 9. Растущая библиотека
+
+Этот файл — **canonical library, которая растёт**. Архитектор добавляет новые архитектурные и microservice паттерны через `update_skill` / `create_skill`:
+
+**Architectural:**
+- Hexagonal Architecture (Ports & Adapters)
+- Onion Architecture
+- Clean Architecture
+- Layered Architecture variants
+- Domain-Driven Design (DDD) building blocks
+- Event Sourcing pattern
+- Specification pattern
+- Unit of Work pattern
+
+**Microservices:**
+- API Gateway pattern
+- Service Mesh (Istio / Linkerd)
+- Bulkhead (resource isolation)
+- Strangler Fig (legacy migration)
+- Sidecar pattern
+- Saga Orchestrator vs Choreography
+- Outbox pattern
+- Backend-For-Frontend (BFF)
+- Service Registry / Discovery
+
+Каждый новый паттерн — DO/DON'T pseudocode + "когда применять" + связь с существующими.
+
+---
+
+## См. также
+- `$design-patterns-reference` — meta-index с selection rule
+- `$design-patterns-solid-reference` — SOLID + cross-cutting principles
+- `$design-patterns-gof-reference` — GoF class-scale паттерны
+- `$adr-log` — фиксация выбранного паттерна в ADR
+- `$architecture-doc` — Architecture Document
+- `$api-contracts` — API design (Service Layer часто проявляется на API уровне)

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/claude.json

@@ -0,0 +1,19 @@
+{
+  "name": "design-patterns-architectural-reference",
+  "display_name": "Design Patterns Reference",
+  "description": "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня.",
+  "default_prompt": "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\".",
+  "triggers": [
+    "design-patterns-architectural-reference",
+    "design patterns architectural reference",
+    "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+  ],
+  "capabilities": [
+    "design",
+    "architectural",
+    "microservices",
+    "reference"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/copilot.json

@@ -0,0 +1,19 @@
+{
+  "name": "design-patterns-architectural-reference",
+  "display_name": "Design Patterns Reference",
+  "description": "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня.",
+  "default_prompt": "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\".",
+  "triggers": [
+    "design-patterns-architectural-reference",
+    "design patterns architectural reference",
+    "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+  ],
+  "capabilities": [
+    "design",
+    "architectural",
+    "microservices",
+    "reference"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/gemini.json

@@ -0,0 +1,19 @@
+{
+  "name": "design-patterns-architectural-reference",
+  "display_name": "Design Patterns Reference",
+  "description": "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня.",
+  "default_prompt": "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\".",
+  "triggers": [
+    "design-patterns-architectural-reference",
+    "design patterns architectural reference",
+    "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+  ],
+  "capabilities": [
+    "design",
+    "architectural",
+    "microservices",
+    "reference"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/kimi.yaml

@@ -0,0 +1,15 @@
+name: "design-patterns-architectural-reference"
+display_name: "Design Patterns Reference"
+description: "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня."
+default_prompt: "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\"."
+triggers:
+  - "design-patterns-architectural-reference"
+  - "design patterns architectural reference"
+  - "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+capabilities:
+  - "design"
+  - "architectural"
+  - "microservices"
+  - "reference"
+tools: []
+implicit_invocation: true

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Design Patterns Reference"
+  short_description: "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня."
+  default_prompt: "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/qwen.json

@@ -0,0 +1,19 @@
+{
+  "name": "design-patterns-architectural-reference",
+  "display_name": "Design Patterns Reference",
+  "description": "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня.",
+  "default_prompt": "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\".",
+  "triggers": [
+    "design-patterns-architectural-reference",
+    "design patterns architectural reference",
+    "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+  ],
+  "capabilities": [
+    "design",
+    "architectural",
+    "microservices",
+    "reference"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/.agents/skills/design-patterns-architectural-reference/agents/skill.yaml

@@ -0,0 +1,23 @@
+version: 1
+name: "design-patterns-architectural-reference"
+display_name: "Design Patterns Reference"
+description: "Канонический справочник архитектурных и microservice паттернов — Repository / Service Layer / Dependency Injection / Event-Driven / CQRS / Saga / Circuit Breaker / Mediator. DO/DON'T pseudocode, «когда применять» notes. Активируй при выборе паттерна сервис/компонент-уровня."
+default_prompt: "Используй $design-patterns-architectural-reference, когда задача относится к навыку \"Справочник архитектурных + microservice паттернов\"."
+triggers:
+  - "design-patterns-architectural-reference"
+  - "design patterns architectural reference"
+  - "Справочник архитектурных + microservice паттернов с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker)"
+capabilities:
+  - "design"
+  - "architectural"
+  - "microservices"
+  - "reference"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"