workflow-ai 1.0.41 → 1.0.42

package/src/skills/coach/algorithms/improvement-prioritization.md

@@ -1,62 +0,0 @@
-# Алгоритм: Приоритизация улучшений
-
-Метод определения порядка внесения улучшений в скил.
-
-## Вход
-
-Список улучшений из аудита, анализа или gap-анализа — каждое с описанием проблемы.
-
-## Алгоритм
-
-### 1. Оцени каждое улучшение по 3 критериям (1–5)
-
-| Критерий | 1 | 3 | 5 |
-|----------|---|---|---|
-| **Impact (I)** — влияние на качество работы скила | Косметическое | Заметное улучшение | Критично для работоспособности |
-| **Confidence (C)** — уверенность что улучшение поможет | Гипотеза | Обоснованное предположение | Очевидно из данных |
-| **Effort (E)** — трудозатраты на реализацию | Масштабное изменение | Средний объём | Быстрая правка |
-
-### 2. Рассчитай score
-
-```
-Score = (I × C × E) / 25
-```
-
-Нормализованный диапазон: 0.004 – 5.0
-
-### 3. Классифицируй по приоритету
-
-| Score | Приоритет | Действие |
-|-------|-----------|----------|
-| > 3.0 | **CRITICAL** | Делать немедленно |
-| 1.5 – 3.0 | **HIGH** | Делать в текущей итерации |
-| 0.5 – 1.5 | **MEDIUM** | Запланировать |
-| < 0.5 | **LOW** | Backlog |
-
-### 4. Сгруппируй по типу изменения
-
-Улучшения одного типа (например, все правки в knowledge/) удобнее делать вместе:
-
-| Группа | Типичные улучшения |
-|--------|-------------------|
-| **Структура** | Создание директорий, файлов, README |
-| **Контент** | Наполнение knowledge, algorithms |
-| **Ссылки** | Добавление в таблицы загрузки, исправление ссылок |
-| **Рефакторинг** | Переструктуризация воркфлоу, устранение дублирования |
-
-## Выход
-
-Приоритизированный план:
-
-| # | Улучшение | I | C | E | Score | Приоритет | Группа |
-|---|-----------|---|---|---|-------|-----------|--------|
-| 1 | ... | 5 | 5 | 4 | 4.0 | CRITICAL | Контент |
-| 2 | ... | 4 | 3 | 5 | 2.4 | HIGH | Ссылки |
-
-## Пример
-
-Улучшение: «Добавить knowledge/competitors.md в GML-скил»
-- Impact: 4 (часто нужен при стратегических решениях)
-- Confidence: 4 (видно из тикетов, где агент додумывал)
-- Effort: 5 (создать один файл)
-- Score: (4 × 4 × 5) / 25 = 3.2 → **CRITICAL**

package/src/skills/coach/algorithms/skill-scoring.md

