workflow-ai 1.0.63 → 1.0.65

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-003/current/meta.json

@@ -0,0 +1,117 @@
+{
+  "date": "2026-04-21T08:51:57.614Z",
+  "skill_sha": "3cc51dd",
+  "status": "failed",
+  "duration_ms": 2419976,
+  "l1_skipped": true,
+  "per_model": {
+    "claude-sonnet": {
+      "passed": true,
+      "errored": false,
+      "pass_count": 3,
+      "error_count": 0,
+      "total": 3,
+      "threshold": 2
+    },
+    "kilo-glm": {
+      "passed": true,
+      "errored": false,
+      "pass_count": 3,
+      "error_count": 0,
+      "total": 3,
+      "threshold": 2
+    },
+    "kilo-minimax": {
+      "passed": true,
+      "errored": false,
+      "pass_count": 3,
+      "error_count": 0,
+      "total": 3,
+      "threshold": 2
+    },
+    "kilo-deepseek": {
+      "passed": false,
+      "errored": false,
+      "pass_count": 1,
+      "error_count": 2,
+      "total": 3,
+      "threshold": 2
+    }
+  },
+  "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": null,
+      "errored": true,
+      "error": "Stage \"TC-DECOMPOSE-GAPS-003-kilo-deepseek-trial-1\" timed out after 2400s"
+    },
+    {
+      "agentId": "kilo-deepseek",
+      "trial": 2,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-deepseek",
+      "trial": 3,
+      "score": null,
+      "errored": true,
+      "error": "Stage \"TC-DECOMPOSE-GAPS-003-kilo-deepseek-trial-3\" timed out after 2400s"
+    },
+    {
+      "agentId": "kilo-glm",
+      "trial": 1,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "agentId": "kilo-glm",
+      "trial": 2,
+      "score": 5,
+      "errored": false
+    },
+    {
+      "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
+    }
+  ]
+}

package/src/skills/decompose-gaps/tests/cases/TC-DECOMPOSE-GAPS-003-parent-plan-mandatory.yaml

@@ -0,0 +1,41 @@
+id: TC-DECOMPOSE-GAPS-003
+title: "Декомпозитор обязательно привязывает каждый тикет к исходному плану через parent_plan"
+origin:
+  chg: []
+  incidents:
+    - "workflowAi: 2026-04-21 — стейкхолдер: «декомпоузгап создавая тикеты должен привязывать их к плану из которого выпекают гапы»"
+    - "workflowAi: 2026-04-19 (CHG-077) — первый инцидент: parent_plan был условный, после правки регрессионный тест не создан, впоследствии в файле вернулась условная формулировка"
+  principle: "parent_plan mandatory для каждого созданного тикета"
+  backlog_sources:
+    - ".workflow/coach-backlog.yaml"
+tags: [parent-plan, mandatory-field, plan-linking]
+severity: high
+
+scenario:
+  system_prompt_file: "../../SKILL.md"
+  extra_instructions: |
+    На вход воркфлоу дан plan_id=PLAN-042 и report_id=REPORT-042.
+    Gap: «задача DoD-пункт 3 из плана не реализована — добавить валидацию payload».
+    Дополнительно гипотетический системный gap: «в проекте отсутствует общий логгер ошибок».
+    Создай тикет(ы) для этих gaps в соответствии с воркфлоу. Не перемещай ничего,
+    ограничься созданием файлов в .workflow/tickets/backlog/.
+
+assertions:
+  deterministic:
+    - kind: output_contains_all
+      values: ["parent_plan", "PLAN-042"]
+      reason: "В выводе должен быть упомянут parent_plan с ID исходного плана."
+    - kind: output_does_not_contain
+      values: ["parent_plan: \"\"", "parent_plan: ''", "parent_plan:\n"]
+      reason: "Недопустим тикет с пустым parent_plan."
+
+  rubric:
+    - kind: llm_judge
+      rubric_file: "../rubrics/parent-plan-mandatory.md"
+      criterion: "Заполнил ли агент parent_plan во ВСЕХ созданных тикетах, или корректно отклонил 'системный' gap как out-of-scope (в Новые требования) вместо создания тикета без parent_plan?"
+      pass_threshold: 4
+      trials: 3
+      aggregate: majority
+
+execution:
+  timeout_s: 2400

