code-ai-installer 1.4.0 → 1.5.1

package/.agents/skills/design_patterns_reference/agents/gemini.json

@@ -0,0 +1,19 @@
+{
+  "name": "design_patterns_reference",
+  "display_name": "Справочник паттернов проектирования",
+  "description": "Справочник паттернов проектирования с 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). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить».",
+  "default_prompt": "Используй $design_patterns_reference, когда задача относится к навыку \"Справочник паттернов проектирования\".",
+  "triggers": [
+    "design_patterns_reference",
+    "design patterns reference",
+    "Справочник паттернов проектирования",
+    "Справочник паттернов проектирования с 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). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
+  ],
+  "capabilities": [
+    "architecture",
+    "design",
+    "patterns"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/.agents/skills/design_patterns_reference/agents/skill.yaml

@@ -0,0 +1,23 @@
+version: 1
+name: "design_patterns_reference"
+display_name: "Справочник паттернов проектирования"
+description: "Справочник паттернов проектирования с 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). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
+default_prompt: "Используй $design_patterns_reference, когда задача относится к навыку \"Справочник паттернов проектирования\"."
+triggers:
+  - "design_patterns_reference"
+  - "design patterns reference"
+  - "Справочник паттернов проектирования"
+  - "Справочник паттернов проектирования с 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). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
+capabilities:
+  - "architecture"
+  - "design"
+  - "patterns"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"

package/.agents/skills/tanstack_beast_practices/SKILL.md

@@ -7,6 +7,9 @@ description: TanStack (Query v5, Table v8, Virtual v3): кэширование,
 
 Копипаст-паттерны для предсказуемой работы с данными, таблицами и виртуализацией.
 
+> [!IMPORTANT]
+> **MCP-приоритет:** Если доступен MCP-сервер `tanstack-docs`, **всегда используй его инструменты** (`tanstack_doc`, `tanstack_search_docs`, `listTanStackAddOns`, `getAddOnDetails`, `createTanStackApplication`) **первыми** — они дают актуальную документацию прямо из официальных источников TanStack. Используй паттерны этого скилла как fallback или как дополнительный контекст по архитектуре (fetcher/adapter/hook, queryKey factory, оптимистичные обновления, виртуализация), когда MCP недоступен или не содержит нужной информации.
+
 **Разделы:**
 1. [Query: архитектура fetcher/adapter](#1-query-архитектура)
 2. [Query: кэширование и staleTime](#2-query-кэш)

package/AGENTS.md

@@ -1,134 +1,136 @@
-<!-- code-ai: target=gpt-codex; asset=orchestrator; normalized_hints=none -->
-<!-- codex: reasoning=medium; note="auto-adapted default" -->
-# AGENTS.md — Оркестр веб-разработки
-
-## Источник правды по ролям
-Роли описаны в:
-- agents/conductor.md
-- agents/product_manager.md
-- agents/ux_ui_designer.md
-- agents/architect.md
-- agents/devops.md
-- agents/senior_full_stack.md
-- agents/reviewer.md
-- agents/tester.md
-
-При работе следуй этим ролям. Если нужно — открывай соответствующий файл роли и применяй.
-
----
-
-## Skills (явно вызывай)
-Используй skills (папки с `SKILL.md`). Полный список:
-
-### Core / Orchestration
-- $board
-- $handoff
-- $memory
-- $gates
-- $release_gate
-- $release_gate_checklist_template
-
-### Product Management
-- $pm_interview
-- $pm_prd
-- $pm_backlog
-
-### UX/UI / Design
-- $ux_discovery
-- $ux_spec
-- $ui_inventory
-- $a11y_baseline
-- $design_intake
-- $design_parity_review
-- $design_systems
-- $ui_a11y_smoke_review
-- $google_stitch_skill
-
-### Architecture
-- $current_state_analysis
-- $system_design_checklist
-- $architecture_doc
-- $architecture_compliance_review
-- $adr_log
-- $api_contracts
-- $data_model
-- $threat_model_baseline
-- $observability_plan
-- $deployment_ci_plan
-- $docker_kubernetes_architecture
-- $k8s_manifests_conventions
-- $n8n_pinecone_qdrant_supabase
-- $wix_self_hosted_embedded_script
-- $wix_iframe_sdk
-- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
-
-### Development (Senior Full Stack)
-- $tdd_workflow
-- $testing_strategy_js
-- $tests_quality_review
-- $es2025_beast_practices
-- $typescript_beast_practices
-- $react_beast_practices
-- $tanstack_beast_practices
-- $state_zustand_beast_practices
-- $state_rtk_beast_practices
-- $styling_css_stack
-- $tooling_bun_biome
-- $node_express_beast_practices
-- $go_beast_practices
-- $security_baseline_dev
-- $observability_logging
-- $dev_reference_snippets
-- $mongodb_mongoose_best_practices
-- $n8n_pinecone_qdrant_supabase
-- $wix_self_hosted_embedded_script
-- $wix_iframe_sdk
-- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
-
-### Review (Best Practices + Security)
-- $code_review_checklist
-- $api_contract_compliance_review
-- $security_review
-- $security_review_baseline
-- $cloud_infrastructure_security
-- $dependency_supply_chain_review
-- $observability_review
-- $performance_review_baseline
-- $review_reference_snippets
-
-### Testing (QA)
-- $qa_test_plan
-- $qa_manual_run
-- $qa_api_contract_tests
-- $qa_browser_testing
-- $qa_security_smoke_tests
-- $qa_ui_a11y_smoke
-- $qa_e2e_playwright
-
----
-
-## Гейты (Pipeline)
-PM(PRD) → UX(UX Spec) → ARCH(Architecture/ADR/Contracts) → DEV(TDD) → REV(Security/Best) → TEST(Test plan/report) → RG(Release Gate)
-
----
-
-## Обязательное правило документации функций
-- Для всех функций в кодовой базе использовать JSDoc-блок в формате:
-
-```js
-/**
- * Считает сумму двух чисел.
- * @param {number} a - Первое число.
- * @param {number} b - Второе число.
- * @returns {number} Сумма a и b.
- */
-function add(a, b) {
-    return a + b;
-}
-```
-
-- Требование обязательное для DEV и REV этапов.
-
-## Обязательное правило TDD
-- Для всех задач разработки применять TDD-цикл: RED → GREEN → REFACTOR.
-- Требование обязательное для DEV и REV этапов (наравне с JSDoc).
+<!-- code-ai: target=gpt-codex; asset=orchestrator; normalized_hints=none -->
+<!-- codex: reasoning=medium; note="auto-adapted default" -->
+# AGENTS.md — Оркестр веб-разработки
+
+## Источник правды по ролям
+Роли описаны в:
+- agents/conductor.md
+- agents/product_manager.md
+- agents/ux_ui_designer.md
+- agents/architect.md
+- agents/devops.md
+- agents/senior_full_stack.md
+- agents/reviewer.md
+- agents/tester.md
+
+При работе следуй этим ролям. Если нужно — открывай соответствующий файл роли и применяй.
+
+---
+
+## Skills (явно вызывай)
+Используй skills (папки с `SKILL.md`). Полный список:
+
+### Core / Orchestration
+- $board
+- $handoff
+- $memory
+- $gates
+- $release_gate
+- $release_gate_checklist_template
+
+### Product Management
+- $pm_interview
+- $pm_prd
+- $pm_backlog
+
+### UX/UI / Design
+- $ux_discovery
+- $ux_spec
+- $ui_inventory
+- $a11y_baseline
+- $design_intake
+- $design_parity_review
+- $design_systems
+- $ui_a11y_smoke_review
+- $google_stitch_skill
+
+### Architecture
+- $current_state_analysis
+- $system_design_checklist
+- $architecture_doc
+- $architecture_compliance_review
+- $design_patterns_reference
+- $adr_log
+- $api_contracts
+- $data_model
+- $threat_model_baseline
+- $observability_plan
+- $deployment_ci_plan
+- $docker_kubernetes_architecture
+- $k8s_manifests_conventions
+- $n8n_pinecone_qdrant_supabase
+- $wix_self_hosted_embedded_script
+- $wix_iframe_sdk
+- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
+
+### Development (Senior Full Stack)
+- $tdd_workflow
+- $testing_strategy_js
+- $tests_quality_review
+- $es2025_beast_practices
+- $typescript_beast_practices
+- $react_beast_practices
+- $tanstack_beast_practices
+- $state_zustand_beast_practices
+- $state_rtk_beast_practices
+- $styling_css_stack
+- $tailwind_beast_practices
+- $tooling_bun_biome
+- $node_express_beast_practices
+- $go_beast_practices
+- $security_baseline_dev
+- $observability_logging
+- $dev_reference_snippets
+- $mongodb_mongoose_best_practices
+- $n8n_pinecone_qdrant_supabase
+- $wix_self_hosted_embedded_script
+- $wix_iframe_sdk
+- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
+
+### Review (Best Practices + Security)
+- $code_review_checklist
+- $api_contract_compliance_review
+- $security_review
+- $security_review_baseline
+- $cloud_infrastructure_security
+- $dependency_supply_chain_review
+- $observability_review
+- $performance_review_baseline
+- $review_reference_snippets
+
+### Testing (QA)
+- $qa_test_plan
+- $qa_manual_run
+- $qa_api_contract_tests
+- $qa_browser_testing
+- $qa_security_smoke_tests
+- $qa_ui_a11y_smoke
+- $qa_e2e_playwright
+
+---
+
+## Гейты (Pipeline)
+PM(PRD) → UX(UX Spec) → ARCH(Architecture/ADR/Contracts) → DEV(TDD) → REV(Security/Best) → TEST(Test plan/report) → RG(Release Gate)
+
+---
+
+## Обязательное правило документации функций
+- Для всех функций в кодовой базе использовать JSDoc-блок в формате:
+
+```js
+/**
+ * Считает сумму двух чисел.
+ * @param {number} a - Первое число.
+ * @param {number} b - Второе число.
+ * @returns {number} Сумма a и b.
+ */
+function add(a, b) {
+    return a + b;
+}
+```
+
+- Требование обязательное для DEV и REV этапов.
+
+## Обязательное правило TDD
+- Для всех задач разработки применять TDD-цикл: RED → GREEN → REFACTOR.
+- Требование обязательное для DEV и REV этапов (наравне с JSDoc).

package/agents/architect.md

@@ -34,6 +34,59 @@
 
 ---
 
+## Design Patterns & Principles (must)
+Архитектор обязан учитывать эти паттерны при проектировании и фиксировать выбранные в ADR.
+
+> Полные DO/DON'T примеры с псевдокодом → **$design_patterns_reference**
+
+### SOLID
+| Принцип | Суть |
+|---------|------|
+| **S** — Single Responsibility | Класс/модуль — одна причина для изменения |
+| **O** — Open/Closed | Открыт для расширения, закрыт для модификации |
+| **L** — Liskov Substitution | Подтипы подставляются без поломки |
+| **I** — Interface Segregation | Много маленьких интерфейсов > одного толстого |
+| **D** — Dependency Inversion | Зависимость от абстракций, не от конкретики |
+
+### Общие принципы
+- **DRY** — Don't Repeat Yourself (про знание, не про код)
+- **KISS** — Keep It Simple, Stupid
+- **YAGNI** — You Aren't Gonna Need It
+- **Composition over Inheritance** — композиция вместо глубоких иерархий
+- **Fail Fast** — проверяй входы сразу, на границе
+- **Separation of Concerns** — разделение ответственностей по слоям
+
+### GoF Patterns (ключевые)
+| Паттерн | Когда |
+|---------|-------|
+| Strategy | Несколько вариантов алгоритма, выбор в runtime |
+| Observer | Один источник событий, много потребителей |
+| Factory Method | Тип объекта определяется в runtime |
+| Adapter | Интеграция с чужим API/библиотекой |
+| Facade | Простой интерфейс к сложной подсистеме |
+| Decorator | Комбинации поведений без взрыва подклассов |
+| Command | Undo/redo, очереди, отложенное выполнение |
+| State | Множество состояний с разным поведением |
+| Template Method | Одинаковый каркас, разные детали |
+
+### Архитектурные паттерны
+| Паттерн | Когда |
+|---------|-------|
+| Repository | Изоляция доступа к данным от бизнес-логики |
+| Service Layer | Бизнес-логика не в контроллерах |
+| Dependency Injection | Слабая связь, тестируемость |
+| Event-Driven | Реакция на события без жёсткой связи |
+| CQRS | Разные модели чтения и записи |
+
+### Микросервисные паттерны
+| Паттерн | Когда |
+|---------|-------|
+| Saga | Распределённые транзакции через компенсации |
+| Circuit Breaker | Защита от каскадных сбоев внешних сервисов |
+| Mediator | Центральный координатор взаимодействий |
+
+---
+
 ## Architecture Review Process
 1. **Current State Analysis** (если есть код): patterns, conventions, tech debt, scaling limits
 2. **Requirements Gathering**: functional + non-functional + integrations + data flows
@@ -223,6 +276,8 @@
 - $current_state_analysis
 - $system_design_checklist
 - $architecture_doc
+- $architecture_compliance_review
+- $design_patterns_reference
 - $adr_log
 - $api_contracts
 - $data_model

package/dist/platforms/adapters.js

@@ -253,7 +253,7 @@ function planForGeminiLayout(layout, catalog, destinationDir, selectedAgents, se
         }
         operations.push({
             sourcePath,
-            destinationPath: path.join(destinationDir, layout.skillsDir, `${skillName}.md`),
+            destinationPath: path.join(destinationDir, layout.skillsDir, skillName, "SKILL.md"),
             generated: false,
             transform: {
                 target,
@@ -262,7 +262,7 @@ function planForGeminiLayout(layout, catalog, destinationDir, selectedAgents, se
         });
         operations.push({
             sourcePath: "<generated>",
-            destinationPath: path.join(destinationDir, layout.skillsDir, `${skillName}.py`),
+            destinationPath: path.join(destinationDir, layout.skillsDir, skillName, `${skillName}.py`),
             generated: true,
             content: renderGeminiSkillStub(skillName),
         });
@@ -327,7 +327,7 @@ function renderGeminiAgentConfig(agentName) {
 function renderGeminiSkillStub(skillName) {
     return [
         `"""Auto-generated skill stub for ${skillName}.`,
-        `See ${skillName}.md for behavior details."""`,
+        `See SKILL.md for behavior details."""`,
         "",
         "",
         "def run(input_text: str) -> str:",