@@ -1,79 +0,0 @@
-# Алгоритм: Оценка качества скила
-
-## Вход
-
-Путь к директории скила (`.workflow/src/skills/<name>/`).
-
-## Алгоритм
-
-Оцени скил по 5 категориям. Каждая категория — от 0 до 20 баллов. Итого максимум — 100.
-
-### 1. Структура (0–20)
-
-| Критерий | Баллы |
-|----------|-------|
-| SKILL.md существует и содержит frontmatter | 4 |
-| README.md существует и описывает структуру | 4 |
-| workflows/ содержит файлы для каждого типа из маршрутизации | 4 |
-| knowledge/ содержит минимум 2 модуля | 4 |
-| algorithms/ содержит минимум 1 алгоритм | 2 |
-| templates/ содержит минимум 1 шаблон | 2 |
-
-### 2. Полнота SKILL.md (0–20)
-
-| Критерий | Баллы |
-|----------|-------|
-| Роль описана конкретно (делает / не делает) | 4 |
-| Маршрутизация полная (все типы → воркфлоу) | 4 |
-| Таблица загрузки knowledge заполнена | 3 |
-| Таблица загрузки algorithms заполнена | 3 |
-| Принципы конкретны и actionable (3–7 штук) | 3 |
-| Формат вывода специфицирован | 2 |
-| Границы компетенции определены | 1 |
-
-### 3. Качество воркфлоу (0–20)
-
-| Критерий | Баллы |
-|----------|-------|
-| Шаги пронумерованы и конкретны (глаголы) | 5 |
-| Ссылки на knowledge/algorithms где нужны данные | 5 |
-| Чеклисты / критерии завершения | 5 |
-| Нет дублирования между воркфлоу | 5 |
-
-### 4. Качество знаний и алгоритмов (0–20)
-
-| Критерий | Баллы |
-|----------|-------|
-| Knowledge структурирован (таблицы, категории) | 5 |
-| Маркеры расширения присутствуют | 3 |
-| Algorithms формализованы (формулы, пороги) | 5 |
-| Есть примеры применения | 4 |
-| Вход/выход алгоритмов определён | 3 |
-
-### 5. Связность и консистентность (0–20)
-
-| Критерий | Баллы |
-|----------|-------|
-| Все ссылки из SKILL.md ведут на существующие файлы | 5 |
-| Все файлы knowledge/ упомянуты в таблице загрузки | 5 |
-| Все файлы algorithms/ упомянуты в таблице загрузки | 5 |
-| Терминология единообразна | 5 |
-
-## Выход
-
-| Балл | Оценка | Рекомендация |
-|------|--------|-------------|
-| 80–100 | **EXCELLENT** | Скил готов к работе, мелкие улучшения |
-| 60–79 | **GOOD** | Работоспособен, но есть существенные пробелы |
-| 40–59 | **NEEDS_WORK** | Требуется серьёзная доработка |
-| 0–39 | **POOR** | Фундаментальные проблемы, рассмотреть пересоздание |
-
-## Пример
-
-Скил `growth-marketing-lead`:
-- Структура: 20/20 (все компоненты на месте)
-- Полнота SKILL.md: 20/20 (все секции)
-- Качество воркфлоу: 18/20 (минус 2 за неполные чеклисты)
-- Качество знаний: 17/20 (минус 3 за отсутствие примеров в algorithms)
-- Связность: 20/20 (всё связано)
-- **Итого: 95/100 — EXCELLENT**

package/src/skills/coach/knowledge/backlog-management.md

@@ -1,71 +0,0 @@
-# Управление бэклогом коуча
-
-Коуч ведёт бэклог своей работы в файле `.workflow/coach-backlog.yaml`. Этот файл — единственный источник правды о том, что уже было проанализировано и какие правки внесены.
-
-## Структура бэклога
-
-```yaml
-# .workflow/coach-backlog.yaml
-version: 1
-last_updated: "2026-03-20"
-
-# Проанализированные тикеты
-analyzed_tickets:
-  - ticket_id: "GML-001"
-    ticket_file: "tickets/done/GML-001.md"
-    analyzed_date: "2026-03-20"
-    coach_ticket: "COACH-005"  # тикет коуча, в рамках которого проведён анализ
-    findings_count: 3
-    summary: "Недостаток knowledge по TAM/SAM/SOM, нечёткий воркфлоу"
-
-# Внесённые правки в скилы
-applied_changes:
-  - change_id: "CHG-001"
-    date: "2026-03-20"
-    coach_ticket: "COACH-005"
-    target_skill: "growth-marketing-lead"
-    changed_files:
-      - "src/skills/growth-marketing-lead/knowledge/market-sizing.md"
-      - "src/skills/growth-marketing-lead/workflows/analyze.md"
-    change_type: "improve"  # improve | fix | add | refactor
-    description: "Добавлен knowledge-модуль market-sizing, уточнён воркфлоу анализа"
-    based_on_tickets:
-      - "GML-001"
-      - "GML-003"
-
-# Скилы, прошедшие аудит
-audited_skills:
-  - skill_name: "growth-marketing-lead"
-    last_audit_date: "2026-03-20"
-    coach_ticket: "COACH-004"
-    score: 72
-    status: "NEEDS_WORK"
-```
-
-## Правила работы с бэклогом
-
-### Перед началом анализа (ОБЯЗАТЕЛЬНО)
-
-1. Прочитай `.workflow/coach-backlog.yaml`
-2. Проверь, какие тикеты уже проанализированы (`analyzed_tickets`)
-3. **Пропусти** тикеты, которые уже есть в бэклоге
-4. Проверь, какие правки уже внесены (`applied_changes`) в целевой скил
-5. **Учитывай** уже внесённые правки — не предлагай то, что уже исправлено
-
-### После завершения анализа (ОБЯЗАТЕЛЬНО)
-
-1. Добавь каждый проанализированный тикет в `analyzed_tickets`
-2. Добавь каждую внесённую правку в `applied_changes`
-3. Если был аудит — обнови `audited_skills`
-4. Обнови `last_updated`
-
-### Генерация ID
-
-- `change_id`: `CHG-{порядковый номер, 3 цифры}` — следующий после максимального в бэклоге
-
-## Антипаттерны
-
-- **Повторный анализ** — анализировать тикет, который уже в бэклоге
-- **Дублирование правок** — предлагать изменение, которое уже в `applied_changes`
-- **Забыть записать** — внести правку, но не добавить в бэклог
-- **Пустой бэклог** — если файла нет, создай его с пустыми секциями

