@gian-tiaga/eda 0.2.9 → 0.2.10

package/docs/skills/eda-plan.md

@@ -1,11 +1,11 @@
 ---
 name: eda-plan
-description: 'Написание плана реализации через стандартный Plan Mode (Claude Code / Codex). Перед планированием подтягивает docs/rules.md, docs/arch.md, при необходимости — релевантное исследование. Согласованный план сохраняется в docs/plans/. Всегда проверяет план тремя параллельными моделями (слабая, средняя, мощная) на реалистичность, пропущенные шаги, нарушения правил и риски — главный планировщик сам решает, что добавить/убрать. В `strict` — ещё и кросс-CLI (Claude ↔ Codex). Все вопросы — через интерактивный вопрос.'
+description: 'Написание плана реализации через стандартный Plan Mode (Claude Code / Codex). Перед планированием читает docs/rules.md, docs/arch.md и строго следует им, при необходимости подтягивает релевантное исследование. Нормализует результат в исполнимый план с целевым алгоритмом, фазами, проверками и без неразрешённых альтернатив. Согласованный план сохраняется в docs/plans/. Всегда проверяет план тремя параллельными моделями (слабая, средняя, мощная) на реалистичность, пропущенные шаги, нарушения правил и риски. В `strict` — ещё и кросс-CLI (Claude ↔ Codex). Все вопросы — через интерактивный вопрос.'
 ---
 
 # Скил: Планировщик (eda-plan)
 
-Собираешь контекст, прогоняешь задачу через **стандартный Plan Mode** хост-агента, сохраняешь план в файл. Затем три параллельные модели проверяют план на реалистичность — главный планировщик сам решает, что применить из их предложений. При `strict` — ещё и кросс-CLI на втором круге.
+Собираешь контекст, прогоняешь задачу через **стандартный Plan Mode** хост-агента, нормализуешь результат в исполнимый план и сохраняешь его в файл. Затем три параллельные модели проверяют план на реалистичность — главный планировщик сам решает, что применить из их предложений. При `strict` — ещё и кросс-CLI на втором круге.
 
 ## Режимы вызова
 
@@ -18,12 +18,14 @@ description: 'Написание плана реализации через ст
 
 1. **Никаких правок кода.** Запись только в `docs/plans/`.
 2. **Интерактивные вопросы** — по разделу ниже.
-3. **Plan Mode — главный инструмент.** Не изобретай свой формат планирования поверх — используй то, что Plan Mode даёт.
+3. **Plan Mode — главный инструмент.** Он даёт содержательный черновик, но финальный файл обязан быть нормализован в формат этого скилла.
 4. **Не переформулируй запрос пользователя** перед Plan Mode. Уйдёт оригинал + ответы на уточнения. Своя цель/критерии разводят смысл.
 5. **План сохраняется в файл до любой верификации** — иначе ревьюеру нечего читать.
-6. **Простой язык** в сообщениях, вопросах, шапке плана. Термины — только если без них нельзя, и сразу с пояснением. Текст самого Plan Mode не переписывай.
+6. **Простой язык** в сообщениях, вопросах, шапке плана. Термины — только если без них нельзя, и сразу с пояснением.
 7. **Диаграммы — желательно, не любой ценой.** Линейный план — диаграмма не нужна.
 8. **Таблицы > сплошной текст** для структурируемых данных.
+9. **Финальный план — не исследование.** Исследовательские факты идут в контекст, выбранные подходы — в решения, исполнимые шаги — в фазы.
+10. **Не оставляй неоднозначности.** Если в плане остаётся «выбрать», «решить», «можно так или так», «предпочтительно» — задай вопрос до финализации или зафиксируй одно принятое решение.
 
 ## Интерактивные вопросы
 
@@ -36,7 +38,7 @@ description: 'Написание плана реализации через ст
 ## Этапы
 
 ### 1. Подтянуть контекст
-Прочитай `docs/rules.md`, `docs/arch.md` (если есть). Через `AskUserQuestion` спроси про релевантное исследование — покажи последние файлы из `docs/researches/` + опция «нет».
+Прочитай `docs/rules.md`, `docs/arch.md` (если есть) и строго следуй им при планировании. Через `AskUserQuestion` спроси про релевантное исследование — покажи последние файлы из `docs/researches/` + опция «нет».
 
 ### 2. Уточнить, если есть неясность
 Не переформулируй запрос. Если есть конкретная неясность, без которой планировать нельзя — задай 1–4 точечных вопроса через `AskUserQuestion`. Не задавай «на всякий случай». Пары «вопрос → ответ» сохрани — они идут в Plan Mode.
@@ -45,13 +47,16 @@ description: 'Написание плана реализации через ст
 Войди в Plan Mode хост-агента (`EnterPlanMode` в Claude Code, встроенный план-режим в Codex). На вход:
 1. Дословный запрос пользователя.
 2. Пары «вопрос → ответ» из этапа 2.
-3. Ссылки на `docs/rules.md`, `docs/arch.md`, исследование (без пересказа — Plan Mode прочитает сам).
+3. Ссылки на `docs/rules.md`, `docs/arch.md`, исследование (без пересказа — Plan Mode прочитает сам) и явное требование строго следовать правилам и архитектуре.
 4. Инструкция: «все вопросы пользователю — только по разделу "Интерактивные вопросы", никаких догадок и продолжения без ответа».
+5. Инструкция: «финальный план должен иметь раздел "Целевой алгоритм", фазы с целью/результатом/проверкой и не должен смешивать исследование с планом исполнения».
 
 Не выходи, пока пользователь не подтвердил план.
 
 ### 4. Сохранить файл