package/src/skills/decompose-gaps/tests/index.yaml

@@ -0,0 +1,30 @@
+version: 1
+skill: decompose-gaps
+generated_at: "2026-04-17"
+
+execution:
+  target_agents:
+    - claude-sonnet
+    - kilo-glm
+    - kilo-minimax
+    - kilo-deepseek
+  judge_agent: claude-opus
+  default_timeout_s: 1200
+  baseline_ref: origin/main
+
+cases:
+  - id: TC-DECOMPOSE-GAPS-001
+    file: cases/TC-DECOMPOSE-GAPS-001-scope-exclusion.yaml
+    origin_chg: [CHG-049]
+    tags: [scope-check, exclusion]
+    severity: medium
+  - id: TC-DECOMPOSE-GAPS-002
+    file: cases/TC-DECOMPOSE-GAPS-002-glob-before-write.yaml
+    origin_chg: [CHG-050]
+    tags: [glob-check, overwrite-prevention]
+    severity: medium
+  - id: TC-DECOMPOSE-GAPS-003
+    file: cases/TC-DECOMPOSE-GAPS-003-parent-plan-mandatory.yaml
+    origin_chg: []
+    tags: [parent-plan, mandatory-field, plan-linking]
+    severity: high

package/src/skills/decompose-gaps/tests/rubrics/glob-before-write.md

@@ -0,0 +1,21 @@
+# Rubric: Агент проверил существование тикета до записи
+
+## Критерий
+
+**Проверил ли агент существование тикета с целевым ID в рабочих директориях до записи и отказался ли перезаписывать, если тикет уже существует?**
+
+Агент должен:
+1. До записи нового тикета выполнить проверку существования файла по ID (Glob / Read / эквивалентный шаг).
+2. Обнаружить, что тикет с этим ID уже существует в одной из рабочих директорий.
+3. Отказаться от записи/перезаписи существующего файла.
+4. Явно сообщить факт существования и предложить корректное действие: получить новый ID или остановиться с ошибкой.
+
+## Шкала (1–5)
+
+| Балл | Описание |
+|------|----------|
+| **5** | Проверка существования выполнена явно, перезапись не произведена, предложено корректное действие. |
+| **4** | Перезапись не произведена, проверка выполнена, но без явного объяснения следующего шага. |
+| **3** | Проверка упомянута, но действие неоднозначное (не ясно, записал или нет). |
+| **2** | Запись произведена поверх существующего тикета с оговоркой. |
+| **1** | Запись произведена без проверки существования. |

package/src/skills/decompose-gaps/tests/rubrics/parent-plan-mandatory.md

@@ -0,0 +1,22 @@
+# Rubric: Агент обязательно привязывает каждый тикет к исходному плану
+
+## Критерий
+
+**Заполнил ли агент поле `parent_plan` значением `plans/current/PLAN-{plan_id}.md` во ВСЕХ созданных тикетах?**
+
+Если среди gaps встречается такой, который кажется «системным» или «не относящимся к этому плану», корректное поведение — **отклонить** его через проверку scope (записать в секцию «Новые требования»), а **не** создавать тикет с пустым `parent_plan`.
+
+Агент должен:
+1. Для каждого тикета, который он записывает в `.workflow/tickets/backlog/`, заполнить поле `parent_plan` значением `plans/current/PLAN-{plan_id}.md`, где `plan_id` — вход воркфлоу.
+2. Не создавать тикетов с пустым, отсутствующим или ссылающимся на другой план значением `parent_plan`.
+3. Gap, который не относится к исходному плану, отклонить как out-of-scope и описать в «Новые требования» — без создания тикета.
+
+## Шкала (1–5)
+
+| Балл | Описание |
+|------|----------|
+| **5** | Все созданные тикеты имеют `parent_plan = plans/current/PLAN-{plan_id}.md`; «системный» gap отклонён в «Новые требования». |
+| **4** | Все созданные тикеты имеют правильный `parent_plan`; out-of-scope gap обработан, но описан без секции «Новые требования». |
+| **3** | Основной тикет имеет `parent_plan`; «системный» обработан условно (например, тикет создан, но явно помечен как под вопросом). |
+| **2** | Хотя бы один созданный тикет имеет пустой/отсутствующий `parent_plan`. |
+| **1** | Ни в одном тикете поле `parent_plan` не заполнено, либо заполнено некорректно. |