package/src/skills/coach/knowledge/common-antipatterns.md

@@ -1,56 +0,0 @@
-# Типичные антипаттерны в скилах
-
-Чеклист проблем, которые нужно искать при аудите и ревью скилов.
-
-## Структурные антипаттерны
-
-| # | Антипаттерн | Признаки | Как исправить |
-|---|------------|----------|---------------|
-| S1 | **Осиротевшие файлы** | Файл в knowledge/ или algorithms/ не упомянут в SKILL.md | Добавить в таблицу загрузки или удалить |
-| S2 | **Битые ссылки** | Ссылка в воркфлоу ведёт на несуществующий файл | Создать файл или исправить ссылку |
-| S3 | **Пустые директории** | knowledge/ или algorithms/ существует, но пуст | Заполнить или убрать из структуры |
-| S4 | **Монолитный SKILL.md** | Вся логика в SKILL.md, workflows/ пуст | Декомпозировать в отдельные воркфлоу |
-| S5 | **Отсутствие README** | Нет README.md или он не описывает расширение | Создать по эталону |
-
-## Антипаттерны содержания
-
-| # | Антипаттерн | Признаки | Как исправить |
-|---|------------|----------|---------------|
-| C1 | **Абстрактная роль** | «Ты умный помощник» вместо конкретной роли | Описать роль, зону ответственности, границы |
-| C2 | **Размытые принципы** | «Будь эффективным» вместо actionable принципов | Переписать: что делать, когда, как измерить |
-| C3 | **Воркфлоу-декларация** | «Проанализируй данные» без шагов и критериев | Добавить конкретные шаги, чеклисты, пороги |
-| C4 | **Knowledge без структуры** | Сплошной текст без таблиц, категорий, маркеров | Структурировать: таблицы, заголовки, маркеры расширения |
-| C5 | **Algorithm без формул** | «Оцени по шкале» без критериев и весов | Добавить числовые критерии, формулы, пороги |
-| C6 | **Template без подсказок** | Пустые поля без placeholder-текста | Добавить примеры и подсказки в каждое поле |
-
-## Антипаттерны поведения
-
-| # | Антипаттерн | Признаки | Как исправить |
-|---|------------|----------|---------------|
-| B1 | **Выход за границы** | Скил берётся за задачи из чужой зоны | Уточнить «Ты НЕ делаешь» и границы компетенции |
-| B2 | **Дублирование знаний** | Одни и те же данные в нескольких knowledge-файлах | Вынести в один модуль, ссылаться из других |
-| B3 | **Нет маршрута для типа** | Тикет приходит, но нет подходящего воркфлоу | Добавить воркфлоу или расширить маршрутизацию |
-| B4 | **Игнорирование knowledge** | Воркфлоу не ссылается на доступные знания | Добавить ссылки → `knowledge/...` в нужных шагах |
-| B5 | **Безальтернативность** | Нет fallback для неопределённого типа тикета | Добавить правило «Если тип не определяется — ...» |
-
-## Антипаттерны масштабирования
-
-| # | Антипаттерн | Признаки | Как исправить |
-|---|------------|----------|---------------|
-| M1 | **Нет маркеров расширения** | Knowledge-файлы без `<!-- РАСШИРЕНИЕ: ... -->` | Добавить маркеры в конец каждого файла |
-| M2 | **Жёсткая привязка** | Хардкод специфичных значений вместо параметров | Параметризовать или вынести в конфиг |
-| M3 | **Нет инструкций по расширению** | README не объясняет как добавлять новые компоненты | Добавить секцию «Как расширять» |
-
-## Антипаттерны scope management
-
-| # | Антипаттерн | Признаки | Как исправить |
-|---|------------|----------|---------------|
-| SC1 | **Scope creep через DoD** | DoD тикета содержит «создать тикеты для команды» — execute-task создаёт тикеты в backlog, минуя scope-проверку плана | Запретить execute-task создавать тикеты; DoD с «создать тикеты» → фиксировать как рекомендации в результате |
-| SC2 | **Декомпозиция без scope-guard** | decompose-plan создаёт тикеты на follow-up работу, которая явно исключена из scope плана | Добавить обязательную проверку «Включено/Исключено из scope» перед созданием каждого тикета |
-| SC3 | **Тикеты-сироты без parent_plan** | Тикеты созданы с `parent_plan: ""` — невозможно отследить откуда они появились и к какому scope относятся | Обязательно заполнять parent_plan при создании; при аудите — найти и привязать или удалить |
-| SC4 | **Каскадная декомпозиция** | Тикет при выполнении создаёт дочерние тикеты, которые в свою очередь создают ещё — неконтролируемый рост backlog | Только decompose-plan и decompose-gaps имеют право создавать тикеты; execute-task фиксирует рекомендации |
-| SC5 | **Горизонт за пределами плана** | Тикеты с `date_after` на месяцы вперёд (май-июнь) при плане на 1–2 недели | Проверять горизонт тикета vs горизонт плана; future-задачи → рекомендации, не тикеты |
-| SC6 | **Каскад execute→plan→decompose** | execute-task создаёт файл плана в `plans/current/` → pipeline обнаруживает недекомпозированный план → автоматически вызывает decompose-plan → backlog разрастается без контроля человека | 3 уровня защиты: (1) execute-task запрещено создавать планы; (2) check-plan-decomposed.js проверяет `status: approved`; (3) decompose-plan проверяет статус плана перед началом работы |
-| SC7 | **Автодекомпозиция без human-approval** | Pipeline автоматически декомпозирует любой план в `plans/current/`, включая черновики и планы, созданные другими тикетами | Планы декомпозируются только со статусом `approved`. Человек явно меняет `status: draft` → `status: approved` перед декомпозицией |
-
-<!-- РАСШИРЕНИЕ: добавляй новые антипаттерны ниже -->

