workflow-ai 1.0.32 → 1.0.33

package/src/skills/coach/templates/new-skill.md

@@ -0,0 +1,137 @@
+# Шаблон: Структура нового скила
+
+При создании нового скила создай следующие файлы по этому шаблону.
+
+## SKILL.md
+
+```markdown
+---
+name: {skill-name}
+description: >
+  {2-3 предложения: кто агент, что делает, в каком контексте}
+ticket_prefix: {PREFIX}
+---
+
+# {Skill Name} — Agent Skill
+
+## Роль
+
+{Конкретное описание роли, контекст, ограничения}
+
+**Ты делаешь:** {перечисление}
+
+**Ты НЕ делаешь:** {перечисление с указанием куда направить}
+
+## Команда / Взаимодействие
+
+{RACI-матрица если применимо, или описание взаимодействий}
+
+## Маршрутизация тикетов {PREFIX}-*
+
+| Тип | Триггеры в тикете | Действие | Воркфлоу |
+|-----|-------------------|----------|----------|
+| **TYPE1** | «ключевые слова» | Описание | → `workflows/type1.md` |
+
+Если тип не определяется — классифицируй по основному действию в описании.
+
+## Загрузка знаний
+
+| Модуль | Когда загружать |
+|--------|----------------|
+| `knowledge/module.md` | Условие |
+
+## Загрузка алгоритмов
+
+| Алгоритм | Когда загружать |
+|----------|----------------|
+| `algorithms/algo.md` | Условие |
+
+## Шаблоны вывода
+
+| Шаблон | Когда использовать |
+|--------|-------------------|
+| `templates/template.md` | Условие |
+
+## Принципы
+
+1. **Принцип 1** — конкретное описание.
+{3-7 принципов}
+
+## Формат вывода
+
+- Язык
+- Стиль
+- Конкретность
+- Actionable
+
+## Границы компетенции
+
+- **Зона X** → куда направить
+```
+
+## Workflow файл
+
+```markdown
+# Воркфлоу: {TYPE} — {Название}
+
+{Одно предложение: что делает этот воркфлоу.}
+
+## Алгоритм выполнения
+
+### 1. {Глагол в повелительном наклонении}
+
+{Пояснение + таблица/список конкретных действий}
+{Ссылки на knowledge/ и algorithms/ где нужны данные}
+
+### 2. ...
+
+### N. Валидация / Чеклист
+
+- [ ] Критерий 1
+- [ ] Критерий 2
+```
+
+## Knowledge файл
+
+```markdown
+# {Название модуля знаний}
+
+{Краткое описание: что содержит и для чего.}
+
+## {Категория 1}
+
+| Параметр | Значение | Описание |
+|----------|----------|----------|
+| ... | ... | ... |
+
+## {Категория 2}
+
+...
+
+<!-- РАСШИРЕНИЕ: добавляй {что именно} ниже -->
+```
+
+## Algorithm файл
+
+```markdown
+# Алгоритм: {Название}
+
+{Одно предложение: для чего этот алгоритм.}
+
+## Вход
+
+{Что подаётся на вход.}
+
+## Алгоритм
+
+### 1. {Шаг}
+...
+
+## Выход
+
+{Что получаем.}
+
+## Пример
+
+{Конкретный пример применения.}
+```

package/src/skills/coach/workflows/analyze.md