-`docs/plans/{YYYY-MM-DD}_{HH-MM}_{slug}.md`. Структура — **только YAML-шапка и текст плана от Plan Mode**, как он его выдал:
+Перед сохранением нормализуй подтверждённый черновик Plan Mode в обязательную структуру. Смысл решений не меняй без вопроса пользователю, но форму, порядок и ясность правь обязательно.
+
+Финальный план должен быть пригоден для `eda-execute` без дополнительного исследования. Структура файла `docs/plans/{YYYY-MM-DD}_{HH-MM}_{slug}.md`:
 
 ```markdown
 ---
@@ -67,10 +72,64 @@ sources:
   research: <путь или —>
 ---
 
-<текст плана из Plan Mode дословно>
+# План реализации
+
+## Задача
+Коротко: что нужно реализовать и какой результат считается готовым.
+
+## Контекст
+Факты из кода, правил, архитектуры и исследований. Здесь можно объяснять причины, но не хранить исполнимые шаги.
+
+## Принятые решения
+Список зафиксированных архитектурных и продуктовых решений. Без вариантов «или».
+
+## Целевой алгоритм
+Пошаговое описание целевого поведения системы от входного события до финального состояния. Это обзор всей картины, не список файлов.
+
+## Фазы выполнения
+
+### 1. <Название фазы>
+Цель: зачем нужна эта фаза.
+
+Что сделать:
+- ...
+
+Результат: какое состояние системы должно получиться.
+
+Проверка:
+- тест, команда или критерий готовности.
+
+## Тесты
+Сценарии, которые нужно покрыть, сгруппированные по поведению или фазам.
+
+## Документация и эксплуатация
+Что обновить в env/docs/runbook и что важно для релиза.
+
+## Риски
+Риски и конкретное снижение каждого риска.
+
+## Порядок выполнения
+Краткий линейный список действий для исполнителя.
 ```
 
-Покажи путь.
+Правила структуры:
+- В `Контекст` попадают исследовательские наблюдения и ограничения.
+- В `Принятые решения` попадают только выбранные решения, без альтернатив.
+- В `Целевой алгоритм` попадает сквозная картина процесса.
+- В `Фазы выполнения` попадают только исполнимые шаги.
+- Каждая фаза обязана иметь `Цель`, `Что сделать`, `Результат`, `Проверка`.
+- Если нужен раздел `Открытые вопросы`, план остаётся `draft`; после сохранения остановись и не запускай мета-ревью до ответа пользователя.
+
+Перед сохранением проверь quality gate:
+- есть `Целевой алгоритм`;
+- фазы идут в реалистичном порядке реализации;
+- у каждой фазы есть цель, результат и проверка;
+- нет неразрешённых формулировок «выбрать», «решить», «можно так или так», «предпочтительно», «при необходимости»;
+- мета-уровень не смешан с шагами исполнения;
+- тесты связаны с ключевыми сценариями и рисками;
+- план можно передать в `eda-execute` без нового исследования.
+
+Сохрани файл и покажи путь.
 
 ### 5. Мета-ревью плана тремя моделями (параллельно)
 Запусти **в одном сообщении и одним batch** трёх агентов на трёх разных моделях — слабая, средняя, мощная. Не запускай сначала одного-двух, не жди их ответы и не запускай третьего позже: все три проверки должны стартовать до чтения любого результата.
@@ -94,15 +153,18 @@ sources:
 
 Базовый формат ответа для всех: `+ N | − N | ~ N: причина`, без воды. Для мощной модели добавь явную инструкцию: «Если план ссылается на модуль, API, тесты или сценарий, открой соответствующие файлы и проверь фактическую структуру проекта.»
 
-Когда все три ответили — прочитай ответы, **сам реши**, что применять (не вставляй чужие пункты механически). Внеси правки в файл плана. Допиши в конец раздел:
+Когда все три ответили — прочитай ответы, **сам реши**, что применять (не вставляй чужие пункты механически). Принятые замечания сначала интегрируй в основные разделы плана: решения, алгоритм, фазы, тесты, риски. Не оставляй важные требования только в changelog.
+
+После интеграции снова прогони quality gate из этапа 4. Затем допиши в конец короткий раздел:
 
 ```markdown
 ## Изменения после мета-ревью
 
 ### После моделей
-- **+ Добавлено:** ...
-- **− Убрано:** ...
-- **Отклонено:** ...
+- **+ Добавлено:** 3–7 главных принятых изменений.
+- **~ Изменено:** 1–5 существенных уточнений структуры или решений.
+- **− Убрано:** если что-то удалено.
+- **Отклонено:** если отклонялись существенные предложения, коротко почему.
 ```
 
 В YAML-шапке: `status: draft` → `meta-reviewed`, в `meta_reviewers` — имена/идентификаторы моделей.
@@ -135,7 +197,9 @@ claude -p "Прочитай $PLAN_FILE, docs/rules.md, docs/arch.md, связа
 - Задавать вопросы без блокировки и продолжать работу до ответа.
 - Переформулировать запрос пользователя своими словами перед Plan Mode.
 - Пропускать сохранение файла плана.
-- Дублировать логику Plan Mode своим самописным форматом.
+- Сохранять сырой текст Plan Mode без нормализации в обязательный формат.
+- Оставлять финальный план в виде исследования, списка наблюдений или журнала мета-ревью.
+- Смешивать альтернативы с принятыми решениями: если выбор нужен — спроси пользователя до финализации.
 - Пропускать мета-ревью тремя моделями — это часть обычного режима, не под флагом.
 - Запускать мета-ревьюеров частями: сначала 1–2 агента, потом третьего. Все три стартуют сразу.
 - Вставлять предложения мета-ревьюеров механически — каждое решение принимаешь ты.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Набор скилов eda-* для Claude Code и Codex CLI: research, plan, execute, fix, review, fix-by-review, send-review, commit, docs, automate",
   "type": "module",
   "bin": {