workflow-ai 1.0.32 → 1.0.33

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

@@ -1,103 +1,175 @@
----
-name: decompose-plan
-description: Декомпозировать план на исполняемые тикеты. Используй после создания плана для разбиения высокоуровневых задач на конкретные тикеты с зависимостями и условиями. Создаёт тикеты в .workflow/tickets/backlog/.
----
-
-# Декомпозиция плана на тикеты
-
-Этот skill разбивает высокоуровневый план на исполняемые тикеты для канбан-доски.
-
-## Когда использовать
-
-- Создан новый план
-- Нужно разбить крупную задачу на подзадачи
-- Требуется детальная декомпозиция
-
-## Шаги выполнения
-
-### 1. Прочитать план
-
-```
-Путь: .workflow/plans/current/PLAN-{NNN}.md
-```
-
-Извлечь:
-- Список высокоуровневых задач
-- Зависимости между ними
-- Приоритеты
-- Контекст проекта
-
-### 2. Для каждой задачи определить тикеты
-
-Каждая задача из плана может превратиться в 1+ тикетов.
-
-Критерии хорошего тикета:
-- Атомарный (одна конкретная работа)
-- Выполнимый за 1-4 часа
-- Имеет чёткие критерии готовности
-- Понятно что делать без дополнительных вопросов
-
-### 3. Определить тип каждого тикета
-
-Прочитай актуальные типы задач из `.workflow/config/config.yaml` (секция `task_types`). Используй **только** префиксы, определённые в конфиге. Не используй типы, которых нет в конфиге.
-
-### 4. Определить зависимости
-
-Для каждого тикета:
-- От каких тикетов зависит (`dependencies`)
-- Какие условия должны быть выполнены (`conditions`)
-
-Типы условий:
-- `tasks_completed: [IMPL-001, IMPL-002]` — задачи должны быть выполнены
-- `date_after: "2024-01-15"` — не раньше даты
-- `file_exists: "src/config.py"` — файл должен существовать
-- `manual_approval: true` — требуется одобрение человека
-
-### 5. Назначить приоритеты
-
-| Приоритет | Значение |
-|-----------|----------|
-| 1 | Critical — блокирует всё |
-| 2 | High — важно для прогресса |
-| 3 | Medium — стандартная работа |
-| 4 | Low — можно отложить |
-| 5 | Someday — когда-нибудь |
-
-### 6. Создать тикеты
-
-1. Прочитай шаблон: `.workflow/templates/ticket-template.md`
-2. Для каждого тикета:
-   - Определи следующий ID: найди все файлы `{TYPE}-*.md` во всех папках `.workflow/tickets/`, возьми максимальный номер для этого префикса и прибавь 1. Если файлов нет — начни с `{TYPE}-001`.
-   - Заполни шаблон
-   - **Обязательно** заполни `parent_plan: "plans/current/PLAN-{NNN}.md"` — путь к плану, из которого создан тикет
-   - Сохрани в `.workflow/tickets/backlog/{TYPE}-{NNN}.md`
-
-### 7. Обновить план
-
-Добавь в план ссылки на созданные тикеты.
-
-### 8. Вывести структурированный результат
-
-После создания тикетов **обязательно** выведи блок результата:
-
-```
----RESULT---
-status: default
----RESULT---
-```
-
-## Пример использования
-
-```
-Декомпозируй план .workflow/plans/current/PLAN-001.md на тикеты.
-```
-
-## Результат
-
-- Тикеты в `.workflow/tickets/backlog/`
-- Обновлённый план с ссылками на тикеты
-
-## Связанные skills
-
-- `create-plan` — создание плана для декомпозиции
-- `check-conditions` — проверка готовности тикетов
+---
+name: decompose-plan
+description: Декомпозировать план на исполняемые тикеты. Используй после создания плана для разбиения высокоуровневых задач на конкретные тикеты с зависимостями и условиями. Создаёт тикеты в .workflow/tickets/backlog/.
+---
+
+# Декомпозиция плана на тикеты
+
+Этот skill разбивает высокоуровневый план на исполняемые тикеты для канбан-доски.
+
+## Когда использовать
+
+- Создан новый план
+- Нужно разбить крупную задачу на подзадачи
+- Требуется детальная декомпозиция
+
+## ⛔ ПРЕДУСЛОВИЕ: проверка статуса плана
+
+**ПЕРЕД любой работой** прочитай frontmatter плана и проверь поле `status`.
+
+| Статус плана | Действие |
+|-------------|----------|
+| `approved` | Декомпозировать. Продолжай к шагу 1. |
+| `draft` | **СТОП.** Не декомпозировать. Выведи `status: decomposed` и завершись. Draft-план ещё не одобрен человеком. |
+| `active` | **СТОП.** Не декомпозировать. План уже в работе. Выведи `status: decomposed`. |
+| `completed` | **СТОП.** Не декомпозировать. План завершён. Выведи `status: decomposed`. |
+| Другой/пустой | **СТОП.** Не декомпозировать. Выведи `status: decomposed`. |
+
+**Почему:** Без этой проверки pipeline автоматически декомпозирует любой план, обнаруженный в `plans/current/`, включая черновики, созданные другими тикетами. Это приводит к неконтролируемому разрастанию backlog (scope creep). Уже дважды происходило.
+
+## Шаги выполнения
+
+### 1. Прочитать план
+
+```
+Путь: .workflow/plans/current/PLAN-{NNN}.md
+```
+
+Извлечь:
+- Список высокоуровневых задач
+- Зависимости между ними
+- Приоритеты
+- Контекст проекта
+
+### 2. Для каждой задачи определить тикеты
+
+Каждая задача из плана может превратиться в 1+ тикетов.
+
+Критерии хорошего тикета:
+- Атомарный (одна конкретная работа)
+- Выполнимый за 1-4 часа
+- Имеет чёткие критерии готовности
+- Понятно что делать без дополнительных вопросов
+
+### 2.5. Оценить автономность каждой задачи
+
+Для каждой задачи из плана определи: **может ли агент выполнить её полностью автономно?**
+
+| Категория | Критерий | Действие |
+|-----------|----------|----------|
+| **Полностью автономная** | Агент может выполнить все шаги без участия человека (написание кода, документации, анализ данных через WebSearch/WebFetch) | Создать 1 тикет с `executor_type: agent` |
+| **Полностью ручная** | Требует действий, недоступных агенту (доступ к приватным аккаунтам, физические действия, аутентифицированные сервисы) | Создать 1 тикет `type: human` с `executor_type: human` и явными инструкциями для человека |
+| **Гибридная** | Часть работы может сделать агент, часть — только человек | Разбить на 2 тикета: (a) агентский тикет с `executor_type: agent` и (b) HUMAN-тикет с `executor_type: human`, с зависимостью между ними |
+
+**Для HUMAN-тикетов обязательно:**
+- Явные пошаговые инструкции что именно должен сделать человек
+- DoD-критерий: «Результаты внесены непосредственно в файл тикета»
+- Указание в каком формате ожидается результат
+
+**Пример разбиения гибридной задачи:**
+
+Задача из плана: «Провести конкурентный анализ и настроить трекинг конкурентов в аналитике»
+
+→ Тикет 1 (agent): `PMA-005` — Провести конкурентный анализ через публичные источники (WebSearch: цены, позиционирование, отзывы, ASO). `executor_type: agent`
+
+→ Тикет 2 (human): `HUMAN-010` — Настроить трекинг конкурентов в SimilarWeb Pro (требует auth). `executor_type: human`, `dependencies: [PMA-005]`. Инструкции: «1. Войти в SimilarWeb Pro. 2. Добавить домены конкурентов из PMA-005. 3. Настроить еженедельный отчёт. 4. Вставить ссылку на дашборд в результат тикета.»
+
+### 3. Определить тип каждого тикета
+
+Прочитай актуальные типы задач из `.workflow/config/config.yaml` (секция `task_types`). Используй **только** префиксы, определённые в конфиге. Не используй типы, которых нет в конфиге.
+
+### 4. Определить зависимости
+
+Для каждого тикета:
+- От каких тикетов зависит (`dependencies`)
+- Какие условия должны быть выполнены (`conditions`)
+
+Типы условий:
+- `tasks_completed: [IMPL-001, IMPL-002]` — задачи должны быть выполнены
+- `date_after: "2024-01-15"` — не раньше даты
+- `file_exists: "src/config.py"` — файл должен существовать
+- `manual_approval: true` — требуется одобрение человека
+
+### 4.5. Scope-guard: проверка принадлежности к плану
+
+**ОБЯЗАТЕЛЬНО** перед созданием каждого тикета выполнить проверку scope.
+
+#### Правило: тикеты создаются ТОЛЬКО на работу внутри scope плана
+
+Прочитай секции плана «Scope (Границы)» → «Включено в scope» и «Исключено из scope». Каждый создаваемый тикет **должен** относиться к работе из «Включено в scope».
+
+**Тикет в scope (создавать):**
+- Задача явно описана в высокоуровневых задачах плана
+- Задача является декомпозицией конкретного пункта плана
+- Задача необходима для достижения критериев успеха плана
+
+**Тикет вне scope (НЕ создавать):**
+- Задача относится к работе из «Исключено из scope»
+- Задача является follow-up после завершения плана (стратегия, запуск кампаний и т.д.)
+- Задача появляется из DoD другого тикета как «создать тикеты для команды» — это рекомендация для следующего плана, а не тикет текущего
+- Задача с условием `date_after` за пределами горизонта текущего плана
+
+**Для работы вне scope:** НЕ создавать тикет. Вместо этого записать в секцию «Рекомендации для следующего плана» в результате выполнения:
+
+```markdown
+### Рекомендации для следующего плана (вне scope)
+- [описание задачи] — причина: [почему это следующий этап]
+```
+
+Эти рекомендации будут учтены при создании следующего плана.
+
+#### Чеклист самопроверки перед созданием тикета
+
+- [ ] Задача входит в «Включено в scope» плана?
+- [ ] Задача НЕ входит в «Исключено из scope»?
+- [ ] `parent_plan` заполнен и указывает на текущий план?
+- [ ] Задача необходима для критериев успеха текущего плана?
+
+### 5. Назначить приоритеты
+
+| Приоритет | Значение |
+|-----------|----------|
+| 1 | Critical — блокирует всё |
+| 2 | High — важно для прогресса |
+| 3 | Medium — стандартная работа |
+| 4 | Low — можно отложить |
+| 5 | Someday — когда-нибудь |
+
+### 6. Создать тикеты
+
+1. Прочитай шаблон: `.workflow/templates/ticket-template.md`
+2. Для каждого тикета:
+   - Определи следующий ID: найди все файлы `{TYPE}-*.md` во всех папках `.workflow/tickets/`, возьми максимальный номер для этого префикса и прибавь 1. Если файлов нет — начни с `{TYPE}-001`.
+   - Заполни шаблон
+   - **Обязательно** заполни `parent_plan: "plans/current/PLAN-{NNN}.md"` — путь к плану, из которого создан тикет
+   - Сохрани в `.workflow/tickets/backlog/{TYPE}-{NNN}.md`
+
+### 7. Обновить план
+
+Добавь в план ссылки на созданные тикеты.
+
+### 8. Вывести структурированный результат
+
+После создания тикетов **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+---RESULT---
+```
+
+## Пример использования
+
+```
+Декомпозируй план .workflow/plans/current/PLAN-001.md на тикеты.
+```
+
+## Результат
+
+- Тикеты в `.workflow/tickets/backlog/`
+- Обновлённый план с ссылками на тикеты
+
+## Связанные skills
+
+- `create-plan` — создание плана для декомпозиции
+- `check-conditions` — проверка готовности тикетов

package/src/skills/execute-task/SKILL.md

@@ -1,119 +1,161 @@
----
-name: execute-task
-description: Выполнить задачу из тикета. Используй когда нужно выполнить конкретный тикет из in-progress. Читает описание задачи, выполняет работу, записывает результат. Перемещение в done/blocked выполняется отдельным stage.
----
-
-# Выполнение задачи
-
-Этот skill выполняет задачу из тикета и записывает результат.
-
-## Когда использовать
-
-- Есть тикет в `in-progress/`
-- Нужно выполнить конкретную задачу
-- Перемещение в done/blocked будет выполнено отдельным stage пайплайна
-
-## Шаги выполнения
-
-### 1. Прочитать тикет
-
-**ОБЯЗАТЕЛЬНО:** Используй ТОЛЬКО `ticket_id` из секции Context промпта. Запрещено выбирать другой тикет.
-
-```
-Путь: .workflow/tickets/in-progress/{TICKET-ID}.md
-```
-
-Если тикет не найден в `in-progress/`, проверь `review/` (при повторном выполнении тикет может быть там).
-
-**Важно:** НЕ перемещай тикет. Перемещение выполняется отдельным stage пайплайна.
-
-Извлечь:
-- Описание задачи
-- Критерии готовности (Definition of Done)
-- Контекст (файлы, ссылки, заметки)
-
-### 2. Понять задачу
-
-Убедиться что понятно:
-- Что нужно сделать
-- Какой результат ожидается
-- Какие есть ограничения
-
-Если не хватает информации:
-- Создать подзадачу на уточнение
-- Или вывести `status: blocked` в блоке результата (перемещение выполнит pipeline)
-
-### 3. Выполнить работу
-
-В зависимости от типа задачи:
-
-| Тип | Действия |
-|-----|----------|
-| IMPL | Написать код |
-| FIX | Исправить баг |
-| DOCS | Написать документацию |
-| REVIEW | Проверить код/документы |
-| PLAN | Создать план |
-| ADMIN | Выполнить настройку |
-
-### 4. Проверить критерии готовности
-
-Для каждого критерия из Definition of Done:
-- Выполнен ли он?
-- Если нет — что нужно доделать?
-
-### 5. Записать результат
-
-Добавить в тикет секцию Result:
-
-```markdown
-## Result
-
-### Что сделано
-- ...
-
-### Изменённые файлы
-- ...
-
-### Заметки
-- ...
-```
-
-### 6. Перемещение выполняется отдельным stage
-
-**Важно:** Этот skill НЕ перемещает тикет. НЕ выполняй никаких операций с файлами тикетов кроме записи результата.
-
-Запрещено:
-- Перемещать файл тикета в другую папку
-- Обновлять `status` в frontmatter
-- Добавлять `completed_at`
-- Вызывать `move-ticket.js` вручную
-
-Всё это выполняется автоматически скриптом перемещения на следующем stage пайплайна.
-
-### 7. Вывести структурированный результат
-
-После выполнения **обязательно** выведи блок результата:
-
-```
----RESULT---
-status: default
----RESULT---
-```
-
-## Пример использования
-
-```
-Выполни задачу .workflow/tickets/in-progress/IMPL-001.md
-```
-
-## Результат
-
-- Выполненная работа (код, документация и т.д.)
-- Обновлённый тикет с секцией Result
-- Тикет остаётся на месте (перемещение выполняется отдельным stage)
-
-## Связанные skills
-
-- `check-conditions` — после выполнения проверить зависимые задачи
-- `create-report` — включить результат в отчёт
+---
+name: execute-task
+description: Выполнить задачу из тикета. Используй когда нужно выполнить конкретный тикет из in-progress. Читает описание задачи, выполняет работу, записывает результат. Перемещение в done/blocked выполняется отдельным stage.
+---
+
+# Выполнение задачи
+
+Этот skill выполняет задачу из тикета и записывает результат.
+
+## ⛔ КРИТИЧЕСКИЕ ОГРАНИЧЕНИЯ (прочитай ПЕРЕД выполнением)
+
+**Execute-task — скил ИСПОЛНЕНИЯ. Он НЕ создаёт артефакты workflow.**
+
+При выполнении задачи **КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО:**
+
+1. **Создавать файлы тикетов** в `.workflow/tickets/` (любая папка: backlog, ready, in-progress)
+2. **Создавать файлы планов** в `.workflow/plans/`
+3. **Вызывать скилы** `decompose-plan`, `decompose-gaps`, `create-plan`
+4. **Интерпретировать DoD буквально**, если DoD содержит «создать тикеты» или «декомпозировать в тикеты» — это рекомендация для следующего плана, а НЕ инструкция к действию
+
+**Если задача требует создания тикетов/планов как deliverable:**
+→ Зафиксируй рекомендации в секции `### Рекомендации для следующего плана` результата тикета
+→ Человек решит, создавать ли следующий план
+
+**Почему:** Без этого ограничения возникает каскад: execute-task создаёт план → decompose-plan создаёт тикеты → backlog разрастается без контроля человека. Это уже происходило дважды.
+
+---
+
+## Когда использовать
+
+- Есть тикет в `in-progress/`
+- Нужно выполнить конкретную задачу
+- Перемещение в done/blocked будет выполнено отдельным stage пайплайна
+
+## Шаги выполнения
+
+### 1. Прочитать тикет
+
+**ОБЯЗАТЕЛЬНО:** Используй ТОЛЬКО `ticket_id` из секции Context промпта. Запрещено выбирать другой тикет.
+
+```
+Путь: .workflow/tickets/in-progress/{TICKET-ID}.md
+```
+
+Если тикет не найден в `in-progress/`, проверь `review/` (при повторном выполнении тикет может быть там).
+
+**Важно:** НЕ перемещай тикет. Перемещение выполняется отдельным stage пайплайна.
+
+Извлечь:
+- Описание задачи
+- Критерии готовности (Definition of Done)
+- Контекст (файлы, ссылки, заметки)
+
+### 2. Понять задачу
+
+Убедиться что понятно:
+- Что нужно сделать
+- Какой результат ожидается
+- Какие есть ограничения
+
+Если не хватает информации:
+- Создать подзадачу на уточнение
+- Или вывести `status: blocked` в блоке результата (перемещение выполнит pipeline)
+
+### 3. Выполнить работу
+
+В зависимости от типа задачи:
+
+| Тип | Действия |
+|-----|----------|
+| IMPL | Написать код |
+| FIX | Исправить баг |
+| DOCS | Написать документацию |
+| REVIEW | Проверить код/документы |
+| PLAN | Создать план |
+| ADMIN | Выполнить настройку (см. 3.1) |
+
+#### 3.1. Специальные правила для `type: admin`
+
+Admin-задачи требуют **реального изменения файлов**. Цикл выполнения:
+
+1. **Read** — прочитать все файлы из `context.files` инструментом Read
+2. **Edit/Write** — внести требуемые изменения инструментом Edit или Write
+3. **Verify** — перечитать изменённые файлы для верификации результата
+
+**Запрещено для admin-задач:**
+- Завершать задачу без реального изменения файлов
+- Оставлять секцию «Результат выполнения» пустой или с заглушкой
+- Описывать изменения только в Summary без внесения их в целевые файлы
+
+**Чеклист самопроверки перед завершением admin-задачи:**
+- [ ] Все файлы из `context.files` прочитаны?
+- [ ] Изменения внесены инструментом Edit/Write (не просто описаны)?
+- [ ] Изменённые файлы перечитаны и верифицированы?
+- [ ] Секция «Результат выполнения» содержит конкретный результат (не заглушку)?
+
+### 4. Проверить критерии готовности
+
+Для каждого критерия из Definition of Done:
+- Выполнен ли он?
+- Если нет — что нужно доделать?
+
+### 5. Записать результат
+
+Добавить в тикет секцию Result:
+
+```markdown
+## Result
+
+### Что сделано
+- ...
+
+### Изменённые файлы
+- ...
+
+### Заметки
+- ...
+```
+
+### 6. Перемещение выполняется отдельным stage
+
+**Важно:** Этот skill НЕ перемещает тикет. НЕ выполняй никаких операций с файлами тикетов кроме записи результата.
+
+Запрещено:
+- Перемещать файл тикета в другую папку
+- Обновлять `status` в frontmatter
+- Добавлять `completed_at`
+- Вызывать `move-ticket.js` вручную
+
+Всё это выполняется автоматически скриптом перемещения на следующем stage пайплайна.
+
+### 7. Закрыть внешние ресурсы
+
+Если задача использовала **MCP-browser (Playwright)** — **обязательно** вызови `browser_close` перед выводом результата. Незакрытый браузер блокирует профиль и мешает следующему запуску.
+
+### 8. Вывести структурированный результат
+
+После выполнения **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+---RESULT---
+```
+
+## Пример использования
+
+```
+Выполни задачу .workflow/tickets/in-progress/IMPL-001.md
+```
+
+## Результат
+
+- Выполненная работа (код, документация и т.д.)
+- Обновлённый тикет с секцией Result
+- Тикет остаётся на месте (перемещение выполняется отдельным stage)
+
+## Связанные skills
+
+- `check-conditions` — после выполнения проверить зависимые задачи
+- `create-report` — включить результат в отчёт