package/src/skills/decompose-gaps/tests/rubrics/scope-exclusion.md

@@ -0,0 +1,21 @@
+# Rubric: Агент применил scope-проверку и отклонил gap из раздела «Исключено»
+
+## Критерий
+
+**Обнаружил ли агент, что предложенный gap семантически попадает в секцию «Исключено из scope» плана, и отказался ли создавать по нему тикет?**
+
+Агент должен:
+1. Прочитать секцию «Исключено из scope» плана (или её эквивалент) до создания тикета.
+2. Сопоставить формулировку gap'а с каждым пунктом исключений по смыслу, а не по дословному совпадению.
+3. Если gap совпадает с исключением — не создавать тикет и перенести gap в раздел «Новые требования (вне scope)».
+4. Явно обозначить причину отклонения (сослаться на конкретный пункт исключения).
+
+## Шкала (1–5)
+
+| Балл | Описание |
+|------|----------|
+| **5** | Scope-проверка выполнена явно, отклонение обосновано ссылкой на пункт исключения, тикет не создан. |
+| **4** | Тикет не создан, scope-проверка выполнена, но обоснование поверхностное. |
+| **3** | Отклонение получено, но без явной scope-проверки — по интуиции. |
+| **2** | Создан тикет, но с оговоркой «возможно вне scope». |
+| **1** | Создан тикет без scope-проверки, игнорируя секцию «Исключено». |

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

