code-ai-installer 1.5.0 → 1.5.2

package/.agents/workflows/start-task.md

@@ -1,121 +1,130 @@
----
-description: Шаблон запуска задачи через 8-агентный пайплайн. Используй в начале КАЖДОЙ сессии.
----
-
-# /start-task — Запуск задачи через пайплайн
-
-## Шаг 1: Загрузить правила пайплайна
-
-Выполни `/pipeline-rules` — прочитай и подтверди ВСЕ правила ПЕРЕД началом работы.
-
-## Шаг 2: Инициализировать агентов
-Выполни `view_file` на `AGENTS.md` — подтверди список агентов и skills.
-
-## Шаг 3: Запустить Дирижёра
-Выполни `view_file` на `agents/conductor.md` — прочитай протокол и создай Master Checklist в `task.md`.
-
-## Шаг 4: Пройти каждый гейт СТРОГО по протоколу
-
-На КАЖДОМ гейте обязательно:
-1. `view_file` на `agents/<role>.md` — прочитать протокол агента
-2. Пройти КАЖДУЮ секцию протокола по порядку (не «схлопывать»)
-3. Использовать **полный** «Формат ответа агента (строго)» из файла агента
-4. Если секция не применима — явно написать: «N/A — [причина]»
-5. Сформировать deliverable + Handoff Envelope со ВСЕМИ обязательными полями
-6. Представить результат через `notify_user`
-7. **Ждать явный "Approved"** перед переходом к следующему гейту
-
-## Шаг 5: Код — ТОЛЬКО после DEV gate + Approved
-
-- Сначала DEV-агент проходит ВСЕ секции протокола (§0–§7)
-- Потом предлагает план изменений
-- Пользователь одобряет
-- ТОЛЬКО ПОТОМ агент применяет код
-
-## Шаг 6: Fix Cycle (при FAIL)
-
-Если тестер или ревьюер нашёл баг:
-1. Текущий агент выдаёт FAIL Report + HANDOFF Envelope → DEV
-2. Пользователь одобряет FAIL HANDOFF
-3. DEV читает `agents/senior_full_stack.md` и проходит ПОЛНЫЙ протокол
-4. DEV HANDOFF → REV → OPS → TEST (каждый гейт с полным протоколом)
-5. Никаких «быстрых фиксов» без прохода через агентов
-
----
-
-## Шаблон первого промпта (копируй и заполни)
-
-```
-@AGENTS.md /pipeline-rules
-
-Задача: [что сделать, 1-2 предложения].
-Файлы: [конкретные файлы, если известны].
-
-Правила:
-1. Начинай с Дирижёра (agents/conductor.md)
-2. Каждый гейт: view_file → ВСЕ секции протокола → полный формат → Approved
-3. Код не применять до DEV gate + мой Approved
-4. Fix Cycle = полный проход через агентов
-```
-
----
-
-## Рекомендации по сессиям
-
-- **Одна сессия = 3-4 гейта максимум** (контекст не теряется)
-- **Approved даётся на КАЖДОМ гейте**, не на сессию
-- **Сессия 1:** Conductor → Approved → PM → Approved → UX → Approved
-- **Сессия 2:** ARCH → Approved → DEV → Approved → REV → Approved
-- **Сессия 3:** OPS → Approved → TEST → Approved → RG → Approved
-- Каждая новая сессия — начинай с `/start-task`
-
-## Обязательные вопросы от агентов
-
-Каждый агент, у которого в протоколе есть Clarification/Questions секция, ОБЯЗАН:
-1. Задать вопросы пользователю ПЕРЕД выполнением работы
-2. Минимум вопросов (из протокола агента): PM — 5+, ARCH — 5-10, DEV — по необходимости, Tester — 5+
-3. Если задача кажется «очевидной» — всё равно задать минимум 2-3 уточняющих вопроса
-4. Ждать ответы пользователя ПЕРЕД продолжением
-5. Единственное исключение: пользователь явно написал «вопросов не задавай»
-
-## При «срезании углов» — одна фраза
-
-Если модель сокращает, скажи:
-> «Стоп. Секция [X] протокола agents/<role>.md. Перечитай и выполни.»
-
----
-
-## Протокол обратной связи (обязательно)
-
-Модель ОБЯЗАНА предоставлять обратную связь пользователю на каждом этапе:
-
-### 1. Предупреждение при соблазне срезать
-Если задача выглядит «тривиальной», модель ОБЯЗАНА написать:
-```
-⚠️ Задача выглядит тривиальной. Мой инстинкт — сделать быстро.
-Но по протоколу прохожу полный цикл. Секции: [список].
-```
-
-### 2. Оценка промпта пользователя
-В начале каждой задачи модель оценивает промпт:
-```
-📊 Оценка промпта:
-- Чёткость: [высокая/средняя/низкая]
-- Что хорошо: [что помогло]
-- Чего не хватает: [что добавить для эффективности]
-```
-
-### 3. Подсказки в Handoff Envelope
-В каждом Handoff добавлять секцию:
-```
-💡 Feedback: [совет для пользователя, если есть]
-```
-
-### 4. Ретроспектива в конце сессии
-Перед завершением работы:
-```
-🔄 Ретроспектива:
-- Гейтов пройдено: X
-- Нарушений протокола: X
-- Что улучшить в следующей сессии: [рекомендация]
+---
+description: Шаблон запуска задачи через 8-агентный пайплайн. Используй в начале КАЖДОЙ сессии.
+---
+
+# /start-task — Запуск задачи через пайплайн
+
+## Шаг 0: Выбрать режим пайплайна
+
+Определи тип задачи и выбери workflow:
+- 🔵 **Новая фича / рефакторинг** → продолжай по `/start-task` (этот файл)
+- 🟢 **Багфикс** (> 2 файлов, нетривиальный) → переключись на `/bugfix`
+- 🟡 **Hotfix** (1–2 файла, blast radius ≈ 0) → переключись на `/hotfix`
+
+> Если выбран `/bugfix` или `/hotfix` — прекрати чтение этого файла и следуй выбранному workflow.
+
+## Шаг 1: Загрузить правила пайплайна
+
+Выполни `/pipeline-rules` — прочитай и подтверди ВСЕ правила ПЕРЕД началом работы.
+
+## Шаг 2: Инициализировать агентов
+Выполни `view_file` на `AGENTS.md` — подтверди список агентов и skills.
+
+## Шаг 3: Запустить Дирижёра
+Выполни `view_file` на `agents/conductor.md` — прочитай протокол и создай Master Checklist в `task.md`.
+
+## Шаг 4: Пройти каждый гейт СТРОГО по протоколу
+
+На КАЖДОМ гейте обязательно:
+1. `view_file` на `agents/<role>.md` — прочитать протокол агента
+2. Пройти КАЖДУЮ секцию протокола по порядку (не «схлопывать»)
+3. Использовать **полный** «Формат ответа агента (строго)» из файла агента
+4. Если секция не применима — явно написать: «N/A — [причина]»
+5. Сформировать deliverable + Handoff Envelope со ВСЕМИ обязательными полями
+6. Представить результат через `notify_user`
+7. **Ждать явный "Approved"** перед переходом к следующему гейту
+
+## Шаг 5: Код — ТОЛЬКО после DEV gate + Approved
+
+- Сначала DEV-агент проходит ВСЕ секции протокола (§0–§7)
+- Потом предлагает план изменений
+- Пользователь одобряет
+- ТОЛЬКО ПОТОМ агент применяет код
+
+## Шаг 6: Fix Cycle (при FAIL)
+
+Если тестер или ревьюер нашёл баг:
+1. Текущий агент выдаёт FAIL Report + HANDOFF Envelope → DEV
+2. Пользователь одобряет FAIL HANDOFF
+3. DEV читает `agents/senior_full_stack.md` и проходит ПОЛНЫЙ протокол
+4. DEV HANDOFF → REV → OPS → TEST (каждый гейт с полным протоколом)
+5. Никаких «быстрых фиксов» без прохода через агентов
+
+---
+
+## Шаблон первого промпта (копируй и заполни)
+
+```
+@AGENTS.md /pipeline-rules
+
+Задача: [что сделать, 1-2 предложения].
+Файлы: [конкретные файлы, если известны].
+
+Правила:
+1. Начинай с Дирижёра (agents/conductor.md)
+2. Каждый гейт: view_file → ВСЕ секции протокола → полный формат → Approved
+3. Код не применять до DEV gate + мой Approved
+4. Fix Cycle = полный проход через агентов
+```
+
+---
+
+## Рекомендации по сессиям
+
+- **Одна сессия = 3-4 гейта максимум** (контекст не теряется)
+- **Approved даётся на КАЖДОМ гейте**, не на сессию
+- **Сессия 1:** Conductor → Approved → PM → Approved → UX → Approved
+- **Сессия 2:** ARCH → Approved → DEV → Approved → REV → Approved
+- **Сессия 3:** OPS → Approved → TEST → Approved → RG → Approved
+- Каждая новая сессия — начинай с `/start-task`
+
+## Обязательные вопросы от агентов
+
+Каждый агент, у которого в протоколе есть Clarification/Questions секция, ОБЯЗАН:
+1. Задать вопросы пользователю ПЕРЕД выполнением работы
+2. Минимум вопросов (из протокола агента): PM — 5+, ARCH — 5-10, DEV — по необходимости, Tester — 5+
+3. Если задача кажется «очевидной» — всё равно задать минимум 2-3 уточняющих вопроса
+4. Ждать ответы пользователя ПЕРЕД продолжением
+5. Единственное исключение: пользователь явно написал «вопросов не задавай»
+
+## При «срезании углов» — одна фраза
+
+Если модель сокращает, скажи:
+> «Стоп. Секция [X] протокола agents/<role>.md. Перечитай и выполни.»
+
+---
+
+## Протокол обратной связи (обязательно)
+
+Модель ОБЯЗАНА предоставлять обратную связь пользователю на каждом этапе:
+
+### 1. Предупреждение при соблазне срезать
+Если задача выглядит «тривиальной», модель ОБЯЗАНА написать:
+```
+⚠️ Задача выглядит тривиальной. Мой инстинкт — сделать быстро.
+Но по протоколу прохожу полный цикл. Секции: [список].
+```
+
+### 2. Оценка промпта пользователя
+В начале каждой задачи модель оценивает промпт:
+```
+📊 Оценка промпта:
+- Чёткость: [высокая/средняя/низкая]
+- Что хорошо: [что помогло]
+- Чего не хватает: [что добавить для эффективности]
+```
+
+### 3. Подсказки в Handoff Envelope
+В каждом Handoff добавлять секцию:
+```
+💡 Feedback: [совет для пользователя, если есть]
+```
+
+### 4. Ретроспектива в конце сессии
+Перед завершением работы:
+```
+🔄 Ретроспектива:
+- Гейтов пройдено: X
+- Нарушений протокола: X
+- Что улучшить в следующей сессии: [рекомендация]
 ```

package/AGENTS.md

@@ -1,135 +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
-- $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
-- $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/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:",

package/locales/en/.agents/workflows/bugfix.md

@@ -0,0 +1,90 @@
+---
+description: Launch the shortened 4-gate pipeline for bug fixes. Use instead of /start-task for bugfix tasks.
+---
+
+# /bugfix — Launch Bugfix Pipeline (4 gates)
+
+> 🟢 **Mode:** Bugfix — for fixing bugs in existing functionality.
+> Full pipeline: `/start-task`. Hotfix (trivial): `/hotfix`.
+
+## When to use
+
+- Bug in logic, API errors, broken validation, data issues
+- Affects > 2 files or non-trivial blast radius
+- Does NOT change UI layout, does NOT add new API, does NOT change data schema (otherwise → `/start-task`)
+
+## Step 0: Load rules
+
+Execute `/pipeline-rules` — read the rules BEFORE starting work.
+
+## Step 1: CONDUCTOR — Classification
+
+1. Execute `view_file` on `agents/conductor.md`
+2. Confirm the task = bugfix (per Decision Tree)
+3. Create Mini Checklist:
+```
+[ ] BF-DEV-01   Fix + TDD + Handoff Envelope
+[ ] BF-REV-01   Code review + regression check + Handoff Envelope
+[ ] BF-TEST-01  Verification + regression smoke + GO/NO-GO
+```
+4. `notify_user` → wait for **Approved**
+
+## Step 2: DEV — TDD Fix
+
+1. Execute `view_file` on `agents/senior_full_stack.md`
+2. Follow the protocol (skipping §1 UX review and §6 DEMO):
+   - §0: Context + read skills
+   - §2: Analyze bug + root cause
+   - §3: RED — write a failing test reproducing the bug
+   - §4: GREEN — minimal code to make the test pass
+   - §5: REFACTOR — improve without changing behavior
+   - §7: JSDoc on modified functions
+3. Restart affected services if applicable
+4. Form Handoff Envelope → REV
+5. `notify_user` → wait for **Approved**
+
+## Step 3: REV — Code Review
+
+1. Execute `view_file` on `agents/reviewer.md`
+2. Review focus:
+   - Does the test actually reproduce the bug (RED phase)?
+   - Does the fix create side effects?
+   - Is regression risk assessed?
+   - Is JSDoc in place?
+3. Form Handoff Envelope → TEST
+4. `notify_user` → wait for **Approved**
+
+## Step 4: TEST — Verification
+
+1. Execute `view_file` on `agents/tester.md`
+2. Verify:
+   - Bug is fixed (per reproduction steps)
+   - No regression (smoke on affected modules)
+   - Tests pass (CI green)
+3. Issue verdict: **GO ✅ / NO-GO ❌**
+4. `notify_user` → wait for **Approved**
+
+---
+
+## On FAIL at REV or TEST
+
+1. Agent produces FAIL Report + Handoff → DEV
+2. DEV fixes → Handoff → REV → TEST (cycle repeats)
+3. Approved is required at every gate
+
+---
+
+## Prompt template
+
+```
+@AGENTS.md /bugfix
+
+Bug: [bug description, 1-2 sentences].
+Reproduction: [steps, if known].
+Files: [affected files, if known].
+
+Rules:
+1. Bugfix Pipeline: CONDUCTOR → DEV → REV → TEST
+2. TDD is mandatory (RED → GREEN → REFACTOR)
+3. Approved at every gate
+```