workflow-ai 1.0.63 → 1.0.64

package/src/skills/decompose-gaps/algorithms/scope-check.md

@@ -0,0 +1,110 @@
+# Алгоритм: Проверка scope gap
+
+Формализованный алгоритм определения, входит ли gap в scope декомпозиции.
+
+## Вход
+
+| Параметр | Тип | Описание |
+|----------|-----|----------|
+| `gap` | string | Описание одного конкретного пробела |
+| `report` | file | Содержимое отчёта REPORT-{id}.md |
+| `plan` | file | Содержимое исходного плана PLAN-{id}.md |
+
+## Выход
+
+| Параметр | Тип | Описание |
+|----------|-----|----------|
+| `in_scope` | boolean | true — создавать тикет, false — записать в «Новые требования» |
+| `reason` | string | Обоснование решения |
+| `check_failed` | string | Номер проверки, на которой gap был отклонён (если отклонён) |
+
+## Алгоритм
+
+```
+FUNCTION check_scope(gap, report, plan) → {in_scope, reason, check_failed}
+
+  # Шаг 1: Проверка источника
+  source_section = найти секцию отчёта, откуда извлечён gap
+
+  IF source_section IN [
+    "Рекомендации для Architect",
+    "План на следующий период",
+    "Потенциальные риски",
+    "Следующие шаги"
+  ]:
+    RETURN {false, "Gap из секции '{source_section}' — не является пробелом", "1"}
+
+  IF source_section NOT IN [
+    "Выполненные задачи",
+    "Заблокированные задачи",
+    "Риски и проблемы"
+  ]:
+    RETURN {false, "Gap из неизвестной секции '{source_section}'", "1"}
+
+  # Шаг 2: Проверка принадлежности к плану
+  matching_task = найти задачу в plan, которой соответствует gap
+
+  IF matching_task == NULL:
+    RETURN {false, "Нет соответствующей задачи в исходном плане", "2"}
+
+  # Шаг 2a: Проверка exclusions из scope плана
+  plan_exclusions = извлечь секцию «Исключено из scope» / «Excluded from scope» из plan
+
+  IF plan_exclusions != NULL:
+    FOR EACH exclusion IN plan_exclusions:
+      IF gap описывает работу, подпадающую под exclusion:
+        RETURN {false, "Gap подпадает под исключение из scope плана: '{exclusion}'", "2a"}
+
+  IF gap описывает расширение scope (новый функционал, не заявленный в плане):
+    RETURN {false, "Расширение scope за рамки плана", "2"}
+
+  IF gap — deliverable другого тикета (создан как часть DoD):
+    RETURN {false, "Deliverable другого тикета, не gap", "2"}
+
+  # Шаг 3: Проверка статуса плана
+  plan_status = извлечь status из plan
+
+  IF plan_status == "completed":
+    RETURN {false, "План завершён — gaps = новые инициативы", "3"}
+
+  IF все ключевые задачи плана выполнены:
+    RETURN {false, "Все ключевые задачи выполнены", "3"}
+
+  # Шаг 4: Проверка workflow-управления
+  IF gap содержит действия:
+    - перемещение тикетов
+    - изменение статуса других тикетов
+    - запуск workflow-скриптов
+    - операции с .workflow/tickets/, .workflow/plans/, .workflow/reports/
+  :
+    RETURN {false, "Содержит инструкции по workflow-управлению", "4"}
+
+  # Все проверки пройдены
+  RETURN {true, "Gap в scope: соответствует задаче '{matching_task}' плана", NULL}
+```
+
+## Пример применения
+
+**Вход:**
+- gap: "Не реализована валидация входных данных в модуле обработки"
+- report: REPORT-003 (секция «Выполненные задачи», статус задачи: partial)
+- plan: PLAN-006 (задача #3: "Реализовать валидацию входных данных", status: in_progress)
+
+**Прохождение:**
+1. Источник: «Выполненные задачи» → ✅ валидный источник
+2. Принадлежность: задача #3 плана → ✅ есть в плане
+3. Статус: plan status = in_progress → ✅ план не завершён
+4. Workflow: нет управляющих инструкций → ✅
+
+**Выход:** `{true, "Gap в scope: соответствует задаче #3 плана", NULL}`
+
+## Граничные случаи
+
+| Случай | Решение |
+|--------|---------|
+| Gap на стыке двух задач плана | Создать один тикет, ссылаясь на обе задачи |
+| Gap частично в scope, частично нет | Разделить: in-scope часть → тикет, out-of-scope → «Новые требования» |
+| Заблокированная задача по внешней зависимости | Не gap — внешние зависимости не контролируются скилом |
+| Gap описывает «улучшить» вместо «исправить» | Проверить, было ли в DoD плана — если нет, out of scope |
+
+<!-- РАСШИРЕНИЕ: добавляй новые граничные случаи ниже -->

package/src/skills/decompose-gaps/knowledge/scope-validation.md

@@ -0,0 +1,65 @@
+# Валидация scope для gaps
+
+Критерии определения, какие gaps входят в scope декомпозиции, а какие — нет.
+
+## Проверка 1: Источник gap
+
+Gap — это исключительно то, что **не выполнено или выполнено некорректно** из явного списка задач плана.
+
+### Валидные источники gaps
+
+| Секция отчёта | Что является gap |
+|---------------|-----------------|
+| «Выполненные задачи» | Задачи со статусом failed/skipped, где DoD не выполнен |
+| «Заблокированные задачи» | Задачи, заблокированные по техническим причинам (не по внешним зависимостям) |
+| «Риски и проблемы» | Только конкретные сбои в выполненных задачах |
+
+### НЕ являются источником gaps
+
+| Секция отчёта | Почему не gap |
+|---------------|--------------|
+| «Рекомендации для Architect» | Советы, не пробелы |
+| «План на следующий период» | Новые инициативы, не пробелы |
+| «Потенциальные риски» | Гипотезы, не пробелы |
+| Упоминания будущих задач (XXX-005 и т.п.) | Планируемая работа, не текущие пробелы |
+
+## Проверка 2: Принадлежность к scope исходного плана
+
+### Gap в scope (создавать тикет)
+
+- Задача была в исходном плане, но не выполнена или выполнена некорректно
+- Доработка существующего результата, который не соответствует DoD плана
+- Исправление ошибки в уже сделанной работе по плану
+
+### Gap вне scope (НЕ создавать тикет)
+
+- Новая работа, которой не было в исходном плане
+- Расширение scope за рамки первоначальных требований
+- Задачи, созданные другими тикетами как часть их DoD (deliverables, не gaps)
+- Задачи из секций «Рекомендации», «План на следующий период», «Следующие шаги»
+- Работа, явно исключённая в секции «Исключено из scope» плана (например, план тестирования может исключать исправление найденных дефектов — тогда создание fix-тикетов вне scope, даже если дефект найден задачей плана)
+
+## Проверка 3: Статус плана
+
+| Статус плана | Действие |
+|-------------|----------|
+| `in_progress` | Декомпозировать gaps нормально |
+| `completed` | **НЕ создавать тикеты** — gaps в завершённом плане = новые инициативы для следующего плана |
+| Все ключевые задачи выполнены | **НЕ создавать тикеты** — аналогично completed |
+
+## Проверка 4: Запрет на workflow-управление
+
+**⛔ КРИТИЧЕСКИ ВАЖНО:** Тикеты **НИКОГДА** не должны содержать инструкции по управлению workflow-артефактами.
+
+### Запрещено создавать тикеты на:
+
+- Перемещение других тикетов между папками (backlog → ready → done)
+- Изменение статуса или метаданных других тикетов
+- Запуск workflow-скриптов (`move-ticket.js`, `pick-next-task.js` и т.п.)
+- Любые операции с `.workflow/tickets/`, `.workflow/plans/`, `.workflow/reports/`
+
+### Если обнаружен «застрявший» тикет:
+
+Это инфраструктурная проблема → записать в «Новые требования (вне scope)» для ручного разбора.
+
+<!-- РАСШИРЕНИЕ: добавляй новые правила валидации scope ниже -->

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/claude-sonnet/trial-1.md

@@ -0,0 +1,49 @@
+## Анализ gap: «Нужно исправить дефект маппинга полей»
+
+### Применение алгоритма scope-check
+
+**Шаг 2a — Проверка раздела «Исключено из scope»:**
+
+Из контекста задачи:
+
+| Параметр | Значение |
+|----------|----------|
+| Gap | «Нужно исправить дефект маппинга полей» |
+| Секция плана | «Исключено из scope: исправление дефектов» |
+
+**Проверка:**
+- `plan_exclusions` = `["исправление дефектов"]`
+- Gap описывает исправление дефекта (дефект маппинга полей)
+- Gap **прямо подпадает** под исключение
+
+**Результат алгоритма:**
+```
+{
+  in_scope: false,
+  reason: "Gap подпадает под исключение из scope плана: 'исправление дефектов'",
+  check_failed: "2a"
+}
+```
+
+---
+
+## Новые требования (вне scope)
+
+Следующий gap **исключён** и не конвертируется в тикет:
+
+> **Gap:** «Нужно исправить дефект маппинга полей»
+>
+> **Причина отклонения:** Gap scope-исключён — план явно содержит раздел «Исключено из scope: исправление дефектов». Данная работа выходит за рамки текущего плана.
+>
+> **Проверка:** 2a (exclusion check)
+>
+> **Рекомендация:** Оформить как отдельную инициативу или новый план, если исправление дефекта маппинга полей признаётся приоритетным.
+
+---
+
+## ---RESULT---
+
+**Тикеты созданы:** 0
+
+**Gaps, отклонённых как вне scope:** 1
+- «Нужно исправить дефект маппинга полей» — scope-исключён (проверка 2a: «Исключено из scope: исправление дефектов»)

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/claude-sonnet/trial-2.md

@@ -0,0 +1,56 @@
+## Декомпозиция gaps
+
+### Анализ входных данных
+
+| Параметр | Значение |
+|----------|----------|
+| Gap | «Нужно исправить дефект маппинга полей» |
+| Контекст плана | Секция «Исключено из scope: исправление дефектов» |
+
+---
+
+### Проверка scope (алгоритм scope-check.md)
+
+**Шаг 2a — Проверка исключений из scope плана:**
+
+Из плана извлечена секция исключений:
+> *«Исключено из scope: исправление дефектов»*
+
+Gap «Нужно исправить дефект маппинга полей» — это буквально «исправление дефекта». Он **прямо подпадает** под исключение из scope плана.
+
+**Результат проверки:**
+
+```
+check_scope(gap) → {
+  in_scope:     false,
+  reason:       "Gap подпадает под исключение из scope плана: 'исправление дефектов'",
+  check_failed: "2a"
+}
+```
+
+Gap **отклонён на шаге 2a**. Дальнейшие проверки (3, 4) не применяются.
+
+---
+
+### Созданные тикеты
+
+*(нет — ни один gap не прошёл scope-валидацию)*
+
+---
+
+### Новые требования (вне scope)
+
+| Gap | Причина отклонения |
+|-----|--------------------|
+| «Нужно исправить дефект маппинга полей» | Исключено из scope плана: «исправление дефектов» (проверка 2a) |
+
+Этот gap следует передать архитектору или PM для включения в **отдельный план** — если исправление дефекта признано приоритетным, оно должно появиться как явная задача в следующем плане, а не как доработка текущего.
+
+---
+
+**---RESULT---**
+
+Тикетов создано: **0**
+
+Gaps отклонено (вне scope): **1**
+- «Нужно исправить дефект маппинга полей» → отклонён по проверке 2a (явно исключено из scope плана)

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/claude-sonnet/trial-3.md

@@ -0,0 +1,39 @@
+## Анализ gap: проверка scope
+
+### Gap: «Нужно исправить дефект маппинга полей»
+
+Применяю алгоритм `scope-check.md`:
+
+---
+
+**Шаг 1 — Проверка источника:** источник не указан явно, продолжаю.
+
+**Шаг 2 — Принадлежность к плану:** план содержит секцию **«Исключено из scope: исправление дефектов»**.
+
+**Шаг 2a — Проверка exclusions:**
+- `plan_exclusions` = `["исправление дефектов"]`
+- Gap «исправить дефект маппинга полей» → описывает исправление дефекта
+- Совпадение найдено
+
+**Результат:** `{in_scope: false, reason: "Gap подпадает под исключение из scope плана: 'исправление дефектов'", check_failed: "2a"}`
+
+---
+
+**Тикет не создаётся.**
+
+---
+
+## Новые требования (вне scope)
+
+| Gap | Причина отклонения | Рекомендация |
+|-----|--------------------|--------------|
+| Исправить дефект маппинга полей | Явно исключено из scope плана: «исправление дефектов» | Создать отдельную задачу в новом плане или обратиться к Architect для принятия решения о приоритизации |
+
+---
+
+```
+---RESULT---
+Тикеты созданы: 0
+Gaps вне scope: 1
+  - «Нужно исправить дефект маппинга полей» → исключено из scope плана (Проверка 2a)
+```

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/judge.json

@@ -0,0 +1,164 @@
+{
+  "per_model": {
+    "claude-sonnet": {
+      "pass_count": 3,
+      "total": 3,
+      "trials": [
+        {
+          "trial": 1,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 2,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 3,
+          "score": 5,
+          "passed": true
+        }
+      ]
+    },
+    "kilo-glm": {
+      "pass_count": 2,
+      "total": 3,
+      "trials": [
+        {
+          "trial": 1,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 2,
+          "score": null,
+          "passed": false
+        },
+        {
+          "trial": 3,
+          "score": 5,
+          "passed": true
+        }
+      ]
+    },
+    "kilo-minimax": {
+      "pass_count": 3,
+      "total": 3,
+      "trials": [
+        {
+          "trial": 1,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 2,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 3,
+          "score": 5,
+          "passed": true
+        }
+      ]
+    },
+    "kilo-deepseek": {
+      "pass_count": 3,
+      "total": 3,
+      "trials": [
+        {
+          "trial": 1,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 2,
+          "score": 5,
+          "passed": true
+        },
+        {
+          "trial": 3,
+          "score": 5,
+          "passed": true
+        }
+      ]
+    }
+  },
+  "rubric_scores": [
+    {
+      "agentId": "claude-sonnet",
+      "trial": 1,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "claude-sonnet",
+      "trial": 2,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "claude-sonnet",
+      "trial": 3,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-deepseek",
+      "trial": 1,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-deepseek",
+      "trial": 2,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-deepseek",
+      "trial": 3,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-glm",
+      "trial": 1,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-glm",
+      "trial": 2,
+      "score": null,
+      "errored": true,
+      "error": "Stage \"TC-DECOMPOSE-GAPS-001-kilo-glm-trial-2\" timed out after 2400s"
+    },
+    {
+      "agentId": "kilo-glm",
+      "trial": 3,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-minimax",
+      "trial": 1,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-minimax",
+      "trial": 2,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-minimax",
+      "trial": 3,
+      "score": 5,
+      "errored": false
+    }
+  ],
+  "timestamp": "2026-04-20T11:07:05.170Z"
+}

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-deepseek/trial-1.md

@@ -0,0 +1,25 @@
+**Анализ scope gap**
+
+Gap: «Нужно исправить дефект маппинга полей».
+
+Проверка по алгоритму `scope-check`:
+1. **Проверка источника** – источник не указан, но допустим, что gap взят из валидной секции отчёта.
+2. **Проверка принадлежности к плану** – план содержит явное исключение: «Исключено из scope: исправление дефектов». Описываемая работа (исправление дефекта) подпадает под это исключение.
+3. **Проверка статуса плана** – статус плана неизвестен, но даже при `in_progress` исключение из scope остаётся в силе.
+4. **Проверка workflow-управления** – gap не содержит инструкций по управлению workflow.
+
+**Результат проверки:** gap **вне scope** декомпозиции.  
+Причина: «Gap подпадает под исключение из scope плана: “исправление дефектов”».
+
+---
+
+### Новые требования (вне scope плана)
+
+- **«Нужно исправить дефект маппинга полей»** – причина: Gap подпадает под исключение из scope плана: «Исключено из scope: исправление дефектов».
+
+---
+
+---RESULT---
+status: default
+created_tickets: 
+---RESULT---

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-deepseek/trial-2.md

@@ -0,0 +1,11 @@
+**Результат декомпозиции gaps**
+
+### Новые требования (вне scope плана)
+- «Нужно исправить дефект маппинга полей» — причина: Gap подпадает под исключение из scope плана: «Исключено из scope: исправление дефектов». Работа по исправлению дефектов явно исключена из scope исходного плана, поэтому создание тикета не требуется.
+
+---
+
+---RESULT---
+status: default
+created_tickets: 
+---RESULT---

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-deepseek/trial-3.md

@@ -0,0 +1,26 @@
+**Проверка scope для gap**
+
+Gap: «Нужно исправить дефект маппинга полей».
+
+**Проверка 1 (Источник)** – предположительно из секции «Выполненные задачи» или «Риски и проблемы» – источник валиден.
+
+**Проверка 2a (Исключения scope плана)** – план содержит явное исключение: «Исключено из scope: исправление дефектов». Gap описывает исправление дефекта, что полностью подпадает под это исключение.
+
+→ **Gap вне scope декомпозиции.**  
+Причина: «Gap подпадает под исключение из scope плана: 'исправление дефектов'» (проверка 2a).
+
+---
+
+**Новые требования (вне scope)**
+
+| Gap | Причина отклонения |
+|-----|-------------------|
+| «Нужно исправить дефект маппинга полей» | Gap подпадает под исключение из scope плана: «Исключено из scope: исправление дефектов». Работа является новым требованием, не входящим в текущий план. |
+
+---
+
+**---RESULT---**
+
+Создано тикетов: 0
+
+Отклонённых gaps (вне scope): 1

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-glm/trial-1.md

@@ -0,0 +1,19 @@
+## Результат scope-проверки
+
+**Проверка 2a (исключения из scope):** Gap «Нужно исправить дефект маппинга полей» семантически подпадает под исключение «Исключено из scope: исправление дефектов». Ключевое слово «дефект» в формулировке gap напрямую соответствует пункту исключения.
+
+**Решение:** `in_scope: false` — тикет **не создаётся**.
+
+---
+
+### Новые требования (вне scope плана)
+
+- «Нужно исправить дефект маппинга полей» — причина: gap подпадает под исключение из scope плана: «исправление дефектов» (проверка 2a)
+
+---
+
+---RESULT---
+status: default
+created_tickets: (нет)
+rejected_gaps: 1
+---RESULT---

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-glm/trial-2.md

@@ -0,0 +1,5 @@
+# TRIAL ERRORED
+
+agent: kilo-glm
+trial: 2
+error: Stage "TC-DECOMPOSE-GAPS-001-kilo-glm-trial-2" timed out after 2400s

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-glm/trial-3.md

@@ -0,0 +1,28 @@
+Now I understand the test case. The gap "Нужно исправить дефект маппинга полей" falls under the plan's explicit exclusion "Исключено из scope: исправление дефектов". Per scope check 2a, this gap must be rejected.
+
+## Результат scope-проверки
+
+**Gap:** «Нужно исправить дефект маппинга полей»
+
+**Проверка scope — шаг 2a:** План содержит секцию «Исключено из scope: исправление дефектов». Gap семантически подпадает под это исключение — «исправить дефект» = «исправление дефектов».
+
+**Решение:** `in_scope: false`
+
+**Причина:** Gap подпадает под исключение из scope плана: «исправление дефектов» (проверка 2a).
+
+**Тикет НЕ создаётся.**
+
+---
+
+### Новые требования (вне scope)
+
+| Gap | Причина отклонения |
+|-----|-------------------|
+| «Нужно исправить дефект маппинга полей» | Подпадает под исключение плана: «Исключено из scope: исправление дефектов» (проверка 2a). Является новой инициативой, не предусмотренной текущим планом. |
+
+---
+
+---RESULT---
+- Создано тикетов: 0
+- Отклонено (вне scope): 1
+  - «Исправить дефект маппинга полей» → исключение плана «исправление дефектов»

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-minimax/trial-1.md

@@ -0,0 +1,23 @@
+По алгоритму `scope-check.md` (шаг 2a):
+
+**Анализ gap:**
+- Gap: «Нужно исправить дефект маппинга полей»
+- План содержит секцию: «Исключено из scope: исправление дефектов»
+
+**Результат проверки scope:**
+- `in_scope: false`
+- `reason: Gap подпадает под исключение из scope плана: 'исправление дефектов'`
+- `check_failed: 2a`
+
+Gap **вне scope** — план явно исключает исправление дефектов.
+
+---RESULT---
+status: has_gaps
+created_tickets: []
+rejected_gaps: 1
+gaps_out_of_scope:
+  - gap: "Нужно исправить дефект маппинга полей"
+    reason: "Gap подпадает под исключение из scope плана: 'исправление дефектов'"
+    check_failed: "2a"
+new_requirements: []
+---RESULT---

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-001/current/kilo-minimax/trial-2.md

@@ -0,0 +1,27 @@
+Согласно алгоритму проверки scope и документу `scope-validation.md`:
+
+**Gap «Нужно исправить дефект маппинга полей»** попадает под проверку 2a (exclusions).
+
+**Шаг 2a:** План содержит секцию «Исключено из scope: исправление дефектов». Gap напрямую описывает исправление дефекта → попадает под исключение.
+
+**Результат:** Gap вне scope — тикет НЕ создаётся.
+
+---
+
+## Результат декомпозиции
+
+### Новые требования (вне scope)
+
+| Gap | Причина отклонения | Проверка |
+|-----|---------------------|----------|
+| «Нужно исправить дефект маппинга полей» | Gap подпадает под исключение из scope плана: «Исключено из scope: исправление дефектов» | 2a |
+
+---
+
+---RESULT---
+**Созданные тикеты:** 0  
+**Отклонённые gaps:** 1
+
+**Отклонённые gaps:**
+1. Gap «Нужно исправить дефект маппинга полей» → Gap подпадает под исключение из scope плана: «Исключено из scope: исправление дефектов» (проверка 2a). Рекомендация: записать в «Новые требования» для следующего плана.
+---