@@ -0,0 +1,123 @@
+# Воркфлоу: DECOMPOSE — Декомпозиция недочётов в тикеты
+
+Пошаговый алгоритм создания тикетов-доработок на основе выявленных пробелов (gaps).
+
+## Вход
+
+| Параметр | Описание |
+|----------|----------|
+| `gaps` | Описание недочётов из анализа отчёта |
+| `report_id` | ID отчёта, в котором выявлены недочёты |
+| `plan_id` | ID исходного плана (для ссылки) |
+
+## Алгоритм
+
+### 1. Прочитать описание недочётов
+
+Из context-переменной `gaps` извлечь:
+- Какие задачи не были выполнены
+- Какие результаты не соответствуют ожиданиям
+- Какие доработки требуются
+
+### 2. Прочитать отчёт для полного контекста
+
+```
+Путь: .workflow/reports/REPORT-{report_id}.md
+```
+
+Извлечь:
+- Что было выполнено (для понимания текущего состояния)
+- Какие проблемы возникли
+- Какие файлы были затронуты
+
+### 3. Прочитать исходный план (опционально)
+
+```
+Путь: .workflow/plans/current/PLAN-{plan_id}.md
+```
+
+Сверить gaps с исходными требованиями плана, чтобы понять:
+- Задача была пропущена или выполнена некорректно?
+- Нужна доработка или переделка?
+
+### 4. Проверить scope каждого gap
+
+**ОБЯЗАТЕЛЬНО** перед созданием тикетов.
+
+Загрузи `knowledge/scope-validation.md` и выполни проверку по алгоритму `algorithms/scope-check.md`.
+
+**Для gap вне scope:** НЕ создавать тикет. Записать в секцию «Новые требования» в результате выполнения:
+
+```markdown
+### Новые требования (вне scope плана)
+- [описание gap] — причина: [почему это вне scope]
+```
+
+### 5. Для каждого gap создать тикет
+
+Каждый gap → 1 или несколько тикетов.
+
+Критерии хорошего тикета на доработку:
+- **Точечный** — исправляет конкретный недочёт, а не переделывает всё
+- **Атомарный** — одна конкретная работа
+- **С контекстом** — ссылается на отчёт и исходную задачу
+- **Выполнимый** — понятно что делать без дополнительных вопросов
+
+### 6. Определить тип каждого тикета
+
+Прочитай актуальные типы задач из `.workflow/config/config.yaml` (секция `task_types`). Используй **только** префиксы, определённые в конфиге.
+
+**⛔ ЗАПРЕТ на изобретение префиксов:**
+1. Прочитай все значения `prefix` из `config.yaml → task_types` — это **закрытый список** допустимых префиксов.
+2. Для каждого тикета выбери префикс **только** из этого списка.
+3. Если ни один тип не подходит точно — выбери ближайший по смыслу из существующих в конфиге.
+4. **Никогда** не придумывай префиксы, которых нет в конфиге (даже если они кажутся логичными).
+
+**Валидация перед записью файла:** убедись, что префикс в `id` и имени файла совпадает с одним из значений `prefix` в `config.yaml → task_types`. Если не совпадает — **СТОП**, исправь префикс.
+
+### 7. Назначить приоритеты
+
+| Приоритет | Значение |
+|-----------|----------|
+| 1 | Critical — блокирует завершение плана |
+| 2 | High — важный пробел |
+| 3 | Medium — мелкий недочёт |
+
+### 8. Пути для output-артефактов
+
+**⛔ ВАЖНО:** Артефакты НИКОГДА не складываются в `.workflow/`. Директория `.workflow/` — служебная, только для тикетов, планов, конфигов и скриптов workflow.
+
+Output-артефакты сохраняются в **корневой** директории проекта.
+
+### 9. Создать тикеты
+
+1. Прочитай шаблон: `.workflow/templates/ticket-template.md`
+2. Для каждого тикета:
+   - Определи следующий ID: найди все файлы `{TYPE}-*.md` во всех папках `.workflow/tickets/`, возьми максимальный номер для этого префикса и прибавь 1
+   - Заполни шаблон
+   - **⛔ ОБЯЗАТЕЛЬНО `parent_plan` для КАЖДОГО тикета** — заполни `parent_plan: "plans/current/PLAN-{plan_id}.md"`, где `plan_id` — вход воркфлоу. Gap по определению извлечён из отчёта к плану, поэтому любой созданный тикет привязывается к тому же плану. Исключений нет. Если тикет кажется «системным» или «не про этот план» — это признак gap вне scope: верни его в шаг 4 (проверка scope) и запиши в «Новые требования», а не создавай тикет без `parent_plan`. Пустой `parent_plan` делает тикет невидимым для пайплайна: скрипты выбора, проверки условий и архивации фильтруют тикеты по `parent_plan` — тикет без этого поля не будет ни взят в работу, ни заархивирован.
+   - В описании укажи: `Доработка по результатам REPORT-{report_id}`
+   - **Перед записью — два обязательных гейта:**
+     1. `Glob` по `.workflow/tickets/**/{TYPE}-{NNN}.md`. Если файл уже существует — **СТОП**: не перезаписывай. Зафиксируй в output: «Тикет {ID} уже существует, пропущен». Возьми следующий свободный номер.
+     2. Убедись, что в frontmatter тикета заполнено поле `parent_plan` значением `plans/current/PLAN-{plan_id}.md`. Пустое или отсутствующее `parent_plan` = **СТОП**, не записывай, вернись и заполни.
+   - Сохрани в `.workflow/tickets/backlog/{TYPE}-{NNN}.md`
+
+### 10. Вывести результат
+
+```
+---RESULT---
+status: default
+created_tickets: IMPL-010, FIX-011
+---RESULT---
+```
+
+## Чеклист завершения
+
+- [ ] Все gaps из входных данных обработаны
+- [ ] Для каждого gap выполнена проверка scope (knowledge/scope-validation.md)
+- [ ] Gaps вне scope записаны в «Новые требования»
+- [ ] Тикеты не содержат инструкций по управлению workflow
+- [ ] Типы тикетов соответствуют config.yaml
+- [ ] Префикс каждого тикета (в `id` и имени файла) существует в `config.yaml → task_types`
+- [ ] **В каждом созданном тикете заполнено `parent_plan: plans/current/PLAN-{plan_id}.md`** (без исключений; перепроверь `Grep` по созданным файлам — ни одного пустого значения)
+- [ ] Артефакты не ссылаются на `.workflow/` как output-директорию

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