@@ -0,0 +1,57 @@
+# Воркфлоу: ANALYZE — Анализ эффективности скила
+
+Анализ работы скила на основе завершённых планов, тикетов и отчётов.
+
+## Алгоритм выполнения
+
+### 1. Сбор данных
+
+Собери все завершённые артефакты, связанные со скилом:
+
+| Источник | Где искать | Что извлечь |
+|----------|-----------|-------------|
+| Завершённые тикеты | `.workflow/tickets/done/` | Результаты, время, качество |
+| Планы | `.workflow/plans/` | Цели, декомпозиция, отклонения |
+| Отчёты | `.workflow/reports/` | Метрики, выводы, проблемы |
+
+Фильтруй по `ticket_prefix` скила.
+
+### 2. Анализ паттернов
+
+**Паттерны успеха:**
+- Какие типы тикетов выполняются хорошо?
+- Какие воркфлоу дают стабильный качественный результат?
+- Какие knowledge-модули используются чаще всего?
+
+**Паттерны проблем:**
+- Какие тикеты завершаются с неполным результатом?
+- Где агент отклоняется от воркфлоу?
+- Какие знания отсутствуют и требуют дополнения?
+- Где агент «додумывает» вместо использования knowledge?
+
+### 3. Gap-анализ
+
+Применить → `algorithms/gap-analysis.md`
+
+Определи:
+- Типы задач, которые приходят, но не имеют воркфлоу
+- Знания, которые нужны, но отсутствуют в knowledge/
+- Решения, которые принимаются ad-hoc вместо формализованного алгоритма
+
+### 4. Метрики качества
+
+| Метрика | Как считать |
+|---------|------------|
+| Полнота результата | % тикетов с заполненными всеми секциями DoD |
+| Соответствие воркфлоу | % тикетов, где агент следовал шагам воркфлоу |
+| Использование knowledge | Частота обращений к knowledge-модулям |
+| Время выполнения | Среднее время по типам тикетов |
+
+### 5. Формирование выводов
+
+- Топ-3 сильные стороны скила
+- Топ-3 проблемы / узкие места
+- Топ-3 возможности для улучшения
+- Конкретные рекомендации с указанием файлов для изменения
+
+Результат оформи как часть отчёта → `templates/audit-report.md`

package/src/skills/coach/workflows/audit.md

@@ -0,0 +1,54 @@
+# Воркфлоу: AUDIT — Полный аудит скила
+
+Комплексная проверка существующего скила на полноту, качество и актуальность.
+
+## Алгоритм выполнения
+
+### 1. Инвентаризация
+
+Прочитай все файлы скила и составь карту:
+
+| Проверка | Что смотреть |
+|----------|-------------|
+| Структура | Все ли директории и обязательные файлы на месте? |
+| SKILL.md | Все ли секции заполнены? Актуальна ли маршрутизация? |
+| Workflows | Покрыты ли все типы тикетов? Есть ли пробелы? |
+| Knowledge | Актуальны ли знания? Нет ли устаревших данных? |
+| Algorithms | Формализованы ли методы? Есть ли конкретные пороги/формулы? |
+| Templates | Покрыты ли все типы вывода? Консистентны ли форматы? |
+| README | Описывает ли структуру и процесс расширения? |
+
+### 2. Оценка качества
+
+Применить → `algorithms/skill-scoring.md`
+
+Оцени по каждому критерию и выведи итоговый балл.
+
+### 3. Проверка антипаттернов
+
+Загрузи → `knowledge/common-antipatterns.md`
+
+Проверь каждый антипаттерн. Зафиксируй найденные.
+
+### 4. Анализ связности
+
+- Все ли ссылки из SKILL.md ведут на существующие файлы?
+- Все ли файлы в knowledge/ и algorithms/ упомянуты в SKILL.md?
+- Есть ли «осиротевшие» файлы без ссылок?
+- Консистентна ли терминология между файлами?
+
+### 5. Сравнение с эталоном
+
+Загрузи → `knowledge/skill-anatomy.md`
+
+Сравни скил с эталонной структурой. Какие компоненты отсутствуют или неполны?
+
+### 6. Формирование отчёта
+
+Используй шаблон → `templates/audit-report.md`
+
+Результат должен содержать:
+- Общий балл качества
+- Список найденных проблем с приоритетами
+- Конкретные рекомендации по каждой проблеме
+- План улучшений с приоритизацией

package/src/skills/coach/workflows/create.md