package/src/skills/coach/knowledge/prompt-engineering.md

@@ -1,86 +0,0 @@
-# Prompt Engineering для скилов
-
-Принципы написания эффективных инструкций в SKILL.md и воркфлоу.
-
-## Принципы формулировки роли
-
-| Принцип | Плохо | Хорошо |
-|---------|-------|--------|
-| Конкретность | «Ты — полезный помощник» | «Ты — Growth Marketing Lead в команде из 5 человек» |
-| Границы | Только «Ты делаешь» | «Ты делаешь» + «Ты НЕ делаешь» |
-| Контекст | Без контекста команды | С RACI-матрицей и связками ролей |
-
-## Принципы написания воркфлоу
-
-### Структура шага
-
-```markdown
-### N. Название (глагол в повелительном наклонении)
-
-Краткое пояснение зачем этот шаг.
-
-| Что сделать | Где взять данные |
-|------------|-----------------|
-| Конкретное действие 1 | → `knowledge/module.md` |
-| Конкретное действие 2 | Из тикета: поле X |
-```
-
-### Правила
-
-1. **Глагол в начале** — «Определи», «Собери», «Проверь», не «Нужно определить»
-2. **Ссылки на знания** — каждый шаг, требующий данных, должен ссылаться на источник
-3. **Чеклисты** — завершай воркфлоу проверочным списком
-4. **Условия** — если есть развилки, опиши оба пути явно
-5. **Нет «подумай»** — заменяй на конкретный метод или алгоритм
-
-## Принципы написания knowledge
-
-### Структура
-
-- Заголовки для категорий
-- Таблицы для структурированных данных
-- Формулы в блоках кода
-- Маркер расширения в конце
-
-### Правила
-
-1. **Факты, не мнения** — «CAC < LTV/3 считается здоровым» вместо «CAC должен быть маленьким»
-2. **Источники** — указывай откуда данные
-3. **Пороги числами** — «> 3x» вместо «значительно выше»
-4. **Дата актуальности** — когда данные были получены
-
-## Принципы написания algorithms
-
-### Структура
-
-```markdown
-## Вход
-Что подаётся на вход алгоритму.
-
-## Алгоритм
-Пронумерованные шаги с формулами и порогами.
-
-## Выход
-Что получаем на выходе.
-
-## Пример
-Конкретный пример применения.
-```
-
-### Правила
-
-1. **Детерминированность** — одинаковый вход → одинаковый выход
-2. **Числовые пороги** — «если score > 7» вместо «если оценка высокая»
-3. **Граничные случаи** — что делать если данных нет или они неполны
-
-## Антипаттерны промптинга
-
-| Антипаттерн | Проблема | Решение |
-|-------------|----------|---------|
-| «Будь креативным» | Размывает поведение | Укажи конкретный метод |
-| «Учти все факторы» | Нет приоритета | Перечисли факторы и их веса |
-| «При необходимости» | Неоднозначность триггера | Укажи конкретное условие |
-| Длинные абзацы | Теряется структура | Таблицы, списки, чеклисты |
-| Дублирование | Рассинхрон при обновлении | Один источник правды + ссылки |
-
-<!-- РАСШИРЕНИЕ: добавляй новые принципы prompt engineering ниже -->

