workflow-ai 1.0.68 → 1.2.1

package/src/skills/decompose-gaps/README.md

@@ -1,39 +0,0 @@
-# decompose-gaps
-
-Скил декомпозиции недочётов (gaps) из анализа отчёта в атомарные тикеты на доработку.
-
-## Структура
-
-```
-decompose-gaps/
-├── SKILL.md                        # Ядро: роль, маршрутизация, принципы
-├── README.md                       # Документация
-├── workflows/
-│   └── decompose.md                # Пошаговый алгоритм декомпозиции gaps
-├── knowledge/
-│   └── scope-validation.md         # 4 проверки scope, критерии валидности gap
-└── algorithms/
-    └── scope-check.md              # Формализованный алгоритм проверки scope
-```
-
-## Как это работает
-
-1. Получает на вход `gaps`, `report_id`, `plan_id` из context
-2. Загружает knowledge/scope-validation.md и algorithms/scope-check.md
-3. Запускает workflows/decompose.md
-4. Для каждого gap выполняет 4 проверки scope (источник → принадлежность → статус плана → workflow-управление)
-5. Gaps в scope → тикеты в `.workflow/tickets/backlog/`
-6. Gaps вне scope → секция «Новые требования (вне scope)»
-
-## Как расширять
-
-### Добавить новое правило валидации scope
-1. Добавь правило в `knowledge/scope-validation.md` после маркера `<!-- РАСШИРЕНИЕ -->`
-2. Добавь соответствующий шаг в `algorithms/scope-check.md` после маркера `<!-- РАСШИРЕНИЕ -->`
-
-### Добавить новый граничный случай
-1. Добавь строку в таблицу «Граничные случаи» в `algorithms/scope-check.md`
-
-### Добавить новый воркфлоу
-1. Создай файл в `workflows/`
-2. Добавь строку в таблицу маршрутизации в `SKILL.md`

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

@@ -1,110 +0,0 @@
-# Алгоритм: Проверка 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

@@ -1,65 +0,0 @@
-# Валидация 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

@@ -1,41 +0,0 @@
-## Декомпозиция недочётов
-
-### Обработка Gap: «Нужно исправить дефект маппинга полей»
-
-**Выполняю проверку scope по алгоритму `algorithms/scope-check.md`:**
-
-**Шаг 2a — Проверка exclusions из scope плана:**
-
-- `plan_exclusions = ["исправление дефектов"]`
-- Gap описывает: исправление дефекта маппинга полей
-- Сопоставление по смыслу: «исправить дефект маппинга» → подпадает под исключение «исправление дефектов»
-
-**Результат проверки:**
-```
-check_scope(gap) → {
-  in_scope: false,
-  reason: "Gap подпадает под исключение из scope плана: 'исправление дефектов'",
-  check_failed: "2a"
-}
-```
-
-Тикет **не создаётся**.
-
----
-
-### Новые требования (вне scope плана)
-
-- **«Нужно исправить дефект маппинга полей»** — причина: gap семантически совпадает с пунктом «Исключено из scope: исправление дефектов». Исправление дефектов явно выведено за рамки плана; создание fix-тикета нарушило бы границы scope. Требует отдельного решения на уровне планирования (новый план или явное снятие исключения).
-
----
-
-```
----RESULT---
-status: default
-created_tickets: (нет)
-rejected_gaps:
-  - gap: "Нужно исправить дефект маппинга полей"
-    reason: "Вне scope — подпадает под исключение плана: 'исправление дефектов'"
-    check_failed: "2a"
----RESULT---
-```

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

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

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

@@ -1,56 +0,0 @@
-Теперь у меня есть всё необходимое. Применяю алгоритм scope-check к переданному gap.
-
----
-
-## Проверка scope: Gap «Исправить дефект маппинга полей»
-
-### Применение алгоритма scope-check
-
-**Gap:** «Нужно исправить дефект маппинга полей»
-
-**Шаг 1 — Проверка источника:**
-Gap описывает конкретный дефект в выполненной работе → источник валидный (секция «Риски и проблемы» / «Выполненные задачи»). ✅
-
-**Шаг 2 — Принадлежность к плану:**
-Задача по маппингу полей присутствовала в плане. ✅
-
-**Шаг 2a — Проверка секции «Исключено из scope»:**
-План содержит явную запись:
-
-> «Исключено из scope: **исправление дефектов**»
-
-Gap «исправить дефект маппинга полей» непосредственно подпадает под данное исключение.
-
-**Результат проверки 2a:**
-```
-in_scope: false
-reason: "Gap подпадает под исключение из scope плана: 'исправление дефектов'"
-check_failed: "2a"
-```
-
-**Дальнейшие шаги алгоритма:** не выполняются — gap отклонён на шаге 2a.
-
----
-
-## Итог декомпозиции
-
-**Тикетов создано:** 0
-
-Тикет на gap **не создаётся**, поскольку план явно исключает исправление дефектов из своего scope. Создание fix-тикета нарушило бы принцип «Scope First».
-
----
-
-## Новые требования (вне scope)
-
-| Gap | Причина отклонения | Рекомендация |
-|-----|--------------------|--------------|
-| «Нужно исправить дефект маппинга полей» | Исключён из scope плана (секция «Исключено из scope: исправление дефектов»). Проверка 2a. | Зафиксировать как отдельную инициативу в новом плане или создать тикет вручную, если исправление дефекта требуется вне рамок текущего плана. |
-
----
-
-**---RESULT---**
-
-- Тикетов создано: **0**
-- Gaps в scope: **0**
-- Gaps вне scope (Новые требования): **1**
-  - «Нужно исправить дефект маппинга полей» — отклонён на проверке 2a: gap подпадает под исключение из scope плана («исправление дефектов»)

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