@@ -0,0 +1,66 @@
+# Воркфлоу: CREATE — Создание нового скила
+
+Создание полноценного модульного скила с нуля по запросу.
+
+## Алгоритм выполнения
+
+### 1. Сбор требований
+
+Из тикета извлеки:
+- **Роль** — кем является агент с этим скилом?
+- **Зона ответственности** — что делает и что НЕ делает?
+- **Типы тикетов** — какие задачи будет обрабатывать?
+- **Команда / RACI** — с кем взаимодействует (если применимо)?
+- **Домен знаний** — какая экспертиза нужна?
+
+Если информации недостаточно — сформулируй уточняющие вопросы.
+
+### 2. Исследование домена
+
+- Поищи в интернете лучшие практики и фреймворки для данной роли/домена
+- Изучи существующие скилы в `.workflow/src/skills/` для переиспользования паттернов
+- Определи, какие knowledge-модули можно переиспользовать из других скилов
+
+### 3. Проектирование структуры
+
+Используй эталон → `knowledge/skill-anatomy.md`
+
+Определи:
+
+| Компонент | Что создать |
+|-----------|-------------|
+| **SKILL.md** | Роль, RACI, маршрутизация, принципы, формат вывода |
+| **workflows/** | По одному файлу на каждый тип тикета |
+| **knowledge/** | Экспертные знания домена |
+| **algorithms/** | Формализованные методы принятия решений |
+| **templates/** | Шаблоны вывода для каждого типа результата |
+
+### 4. Создание скила
+
+Создай все файлы по шаблону → `templates/new-skill.md`
+
+**Порядок создания:**
+1. `SKILL.md` — ядро скила
+2. `workflows/` — пошаговые алгоритмы
+3. `knowledge/` — экспертные знания
+4. `algorithms/` — методы принятия решений
+5. `templates/` — шаблоны вывода
+6. `README.md` — документация
+
+### 5. Валидация
+
+Проверь скил по алгоритму → `algorithms/skill-scoring.md`
+
+Критерии:
+- [ ] SKILL.md содержит все обязательные секции
+- [ ] Каждый тип тикета имеет свой воркфлоу
+- [ ] Воркфлоу ссылаются на knowledge и algorithms
+- [ ] Шаблоны вывода покрывают все типы результатов
+- [ ] README.md описывает структуру и расширение
+- [ ] Нет дублирования с существующими скилами
+- [ ] Принципы конкретны и actionable
+
+### 6. Регистрация
+
+- Добавь скил в таблицу в `CLAUDE.md` и `QWEN.md`
+- Убедись что ticket_prefix уникален

package/src/skills/coach/workflows/improve.md

@@ -0,0 +1,56 @@
+# Воркфлоу: IMPROVE — Точечное улучшение скила
+
+Внесение конкретных улучшений в существующий скил на основе аудита, анализа или запроса.
+
+## Алгоритм выполнения
+
+### 1. Определи scope улучшения
+
+Из тикета извлеки:
+- Какой скил улучшаем?
+- Какая конкретная проблема или потребность?
+- Есть ли ссылка на аудит/анализ с рекомендациями?
+
+### 2. Изучи текущее состояние
+
+Прочитай файлы скила, которые затрагивает улучшение. Пойми текущую логику прежде чем менять.
+
+### 3. Определи тип улучшения
+
+| Тип | Действие |
+|-----|----------|
+| **Новый воркфлоу** | Создай `workflows/new-type.md`, добавь в маршрутизацию SKILL.md |
+| **Новые знания** | Создай/дополни файл в `knowledge/`, добавь в таблицу загрузки |
+| **Новый алгоритм** | Создай `algorithms/new-algo.md`, добавь в таблицу загрузки |
+| **Новый шаблон** | Создай `templates/new-template.md`, укажи в воркфлоу |
+| **Уточнение воркфлоу** | Добавь/исправь шаги в существующем воркфлоу |
+| **Обогащение knowledge** | Дополни существующий файл в knowledge/ после маркера расширения |
+| **Рефакторинг** | Реструктуризация без изменения поведения |
+
+### 4. Исследование (если нужно)
+
+Если улучшение требует новых знаний:
+- Поищи в интернете лучшие практики, фреймворки, методологии
+- Адаптируй найденное под формат knowledge/ или algorithms/
+- Укажи источник
+
+### 5. Внесение изменений
+
+- Следуй принципу минимальных изменений
+- Не ломай существующие ссылки и интеграции
+- Добавляй, а не переписывай (если не рефакторинг)
+- Обнови README.md если структура изменилась
+
+### 6. Валидация
+
+- Проверь все ссылки из SKILL.md
+- Убедись что новые файлы упомянуты в таблицах загрузки
+- Проверь консистентность терминологии
+
+### 7. Документирование
+
+Сформируй план улучшений → `templates/improvement-plan.md` с:
+- Что изменено и почему
+- Какие файлы затронуты
+- Ожидаемый эффект
+- Как проверить результат

package/src/skills/coach/workflows/research.md

@@ -0,0 +1,55 @@
+# Воркфлоу: RESEARCH — Исследование и поиск знаний
+
+Поиск лучших практик, фреймворков и подходов в интернете для обогащения скилов.
+
+## Алгоритм выполнения
+
+### 1. Определи цель исследования
+
+Из тикета извлеки:
+- Для какого скила ищем знания?
+- Какой домен / тема?
+- Какой тип знаний нужен: методология, метрики, бенчмарки, инструменты?
+
+### 2. Сформулируй поисковые запросы
+
+Составь 3–5 поисковых запросов на русском и английском:
+
+| Тип запроса | Пример |
+|-------------|--------|
+| Лучшие практики | «best practices [domain] framework 2025» |
+| Методологии | «[domain] methodology checklist» |
+| Метрики и бенчмарки | «[domain] KPI benchmarks SaaS» |
+| Инструменты | «[domain] tools stack comparison» |
+| Антипаттерны | «[domain] common mistakes pitfalls» |
+
+### 3. Поиск и фильтрация
+
+- Выполни поиск в интернете
+- Отфильтруй результаты по релевантности и актуальности (приоритет — свежие источники)
+- Извлеки ключевые идеи, фреймворки, чеклисты
+
+### 4. Адаптация под формат скила
+
+Преобразуй найденное в формат модулей скила:
+
+| Найденное | Куда добавить |
+|-----------|--------------|
+| Фреймворк принятия решений | `algorithms/` |
+| Набор метрик или бенчмарков | `knowledge/` |
+| Чеклист или пошаговый процесс | `workflows/` или `knowledge/` |
+| Шаблон документа | `templates/` |
+
+### 5. Интеграция
+
+- Создай или дополни соответствующие файлы в скиле
+- Добавь ссылки в таблицы загрузки SKILL.md
+- Укажи источник информации и дату получения
+
+### 6. Оформление результата
+
+Результат исследования:
+- Краткое резюме найденного
+- Список источников с кратким описанием каждого
+- Конкретные изменения, внесённые в скил
+- Рекомендации для дальнейшего исследования

package/src/skills/coach/workflows/review.md

@@ -0,0 +1,68 @@
+# Воркфлоу: REVIEW — Ревью скила
+
+Быстрое ревью структуры и качества скила с фокусом на конкретные аспекты.
+
+## Алгоритм выполнения
+
+### 1. Определи фокус ревью
+
+Из тикета извлеки: какой аспект проверить?
+
+| Фокус | Что проверять |
+|-------|--------------|
+| **Структура** | Полнота директорий и файлов, ссылочная целостность |
+| **Качество промптов** | Чёткость инструкций, отсутствие двусмысленности |
+| **Покрытие** | Все ли сценарии обработаны, нет ли пробелов |
+| **Консистентность** | Единообразие терминов, форматов, стиля |
+| **Актуальность** | Не устарели ли знания, бенчмарки, инструменты |
+
+Если фокус не указан — проведи ревью по всем аспектам.
+
+### 2. Чтение и анализ
+
+Прочитай все файлы скила. Для каждого файла проверь:
+
+**SKILL.md:**
+- [ ] Роль описана конкретно (не абстрактно)
+- [ ] RACI / зоны ответственности чёткие
+- [ ] Маршрутизация покрывает все типы тикетов
+- [ ] Таблицы загрузки knowledge и algorithms полны
+- [ ] Принципы actionable, а не декларативные
+- [ ] Формат вывода специфицирован
+
+**Workflows:**
+- [ ] Каждый шаг — конкретное действие (не «подумай»)
+- [ ] Есть ссылки на knowledge/algorithms где нужны данные
+- [ ] Есть критерии завершения / чеклисты
+- [ ] Нет дублирования между воркфлоу
+
+**Knowledge:**
+- [ ] Данные структурированы (таблицы, списки)
+- [ ] Есть маркеры расширения `<!-- РАСШИРЕНИЕ: ... -->`
+- [ ] Нет субъективных оценок без обоснования
+- [ ] Источники указаны где применимо
+
+**Algorithms:**
+- [ ] Алгоритм формализован (шаги, пороги, формулы)
+- [ ] Входные и выходные данные определены
+- [ ] Есть примеры применения
+
+**Templates:**
+- [ ] Все поля обязательны или помечены как опциональные
+- [ ] Формат единообразен с другими шаблонами
+- [ ] Есть placeholder-подсказки
+
+### 3. Формирование замечаний
+
+Для каждого замечания укажи:
+- **Файл и секция** — где проблема
+- **Приоритет** — CRITICAL / HIGH / MEDIUM / LOW
+- **Проблема** — что не так
+- **Рекомендация** — как исправить
+
+### 4. Итоговая оценка
+
+- Общая оценка: READY / NEEDS_WORK / MAJOR_ISSUES
+- Количество замечаний по приоритетам
+- Топ-3 вещи, которые сделаны хорошо
+- Топ-3 вещи, которые нужно исправить

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

@@ -51,6 +51,49 @@ description: Декомпозировать недочёты (gaps) из ана
 - Задача была пропущена или выполнена некорректно?
 - Нужна доработка или переделка?
 
+### 3.5. Проверить scope каждого gap
+
+**ОБЯЗАТЕЛЬНО** перед созданием тикетов выполнить три проверки:
+
+#### Проверка 1: Источник gap
+
+Gap — это исключительно то, что **не выполнено или выполнено некорректно** из явного списка задач плана. Источник gap — только эти секции отчёта:
+- «Выполненные задачи» — задачи со статусом failed/skipped где DoD не выполнен
+- «Заблокированные задачи» — задачи, заблокированные по техническим причинам (не по внешним зависимостям)
+- «Риски и проблемы» — только конкретные сбои в выполненных задачах
+
+**НЕ являются источником gaps следующие секции отчёта:**
+- «Рекомендации для Architect» — это советы, не пробелы
+- «План на следующий период» — это новые инициативы, не пробелы
+- «Потенциальные риски» — это гипотезы, не пробелы
+- Любые упоминания будущих задач (GML-005, стратегия, следующий этап и т.п.)
+
+#### Проверка 2: Принадлежность к scope исходного плана
+
+**Gap в scope (создавать тикет):**
+- Задача была в исходном плане, но не выполнена или выполнена некорректно
+- Доработка существующего результата, который не соответствует DoD плана
+- Исправление ошибки в уже сделанной работе по плану
+
+**Gap вне scope (НЕ создавать тикет):**
+- Новая работа, которой не было в исходном плане
+- Расширение scope за рамки первоначальных требований
+- Задачи, созданные другими тикетами как часть их DoD (например, quick win тикеты созданные GML-004 — это deliverables, не gaps)
+- Задачи из секций «Рекомендации», «План на следующий период», «Следующие шаги»
+
+#### Проверка 3: Статус плана
+
+Если план завершён (`status: completed`) или все его ключевые задачи выполнены — decompose-gaps **не создаёт тикеты**. Gaps в завершённом плане = новые инициативы для следующего плана.
+
+**Для gap вне scope:** НЕ создавать тикет. Вместо этого записать в секцию «Новые требования» в результате выполнения:
+
+```markdown
+### Новые требования (вне scope плана)
+- [описание gap] — причина: [почему это вне scope]
+```
+
+Эти требования будут рассмотрены при создании следующего плана.
+
 ### 4. Для каждого gap создать тикет
 
 Каждый gap → 1 или несколько тикетов.