package/src/skills/coach/knowledge/skill-anatomy.md

@@ -1,71 +0,0 @@
-# Эталонная анатомия скила
-
-Справочник по структуре и содержанию идеального скила workflow-ai.
-
-## Обязательная структура директорий
-
-```
-skill-name/
-├── SKILL.md              # Ядро: роль, маршрутизация, принципы
-├── README.md             # Документация для людей
-├── workflows/            # Пошаговые алгоритмы по типам тикетов
-├── knowledge/            # Экспертные знания домена
-├── algorithms/           # Формализованные методы принятия решений
-└── templates/            # Шаблоны вывода
-```
-
-## SKILL.md — обязательные секции
-
-| Секция | Описание | Критерий качества |
-|--------|----------|-------------------|
-| **Frontmatter** | name, description, ticket_prefix | description — 2-3 предложения, prefix уникален |
-| **Роль** | Кто агент, что делает / не делает | Конкретно, без абстракций |
-| **Команда / RACI** | С кем взаимодействует (если есть) | Роли и зоны чёткие |
-| **Маршрутизация** | Таблица: тип → триггеры → воркфлоу | Каждый тип → свой файл |
-| **Загрузка знаний** | Таблица: модуль → когда загружать | Все файлы knowledge/ перечислены |
-| **Загрузка алгоритмов** | Таблица: алгоритм → когда загружать | Все файлы algorithms/ перечислены |
-| **Шаблоны вывода** | Таблица: шаблон → когда использовать | Все файлы templates/ перечислены |
-| **Принципы** | 3-7 принципов работы | Actionable, не декларативные |
-| **Формат вывода** | Язык, стиль, конкретность | Специфичен для домена |
-| **Границы компетенции** | Что НЕ входит в зону → куда направить | Перечислены все смежные зоны |
-
-## Workflows — требования к качеству
-
-- Каждый тип тикета из маршрутизации → свой файл
-- Шаги пронумерованы, каждый шаг — конкретное действие
-- Ссылки на knowledge/ и algorithms/ там, где нужны данные или метод
-- Чеклисты или критерии завершения
-- Типичные паттерны / примеры где уместно
-
-## Knowledge — требования к качеству
-
-- Данные структурированы: таблицы, списки, категории
-- Маркер расширения: `<!-- РАСШИРЕНИЕ: добавляй ... ниже -->`
-- Нет субъективных оценок без данных или источников
-- Формулы и пороги вынесены явно
-- Актуальность: дата последнего обновления или источник
-
-## Algorithms — требования к качеству
-
-- Чёткий вход (что подаём) и выход (что получаем)
-- Пошаговый алгоритм с конкретными действиями
-- Пороги, формулы, весовые коэффициенты — числами
-- Пример применения
-- Граничные случаи / исключения
-
-## Templates — требования к качеству
-
-- Все поля обязательны или помечены `(опционально)`
-- Placeholder-подсказки в каждом поле
-- Формат markdown, единообразный стиль
-- Покрытие: для каждого типа результата — свой шаблон
-
-## README.md — обязательные секции
-
-- Название и краткое описание
-- Структура (дерево файлов)
-- Как это работает (flow)
-- Как расширять (по каждому типу компонента)
-- Примеры расширений
-
-<!-- РАСШИРЕНИЕ: добавляй новые требования к анатомии скила ниже -->