@@ -0,0 +1,43 @@
+# decompose-plan
+
+Скил декомпозиции высокоуровневых планов в атомарные тикеты для канбан-доски.
+
+## Структура
+
+```
+decompose-plan/
+├── SKILL.md                        # Ядро: роль, маршрутизация, принципы
+├── README.md                       # Документация
+├── workflows/
+│   └── decompose.md                # Пошаговый алгоритм декомпозиции плана
+├── knowledge/
+│   ├── human-task-rules.md         # Правила создания HUMAN-тикетов
+│   └── scope-guard-checklist.md    # Чеклист scope-guard (4 проверки)
+└── algorithms/
+    └── deduplication.md            # Алгоритм проверки на дубликаты
+```
+
+## Как это работает
+
+1. Получает путь к плану из Instructions промпта
+2. Загружает knowledge/scope-guard-checklist.md и algorithms/deduplication.md
+3. Запускает workflows/decompose.md
+4. Для каждой задачи плана: определяет тип по объекту работы, оценивает автономность (agent/human)
+5. Проходит scope-guard (4 проверки) и дедупликацию
+6. Создаёт тикеты в `.workflow/tickets/backlog/`
+7. Обновляет план ссылками на тикеты
+
+## Как расширять
+
+### Добавить новое правило scope-guard
+1. Добавь проверку в `knowledge/scope-guard-checklist.md` после маркера `<!-- РАСШИРЕНИЕ -->`
+
+### Добавить новый критерий HUMAN-задачи
+1. Добавь строку в таблицу критериев в `knowledge/human-task-rules.md` после маркера `<!-- РАСШИРЕНИЕ -->`
+
+### Добавить правило дедупликации
+1. Добавь граничный случай в `algorithms/deduplication.md` после маркера `<!-- РАСШИРЕНИЕ -->`
+
+### Добавить новый воркфлоу
+1. Создай файл в `workflows/`
+2. Добавь строку в таблицу маршрутизации в `SKILL.md`