@@ -1,164 +0,0 @@
-{
-  "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-21T08:51:13.394Z"
-}

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

@@ -1,25 +0,0 @@
-**Анализ 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

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

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

@@ -1,22 +0,0 @@
-**Проверка scope gap «Нужно исправить дефект маппинга полей»**
-
-**Алгоритм scope‑check:**
-1. **Источник gap** – не указан (предполагаем, что из секции «Выполненные задачи» или «Риски и проблемы»).
-2. **Принадлежность к плану** – gap описывает исправление дефекта. В плане присутствует явное исключение: «Исключено из scope: исправление дефектов». → **gap подпадает под исключение** (check_failed: 2a).
-3. **Статус плана** – не указан (предполагаем `in_progress`).
-4. **Workflow‑управление** – отсутствует.
-
-**Решение:** Gap **не входит в scope** декомпозиции. Создание тикета не требуется.
-
----
-**Новые требования (вне scope)**
-
-1. **Исправление дефекта маппинга полей**  
-   *Причина отклонения:* gap подпадает под исключение из scope плана (секция «Исключено из scope: исправление дефектов»).  
-   *Рекомендация:* если дефект критичен, рассмотреть как отдельную инициативу вне текущего плана.
-
----
-**---RESULT---**
-
-**Созданные тикеты:** нет  
-**Новые требования:** 1 (см. выше)

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

@@ -1,25 +0,0 @@
-## Проверка scope: gap «Нужно исправить дефект маппинга полей»
-
-### Алгоритм scope-check
-
-**Шаг 1 — Источник gap:** gap передан как входной параметр, источник — раздел недочётов отчёта. Валидный источник. ✅
-
-**Шаг 2 — Принадлежность к плану:**
-
-**Шаг 2a — Проверка исключений из scope плана:**
-Секция «Исключено из scope» плана содержит: **«исправление дефектов»**.
-
-Gap «Нужно исправить дефект маппинга полей» по смыслу подпадает под исключение «исправление дефектов» — формулировка gap буквально описывает исправление дефекта.
-
-**Результат проверки 2a:** gap **исключён** из scope плана. Причина: `Gap подпадает под исключение из scope плана: «исправление дефектов»`.
-
-**in_scope = false**, check_failed = "2a"
-
-### Новые требования (вне scope плана)
-
-- **Исправить дефект маппинга полей** — причина: работа по исправлению дефектов явно исключена из scope плана (секция «Исключено из scope: исправление дефектов»). Данный gap является новым требованием, не входящим в текущий план. Для включения в работу требуется отдельная инициатива или новый план.
-
----RESULT---
-status: default
-created_tickets:
----RESULT---

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

@@ -1,5 +0,0 @@
-# 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

@@ -1,29 +0,0 @@
-## Проверка scope
-
-**Gap:** «Нужно исправить дефект маппинга полей»
-
-### Применение алгоритма scope-check
-
-**Шаг 1 — Источник:**Gap описывает дефект, требующий исправления.
-
-**Шаг 2 — Принадлежность к плану:**В плане есть секция «Исключено из scope: исправление дефектов». Gap формулируется как «исправить дефект маппинга полей» — это семантически совпадает с исключением «исправление дефектов».
-
-**Результат проверки 2a:** Gap подпадает под исключение из scope плана: «исправление дефектов».
-
-**`in_scope: false`** | `check_failed: 2a` | `reason: «Gap подпадает под исключение из scope плана: исправление дефектов»`
-
----
-
-### Новые требования (вне scope плана)
-
-- «Нужно исправить дефект маппинга полей» — причина: подпадает под исключение «исправление дефектов», указанное в секции «Исключено из scope» плана. Тикет не создаётся.
-
----
-
-```
----RESULT---
-status: default
-created_tickets: (нет)
-rejected_gaps: 1 (исключено из scope плана: исправление дефектов)
----RESULT---
-```