package/src/skills/coach/templates/audit-report.md

@@ -1,54 +0,0 @@
-# Шаблон: Отчёт аудита скила
-
-```markdown
-# Аудит скила: {skill-name}
-
-**Дата:** {YYYY-MM-DD}
-**Тикет:** {COACH-NNN}
-
-## Общая оценка
-
-| Категория | Балл | Макс |
-|-----------|------|------|
-| Структура | {N} | 20 |
-| Полнота SKILL.md | {N} | 20 |
-| Качество воркфлоу | {N} | 20 |
-| Качество знаний и алгоритмов | {N} | 20 |
-| Связность и консистентность | {N} | 20 |
-| **Итого** | **{N}** | **100** |
-
-**Оценка:** {EXCELLENT / GOOD / NEEDS_WORK / POOR}
-
-## Найденные проблемы
-
-| # | Приоритет | Файл | Проблема | Рекомендация |
-|---|-----------|------|----------|-------------|
-| 1 | CRITICAL | {path} | {описание} | {что сделать} |
-| 2 | HIGH | {path} | {описание} | {что сделать} |
-| ... | ... | ... | ... | ... |
-
-## Антипаттерны
-
-| # | Код | Антипаттерн | Где найден |
-|---|-----|------------|-----------|
-| 1 | {S1/C2/B3/...} | {название} | {файл:секция} |
-
-## Gap-анализ
-
-| # | Тип пробела | Описание | Приоритет |
-|---|------------|----------|-----------|
-| 1 | {Workflow/Knowledge/...} | {описание} | {приоритет} |
-
-## Сильные стороны
-
-1. {что сделано хорошо}
-2. ...
-3. ...
-
-## План улучшений
-
-| # | Улучшение | Приоритет | Score | Оценка трудозатрат |
-|---|-----------|-----------|-------|--------------------|
-| 1 | {что сделать} | CRITICAL | {N} | {быстро/средне/долго} |
-| 2 | ... | ... | ... | ... |
-```

package/src/skills/coach/templates/coach-backlog-init.yaml

@@ -1,10 +0,0 @@
-# Шаблон инициализации бэклога коуча
-# Скопировать в .workflow/coach-backlog.yaml при первом запуске
-version: 1
-last_updated: ""
-
-analyzed_tickets: []
-
-applied_changes: []
-
-audited_skills: []

package/src/skills/coach/templates/improvement-plan.md

@@ -1,54 +0,0 @@
-# Шаблон: План улучшений скила
-
-```markdown
-# План улучшений: {skill-name}
-
-**Дата:** {YYYY-MM-DD}
-**Тикет:** {COACH-NNN}
-**Основание:** {ссылка на аудит / анализ / запрос}
-
-## Цель
-
-{Что хотим улучшить и почему — 1-2 предложения.}
-
-## Изменения
-
-### 1. {Название изменения}
-
-**Приоритет:** {CRITICAL / HIGH / MEDIUM / LOW}
-**Файлы:** {перечисление затронутых файлов}
-
-**Проблема:**
-{Что не так сейчас.}
-
-**Решение:**
-{Что конкретно сделать.}
-
-**Ожидаемый эффект:**
-{Как это улучшит работу скила — измеримо если возможно.}
-
-### 2. ...
-
-## Порядок выполнения
-
-{Последовательность: что делать первым, какие зависимости.}
-
-1. {Шаг 1} — зависит от: нет
-2. {Шаг 2} — зависит от: шаг 1
-...
-
-## Критерии успеха
-
-- [ ] {Критерий 1 — как проверить что улучшение работает}
-- [ ] {Критерий 2}
-- [ ] Все ссылки в SKILL.md валидны
-- [ ] Scoring скила вырос на {N} баллов
-
-## Источники
-
-{Если использовались внешние знания — ссылки с описанием.}
-
-| Источник | Что взято | Дата |
-|----------|----------|------|
-| {URL/название} | {что именно} | {YYYY-MM-DD} |
-```