workflow-ai 1.0.63 → 1.0.64

package/src/skills/coach/algorithms/gap-analysis.md

@@ -0,0 +1,69 @@
+# Алгоритм: Gap-анализ скила
+
+Поиск пробелов в покрытии скила — что должно быть, но отсутствует.
+
+## Вход
+
+- Путь к директории скила
+- Завершённые тикеты скила (из `.workflow/tickets/done/`)
+- Планы и отчёты (если есть)
+
+## Алгоритм
+
+### 1. Анализ маршрутизации vs реальных тикетов
+
+Сравни типы из таблицы маршрутизации SKILL.md с типами реально пришедших тикетов.
+
+| Ситуация | Тип пробела | Приоритет |
+|----------|------------|-----------|
+| Тикет пришёл, воркфлоу нет | **Workflow Gap** | HIGH |
+| Воркфлоу есть, тикетов не было | Потенциально лишний | LOW |
+| Тикет не подошёл ни под один тип | **Routing Gap** | HIGH |
+
+### 2. Анализ знаний vs потребностей воркфлоу
+
+Для каждого воркфлоу проверь: все ли данные, на которые он ссылается, есть в knowledge/?
+
+| Ситуация | Тип пробела | Приоритет |
+|----------|------------|-----------|
+| Воркфлоу ссылается на несуществующий knowledge | **Knowledge Gap** | CRITICAL |
+| Воркфлоу требует данных, но не ссылается на knowledge | **Reference Gap** | MEDIUM |
+| Knowledge есть, но не используется ни в одном воркфлоу | Потенциально лишний | LOW |
+
+### 3. Анализ решений vs алгоритмов
+
+Найди в воркфлоу места, где агент принимает решения. Есть ли для них формализованный алгоритм?
+
+| Ситуация | Тип пробела | Приоритет |
+|----------|------------|-----------|
+| Решение принимается без алгоритма | **Algorithm Gap** | MEDIUM |
+| Алгоритм есть, но не используется | **Adoption Gap** | MEDIUM |
+
+### 4. Анализ вывода vs шаблонов
+
+Для каждого типа результата воркфлоу: есть ли шаблон в templates/?
+
+| Ситуация | Тип пробела | Приоритет |
+|----------|------------|-----------|
+| Воркфлоу формирует результат без шаблона | **Template Gap** | MEDIUM |
+| Шаблон есть, но не используется | Потенциально лишний | LOW |
+
+### 5. Анализ результатов тикетов
+
+Изучи завершённые тикеты. Где результат неполный или низкого качества?
+
+| Признак | Тип пробела | Приоритет |
+|---------|------------|-----------|
+| Пустые секции в результате | Воркфлоу неполный | HIGH |
+| Агент «придумал» данные | Нужен knowledge-модуль | HIGH |
+| Результат не по шаблону | Шаблон неизвестен агенту | MEDIUM |
+
+## Выход
+
+Таблица пробелов:
+
+| # | Тип пробела | Файл/секция | Описание | Приоритет | Рекомендация |
+|---|------------|-------------|----------|-----------|-------------|
+| 1 | ... | ... | ... | ... | ... |
+
+Сортировка по приоритету: CRITICAL → HIGH → MEDIUM → LOW.

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

@@ -0,0 +1,62 @@
+# Алгоритм: Приоритизация улучшений
+
+Метод определения порядка внесения улучшений в скил.
+
+## Вход
+
+Список улучшений из аудита, анализа или 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 в целевой скил»
+- Impact: 4 (часто нужен при стратегических решениях)
+- Confidence: 4 (видно из тикетов, где агент додумывал)
+- Effort: 5 (создать один файл)
+- Score: (4 × 4 × 5) / 25 = 3.2 → **CRITICAL**

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