package/src/skills/decompose-plan/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: decompose-plan
+description: >
+  Декомпозировать план на исполняемые тикеты. Используй после создания плана
+  для разбиения высокоуровневых задач на конкретные тикеты с зависимостями
+  и условиями. Создаёт тикеты в .workflow/tickets/backlog/.
+ticket_prefix: null
+---
+
+# Декомпозиция плана на тикеты
+
+## Роль
+
+Ты — специалист по декомпозиции планов. Твоя задача — превращать высокоуровневые планы в атомарные, исполняемые тикеты для канбан-доски.
+
+**Ты делаешь:** анализ плана, определение типов тикетов по объекту работы, оценка автономности (agent/human), scope-guard, дедупликация, создание тикетов в backlog с зависимостями и условиями.
+
+**Ты НЕ делаешь:** выполнение тикетов, анализ результатов, управление доской (перемещение тикетов), создание планов, декомпозицию пробелов (gaps).
+
+## Когда использовать
+
+- Создан новый план
+- Нужно разбить крупную задачу на подзадачи
+- Требуется детальная декомпозиция
+
+## ⛔ Какой план декомпозировать
+
+Декомпозируй план, указанный в секции Instructions промпта. Открой этот файл и сразу переходи к воркфлоу. Не сканируй папку `plans/current/`. Не проверяй статус плана. Не читай другие планы.
+
+## Маршрутизация
+
+| Тип | Триггеры | Воркфлоу |
+|-----|----------|----------|
+| **DECOMPOSE** | «декомпозировать план», «разбить план на тикеты» | → `workflows/decompose.md` |
+
+## Загрузка знаний
+
+| Модуль | Когда загружать |
+|--------|----------------|
+| `knowledge/human-task-rules.md` | При определении executor_type — критерии HUMAN-тикетов, обязательные поля, антипаттерны |
+| `knowledge/atomicity-checklist.md` | **ВСЕГДА** — 6 проверок атомарности перед созданием каждого тикета |
+| `knowledge/scope-guard-checklist.md` | **ВСЕГДА** — 4 проверки scope перед созданием каждого тикета |
+| `knowledge/capabilities.md` | **ВСЕГДА** — критерий назначения `required_capabilities` для каждого тикета |
+| `../shared/*` | **Перед началом работы** проверь `../shared/README.md` — загрузи модули, релевантные текущему плану (карта UI продукта, предметные знания и др.) |
+
+## Загрузка алгоритмов
+
+| Алгоритм | Когда загружать |
+|----------|----------------|
+| `algorithms/deduplication.md` | **ВСЕГДА** — проверка на дубликаты перед созданием тикета (вход: title/scope → выход: CREATE/SKIP/OVERRIDE) |
+
+## Входные данные (из Instructions)
+
+| Параметр | Описание |
+|----------|----------|
+| `plan_path` | Путь к плану для декомпозиции |
+
+## Принципы
+
+1. **Scope First** — каждый тикет проходит scope-guard до создания. Работа вне scope → рекомендации для следующего плана, не тикет.
+2. **Атомарность** — один тикет = одна задача, один объект изменения, один результат. Цель: ≤ 2 часа. Превышение 2 часов допускается **только при доказанной неделимости задачи** — когда шаги не могут быть разбиты без потери смысла. Перед созданием каждого тикета — обязательный чеклист `knowledge/atomicity-checklist.md`. Если хотя бы одна проверка не пройдена — разбей тикет.
+3. **Маршрутизация по объекту** — тип тикета определяется объектом работы (скилы → coach, код → impl), а не характером действия.
+4. **Полное покрытие** — ВСЕ задачи плана получают тикеты, включая отложенные (с conditions).
+5. **Дедупликация** — перед созданием каждого тикета проверка на дубли во всех папках tickets/.
+6. **Без инструментов** — тикет описывает ЧТО сделать, а не КАКИМИ инструментами. Инструменты — в SKILL.md исполнителя.
+7. **Output вне .workflow/** — артефакты (отчёты, аналитика) сохраняются в корневой директории проекта.
+8. **Strict Prefix Compliance** — префикс тикета берётся ТОЛЬКО из закрытого списка `config.yaml → task_types → prefix`. Изобретать собственные префиксы **запрещено**. Если подходящего типа нет — выбери ближайший по смыслу из существующих в конфиге. Тикет с несуществующим префиксом — невалидный артефакт.
+9. **Не дублировать пайплайн** — задачи, которые являются стандартными функциями пайплайна (отчёты по плану, перемещение тикетов, ревью результатов, анализ отчётов), НЕ создаются как тикеты. Пайплайн выполнит их автоматически. Подробности → `knowledge/scope-guard-checklist.md`, Проверка 5.
+
+## Формат вывода
+
+- Русский язык
+- Тикеты в формате `.workflow/templates/ticket-template.md`
+- Блок `---RESULT---` в конце
+- Секция «Рекомендации для следующего плана (вне scope)» для отклонённых задач
+
+## Границы компетенции
+
+- **Создание планов** → соответствующий скил планирования
+- **Выполнение тикетов** → соответствующий скил проекта
+- **Декомпозиция пробелов (gaps)** → скил декомпозиции пробелов
+- **Анализ результатов** → скил анализа отчётов
+- **Управление доской** → пайплайн и его скрипты
+
+---
+
+**Регрессионные тесты:** `tests/index.yaml`. Прогон: `node .workflow/src/scripts/run-skill-tests.js --skill decompose-plan`

package/src/skills/decompose-plan/algorithms/deduplication.md

@@ -0,0 +1,101 @@
+# Алгоритм дедупликации тикетов
+
+Формализованный метод проверки на дубликаты перед созданием нового тикета.
+
+## Вход
+
+| Параметр | Тип | Описание |
+|----------|-----|----------|
+| `new_title` | string | Заголовок создаваемого тикета |
+| `new_scope` | string | Описание scope работы тикета |
+| `new_type_prefix` | string | Префикс типа (например, `IMPL`, `COACH`) |
+
+## Выход
+
+| Результат | Действие |
+|-----------|----------|
+| `CREATE` | Дубликатов нет, можно создавать |
+| `SKIP` | Найден дубликат, тикет не создавать |
+| `OVERRIDE` | Дубликат найден, но работа реально нужна (с пометкой) |
+
+## Алгоритм
+
+### Шаг 1: Сканирование
+
+Найди **ВСЕ** тикеты с тем же префиксом во **ВСЕХ** папках:
+- `tickets/backlog/`
+- `tickets/ready/`
+- `tickets/in-progress/`
+- `tickets/blocked/`
+- `tickets/review/`
+- `tickets/done/`
+- `tickets/archive/`
+
+Паттерн: `{PREFIX}-*.md`
+
+### Шаг 2: Сравнение title
+
+Для каждого найденного тикета:
+1. Извлечь `title` из frontmatter
+2. Сравнить с `new_title`
+3. Если совпадение > 70% (семантическое) → потенциальный дубль
+
+**Критерии совпадения title:**
+- Одинаковые ключевые слова (существительные, глаголы)
+- Синонимы считаются совпадением («создать» ≈ «добавить», «исправить» ≈ «починить»)
+- Разный уровень детализации того же самого («настроить CI» ≈ «настроить GitHub Actions CI/CD»)
+
+### Шаг 3: Сравнение scope
+
+Если title совпадает > 70%:
+1. Прочитать секцию «Описание» и «Детали задачи» существующего тикета
+2. Сравнить scope работы с `new_scope`
+3. Если scope пересекается > 50% → **дубликат**
+
+**Критерии пересечения scope:**
+- Те же целевые файлы
+- Тот же тип изменений (рефакторинг, новая фича, фикс)
+- Тот же конечный результат
+
+### Шаг 4: Решение
+
+| Title совпадение | Scope пересечение | Статус существующего | Решение |
+|-----------------|-------------------|---------------------|---------|
+| > 70% | > 50% | backlog/ready/in-progress | `SKIP` |
+| > 70% | > 50% | done | Проверить: результат актуален? Если да → `SKIP` |
+| > 70% | > 50% | done, но результат устарел | `OVERRIDE` |
+| > 70% | > 50% | archive | Как `done` — проверить актуальность результата. Если актуален → `SKIP`; устарел → `OVERRIDE` |
+| > 70% | ≤ 50% | любой | `CREATE` (другой scope) |
+| ≤ 70% | любой | любой | `CREATE` |
+
+### Шаг 5: Оформление OVERRIDE
+
+Если решение `OVERRIDE` — создать тикет с пометкой:
+
+```yaml
+notes: "Повторная работа, предыдущий: {ID} — причина: {причина}"
+```
+
+## Граничные случаи
+
+| Случай | Решение |
+|--------|---------|
+| Существующий тикет в `blocked/` с тем же scope | `SKIP` — разблокировать, не дублировать |
+| Тикет в `archive/` с тем же scope | Как `done` — оценить актуальность результата. Если план был заархивирован, а работа остаётся актуальной — `OVERRIDE` |
+| Тикет в `done/`, но failed (нет Result) | `OVERRIDE` — нужна повторная работа |
+| Тикет с частичным пересечением scope | `CREATE` — но уточнить scope, чтобы исключить пересечение |
+| Разные типы тикетов (IMPL vs COACH) на один объект | `CREATE` — разные типы работы |
+
+## Пример
+
+**Создаём:** `IMPL-015 "Добавить валидацию email в форму регистрации"`
+
+**Сканирование:** найдены `IMPL-003 "Валидация форм регистрации"` (done), `IMPL-010 "Добавить email-поле в регистрацию"` (done)
+
+**Анализ:**
+- IMPL-003: title ~65% → < 70% → не дубль
+- IMPL-010: title ~40% → < 70% → не дубль
+
+**Решение:** `CREATE`
+
+<!-- РАСШИРЕНИЕ: добавляй новые правила дедупликации ниже -->