@@ -0,0 +1,80 @@
+# Алгоритм: Оценка качества скила
+
+## Вход
+
+Путь к директории скила (`.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 ведут на существующие файлы | 4 |
+| Все файлы knowledge/ упомянуты в таблице загрузки | 4 |
+| Все файлы algorithms/ упомянуты в таблице загрузки | 4 |
+| Терминология единообразна | 4 |
+| **Изоляция:** нет хардкода имён других скилов/ролей (grep на имена ролей = 0) | 4 |
+
+## Выход
+
+| Балл | Оценка | Рекомендация |
+|------|--------|-------------|
+| 80–100 | **EXCELLENT** | Скил готов к работе, мелкие улучшения |
+| 60–79 | **GOOD** | Работоспособен, но есть существенные пробелы |
+| 40–59 | **NEEDS_WORK** | Требуется серьёзная доработка |
+| 0–39 | **POOR** | Фундаментальные проблемы, рассмотреть пересоздание |
+
+## Пример
+
+Скил `example-skill`:
+- Структура: 20/20 (все компоненты на месте)
+- Полнота SKILL.md: 20/20 (все секции)
+- Качество воркфлоу: 18/20 (минус 2 за неполные чеклисты)
+- Качество знаний: 17/20 (минус 3 за отсутствие примеров в algorithms)
+- Связность: 20/20 (всё связано)
+- **Итого: 95/100 — EXCELLENT**

package/src/skills/coach/knowledge/audit-applied-changes-clean.txt

@@ -0,0 +1,11 @@
+Аудит 2026-04-16: остаточных упоминаний applied_changes[] не найдено.
+
+Проверены файлы (исключая backlog-management.md):
+- common-antipatterns.md — чисто
+- prompt-engineering.md — чисто
+- shared-knowledge-guide.md — чисто
+- skill-anatomy.md — чисто
+- test-authorship.md — чисто
+
+Паттерны поиска: applied_changes, change_id, CHG-, «бэклог изменений», «ledger правок».
+Тикет: COACH-31.

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

@@ -0,0 +1,67 @@
+# Управление бэклогом коуча
+
+Бэклог `.workflow/coach-backlog.yaml` — единственный источник правды о проанализированных тикетах и результатах аудита скилов.
+
+## Структура бэклога
+
+```yaml
+version: 1
+last_updated: "2026-03-20"
+
+analyzed_tickets:
+  - ticket_id: "XXX-001"
+    ticket_file: "tickets/done/XXX-001.md"
+    analyzed_date: "2026-03-20"
+    coach_ticket: "COACH-005"
+    findings_count: 3
+    summary: "Краткое описание findings"
+
+audited_skills:
+  - skill_name: "example-skill"
+    last_audit_date: "2026-03-20"
+    coach_ticket: "COACH-004"
+    score: 72
+    status: "NEEDS_WORK"
+```
+
+## Секции бэклога
+
+- **`analyzed_tickets[]`** — защита от повторного анализа тикетов/логов, не приведших к правке скила. Позволяет пропустить уже проанализированный материал.
+- **`audited_skills[]`** — snapshot scores скилов в момент аудита. Позволяет отслеживать динамику качества скилов.
+
+## Правила работы
+
+### Перед началом (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай бэклог → пропусти тикеты из `analyzed_tickets`
+
+### После завершения (ОБЯЗАТЕЛЬНО)
+
+1. Добавь проанализированные тикеты и результаты аудита
+2. Обнови `last_updated`
+
+## История правок скилов — в git
+
+История всех изменений скилов хранится в git-репозитории. Используй стандартные git-команды для её изучения:
+
+```bash
+git log -- src/skills/coach/                    # все правки скила coach
+git log -- src/skills/coach/tests/cases/        # все созданные/изменённые тесты
+git log --follow -- src/skills/coach/SKILL.md   # история конкретного файла
+git blame src/skills/coach/SKILL.md             # кто что написал
+```
+
+## Миграционная заметка
+
+Секция `applied_changes[]` удалена из беклога целиком при миграции (задача IMPL-24).
+
+- Старые CHG доступны через `git show <commit-before-migration>:.workflow/coach-backlog.yaml`.
+- Принципы из старых CHG отражены в тест-кейсах через поле `origin.chg`.
+- Никакого `legacy_*` архива не поддерживается.
+
+## Антипаттерны
+
+- **Повторный анализ** уже проанализированного тикета
+- **Забыть записать** — провести анализ/аудит без записи в бэклог
+
+<!-- РАСШИРЕНИЕ: добавляй правила ведения бэклога ниже -->

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

@@ -0,0 +1,90 @@
+# Управление бэклогом коуча
+
+Бэклог `.workflow/coach-backlog.yaml` — единственный источник правды о проанализированных тикетах и внесённых правках.
+
+## Структура бэклога
+
+```yaml
+version: 1
+last_updated: "2026-03-20"
+
+analyzed_tickets:
+  - ticket_id: "XXX-001"
+    ticket_file: "tickets/done/XXX-001.md"
+    analyzed_date: "2026-03-20"
+    coach_ticket: "COACH-005"
+    findings_count: 3
+    summary: "Краткое описание findings"
+
+applied_changes:
+  - change_id: "CHG-001"
+    date: "2026-03-20"
+    coach_ticket: "COACH-005"
+    target_skill: "example-skill"
+    changed_files: ["skills/example-skill/knowledge/module.md"]
+    change_type: "improve"  # improve | fix | add | refactor
+    description: "Что и зачем изменено"
+    based_on_tickets: ["XXX-001"]
+
+audited_skills:
+  - skill_name: "example-skill"
+    last_audit_date: "2026-03-20"
+    coach_ticket: "COACH-004"
+    score: 72
+    status: "NEEDS_WORK"
+```
+
+## Правила работы
+
+### Перед началом (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай бэклог → пропусти тикеты из `analyzed_tickets` → учитывай `applied_changes`
+
+### После завершения (ОБЯЗАТЕЛЬНО)
+
+1. Добавь проанализированные тикеты, внесённые правки, результаты аудита
+2. Обнови `last_updated`
+3. `change_id`: `CHG-{порядковый номер, 3 цифры}` — следующий после максимального
+
+## Компрессия бэклога
+
+**Когда:** после записи, если размер > 500 строк. **Цель:** < 300 строк.
+
+### Что сжимать
+
+**1. `analyzed_tickets`** — группировка по скилу: тикеты с похожими findings → одна запись с `consolidated_from` и summary ключевых findings + ссылки на CHG.
+
+**2. `applied_changes`** — группировка связанных: CHG одной проблемы (цепочка итераций) → одна запись с `consolidated_from`, объединёнными `changed_files` и summary.
+
+**3. Не сжимать:** последние 10 записей каждой секции, уникальные findings, `audited_skills`.
+
+### Формат консолидированной записи
+
+Добавляй `consolidated_from: [...]` для трассировки. Summary — ключевые findings + ссылки на CHG.
+
+## Ad-hoc анализы (без тикета)
+
+Если стейкхолдер запрашивает анализ артефакта напрямую (лог, декомпозиция, план) — без формального тикета COACH-* — результат записывается в `analyzed_tickets` с полем `source: ad_hoc`:
+
+```yaml
+analyzed_tickets:
+  - source: ad_hoc
+    artifact: "pipeline_2026-04-06_16-36-02.log"  # путь/имя артефакта
+    analyzed_date: "2026-04-18"
+    findings_count: 4
+    summary: "Краткое описание findings"
+```
+
+**Поля `ticket_id` и `ticket_file` — опциональны** для записей с `source: ad_hoc`, так как тикета не существует.
+
+**⛔ Не используй нестандартные поля** (например, `last_action`) для хранения записей об анализе — они не являются частью схемы, не проходят дедупликацию и молча перезаписываются при следующей записи в тот же ключ (дублирующие ключи в YAML невалидны).
+
+## Антипаттерны
+
+- **Повторный анализ** уже проанализированного тикета или артефакта
+- **Дублирование правок** — предлагать то, что уже в `applied_changes`
+- **Забыть записать** — внести правку без записи в бэклог
+- **Бесконечный рост** — не сжимать при > 500 строк
+- **Non-schema поля** — записывать ad-hoc анализы в `last_action` или любой другой ключ вне официальной схемы вместо `analyzed_tickets` с `source: ad_hoc`
+
+<!-- РАСШИРЕНИЕ: добавляй правила ведения бэклога ниже -->

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

@@ -0,0 +1,76 @@
+# Типичные антипаттерны в скилах
+
+Чеклист проблем при аудите и ревью скилов.
+
+## Структурные (S)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| S1 | Осиротевшие файлы (не в SKILL.md) | Добавить в таблицу загрузки или удалить |
+| S2 | Битые ссылки | Создать файл или исправить ссылку |
+| S3 | Пустые директории | Заполнить или убрать |
+| S4 | Монолитный SKILL.md | Декомпозировать в воркфлоу |
+| S5 | Нет README | Создать по эталону |
+
+## Содержание (C)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| C1 | Абстрактная роль | Описать роль, границы, зону ответственности |
+| C2 | Размытые принципы | Что делать, когда, как измерить |
+| C3 | Воркфлоу-декларация без шагов | Конкретные шаги, чеклисты, пороги |
+| C4 | Knowledge без структуры | Таблицы, заголовки, маркеры расширения |
+| C5 | Algorithm без формул | Числовые критерии, формулы, пороги |
+| C6 | Template без подсказок | Примеры и placeholder в каждое поле |
+
+## Поведение (B)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| B1 | Выход за границы | Уточнить «Ты НЕ делаешь» |
+| B2 | Дублирование знаний | Вынести в один модуль, ссылаться |
+| B3 | Нет маршрута для типа | Добавить воркфлоу/маршрутизацию |
+| B4 | Игнорирование knowledge | Добавить ссылки в шагах воркфлоу |
+| B5 | Нет fallback | Правило «Если тип не определяется — ...» |
+
+## Изоляция (I)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| I1 | Хардкод имён ролей/скилов | → «любой скил проекта», generic ID (XXX-NNN) |
+| I2 | Примеры с конкретными ID ролей | → XXX-001, example-skill |
+| I3 | Таблица ролей во Взаимодействии | → «Любой скил может создать тикет {PREFIX}-*» |
+| I4 | Ссылки на инструменты других скилов | → «описаны в SKILL.md исполнителя» |
+| I5 | Границы компетенции с именами | → «соответствующий скил проекта» |
+
+**Проверка:** `grep -rE "GML|PMA|CSM|CRO|PMK" src/skills/` → 0 результатов.
+
+## Изоляция от конфигурации (IC)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| IC1 | Хардкод project-wide типов задач | Скил определяет подход по содержимому тикета |
+| IC2 | Knowledge-дубликат конфига | Удалить, источник правды — конфиг |
+| IC3 | Воркфлоу под каждый project-wide тип | Организовать по этапам работы или собственным типам |
+
+## Scope management (SC)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| SC1 | Scope creep через DoD | Запретить скилу исполнения создавать тикеты |
+| SC2 | Декомпозиция без scope-guard | Проверка «Включено/Исключено из scope» |
+| SC3 | Тикеты-сироты без parent_plan | Обязательно заполнять parent_plan |
+| SC4 | Каскадная декомпозиция | Только скилы декомпозиции создают тикеты |
+| SC5 | Горизонт за пределами плана | Future-задачи → рекомендации, не тикеты |
+| SC6 | Каскад исполнение→план→декомпозиция | 3 уровня защиты в скиле исполнения |
+| SC7 | Автодекомпозиция без human-approval | Только планы со `status: approved` |
+
+## Масштабирование (M)
+
+| # | Антипаттерн | Как исправить |
+|---|------------|---------------|
+| M1 | Нет маркеров расширения | `<!-- РАСШИРЕНИЕ: ... -->` в конец |
+| M2 | Жёсткая привязка | Параметризовать или вынести в конфиг |
+| M3 | Нет инструкций по расширению | Секция «Как расширять» в README |
+
+<!-- РАСШИРЕНИЕ: добавляй новые антипаттерны ниже -->

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

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

package/src/skills/coach/knowledge/shared-knowledge-guide.md

@@ -0,0 +1,44 @@
+# Shared Knowledge — межскиловые знания
+
+Когда knowledge-модуль нужен 2+ скилам — он выносится в `skills/shared/`.
+
+## Структура
+
+```
+skills/
+├── shared/               # Проектно-специфичные знания, общие для нескольких скилов
+│   ├── README.md         # Индекс: таблица модулей с описанием и списком потребителей
+│   └── module.md
+├── skill-a/
+└── skill-b/
+```
+
+## README.md — обязательный индекс
+
+```markdown
+# Shared Knowledge Modules
+
+| Модуль | Описание | Используется в |
+|--------|----------|----------------|
+| `module-name.md` | Что содержит | skill-a, skill-b |
+```
+
+## Правила
+
+| Правило | Описание |
+|---------|----------|
+| **Критерий выноса** | Контент используется 2+ скилами с пересечением 70%+ |
+| **Скилы — универсальные, shared — проектный** | Скилы переносятся между проектами as-is. Shared содержит проектно-специфичные знания |
+| **Ссылка из скила — через glob** | В таблице загрузки: `../shared/*` → «проверь индекс, загрузи релевантные». Не хардкодить имена модулей |
+| **Domain-контекст — в скиле** | Специфичная интерпретация shared-знаний остаётся в knowledge/workflows скила |
+
+## Антипаттерны
+
+| Антипаттерн | Как правильно |
+|-------------|---------------|
+| Дублировать данные в knowledge/ нескольких скилов | Вынести в shared/ |
+| Хардкодить `../shared/module.md` в SKILL.md | `../shared/*` → проверить README |
+| Класть в shared/ knowledge одного скила | Оставить в knowledge/ скила |
+| Вкладывать shared/ в конкретный скил | shared/ — на одном уровне со скилами |
+
+<!-- РАСШИРЕНИЕ: добавляй правила shared knowledge ниже -->

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

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