@gian-tiaga/eda 1.0.5 → 2.0.0

package/MIGRATION.md

@@ -1,119 +1,97 @@
-# Миграция на eda 1.0
+# Миграция на eda 2.0
 
-Версия 1.0 переводит `eda` с набора файлов-скилов на пакет с каноническими скилами и специализированными агентами для Claude Code и Codex CLI. `eda update` сохраняет полный `docs/settings.yaml` версии 2 без вопросов, а в неполном v2 спрашивает и атомарно дописывает только отсутствующие разделы перед обновлением компонентов.
+Версия 2.0 заменяет широкие итерации проверки планов специализированным workflow `eda-plan-review` → `eda-plan-review-fix` и переводит `docs/settings.yaml` на `version: 3`.
 
-## Короткий путь
-
-Обнови глобальный пакет:
+## Обновление
 
 ```bash
-npm install -g @gian-tiaga/eda@1
+npm install -g @gian-tiaga/eda@2
 eda --version
-```
-
-Команда должна вывести актуальную версию ветки `1.0.x`.
-
-В одном проекте выполни:
-
-```bash
-cd /path/to/project
 eda update
 ```
 
-Для нескольких проектов внутри одной директории можно выполнить:
+Версия CLI должна начинаться с `2.0`. После обновления перезапусти Claude Code или Codex CLI, чтобы среда перечитала новые скилы и агентов.
+
+Для нескольких проектов:
 
 ```bash
 eda update-all /path/to/projects
 ```
 
-`update-all` ищет проекты на глубине до двух уровней и предлагает два режима. `configure` один раз спрашивает полный профиль и записывает одинаковый `docs/settings.yaml` версии 2 во все найденные проекты. `skip` не задаёт вопросов, сохраняет существующие конфиги и создаёт профиль defaults только в проектах без файла. В non-TTY запуске используется `skip`.
-
-После обновления перезапусти Claude Code или Codex CLI, чтобы среда перечитала установленные скилы и агентов.
-
-## Что обновится автоматически
-
-- Скилы будут синхронизированы в `.claude/skills/<skill>/SKILL.md` и `.codex/skills/<skill>/SKILL.md`.
-- Старые управляемые Codex-файлы `.codex/skills/<skill>.md` будут удалены после установки соответствующего скила в новом формате.
-- Установятся пакетные агенты в `.claude/agents/` и `.codex/agents/`.
-- Retired-компоненты будут удалены только там, где ими владеет `eda`; чужие скилы и агенты установщик не удаляет.
-- Корневые `AGENTS.md` и `CLAUDE.md` проекта установщик не создаёт и не перезаписывает.
-
-Локальные изменения внутри управляемых `.claude/skills/eda-*`, `.codex/skills/eda-*`, `.claude/agents/eda-*` и `.codex/agents/eda-*` будут заменены. Если такие изменения нужны, сохрани их отдельно до запуска `eda update`.
-
-## Переименованные и удалённые скилы
-
-Обнови упоминания в документации, пользовательских командах и сохранённых workflow:
+`configure` один раз спрашивает общий профиль v3 и записывает его во все проекты. `skip` сохраняет полный v3, но старые, неизвестные и неполные конфиги индивидуально переносит; отсутствующие значения получает из defaults. В non-TTY используется `skip`.
 
-| До 1.0 | В 1.0 | Что изменилось |
-|---|---|---|
-| `eda-start` | `eda-new-project` | Стартовый бриф нового проекта и обязательный запуск `eda-prepare-ai` |
-| `eda-docs` | `eda-prepare-ai` | Полный технический bootstrap: архитектура, правила, проверки, references и AI/MCP-процесс |
-| `eda-execute` | `eda-plan-execute` | Выполнение плана по фазам через изолированных субагентов |
-| `eda-automate` | `eda-discover-automations` | Полный baseline gap-аудит автоматизаций даже без истории |
-| `eda-review-check` | `eda-review` | Специализированные проверки встроены в единый review-workflow |
-| `eda-research` | `eda-explore` | Старое имя окончательно выведено из эксплуатации |
+## Что изменилось
 
-Установщик удалит старые управляемые копии, но не перепишет ссылки на имена скилов в документах проекта.
+- Добавлены `eda-plan-review` и `eda-plan-review-fix`.
+- Добавлены 12 read-only агентов `eda-plan-review-*` с отдельными зонами ответственности.
+- `eda-plan-polish` теперь оркестрирует review/fix и по умолчанию ограничен тремя подтверждающими review-итерациями.
+- Готовность требует одновременно отсутствия required findings и достижения threshold.
+- Findings связаны стабильными ID и SHA-256 плана; waived optional не переоткрываются без новых доказательств.
+- `eda-plan` по `plan.review: true` выполняет один review и при необходимости один fix.
+- `eda-plan-polish strict` и `plan-polish.strict` удалены. `plan.strict` для кросс-CLI проверки самого `eda-plan` остаётся.
+- npm-пакет использует `yaml` для безопасного переноса вложенного конфига.
 
-## Миграция `docs/settings.yaml`
+## Умный перенос settings v3
 
-Версия 1.0 поддерживает только формат настроек `version: 2`. При `eda update` ответь на полный набор вопросов: команда соберёт новый профиль и атомарно заменит прежний файл независимо от его версии. `eda update-all` задаст эти вопросы только один раз и применит ответы ко всем проектам.
+Установщик разбирает старый файл как YAML, переносит валидные известные значения и спрашивает только отсутствующие в интерактивном терминале. После этого файл целиком атомарно записывается в нормализованном формате v3. Без TTY недостающие значения заменяются defaults.
 
-`eda init` ведёт себя осторожнее: если конфиг уже существует, v2 и неизвестные версии сохраняются, а v1 автоматически мигрируется с переносом поддерживаемых значений. При update-командах прежний файл заменяется выбранным полным профилем, поэтому перед запуском сохрани нестандартные поля отдельно.
+Основные соответствия:
 
-Основное соответствие полей:
-
-| `version: 1` | `version: 2` |
+| Старое поле | Новое поле |
 |---|---|
-| `defaults.strict` | `explore.strict`, `plan.strict`, `plan-polish.strict` |
-| `defaults.plan_size` | `plan.size` |
-| `defaults.decision_mode` | `explore.decision_mode`, `plan.decision_mode` |
-| `defaults.test_strategy` | `plan.test_strategy` |
-| `defaults.logging_strategy` | `plan.logging_strategy` |
-| `automate.include_plans` | `discover-automations.include_plans` |
-| `review.include_code_quality: true` | `review.agents.code_quality.mode: always` |
-| `review.include_code_quality: false` | `review.agents.code_quality.mode: off` |
+| `version: 1` или `version: 2` | `version: 3` |
+| `plan.meta_review` | `plan.review` |
+| `plan-polish.strict` | удалено |
+| отсутствует | `plan-review.threshold: 95` |
+| отсутствует | `plan-review.agents.*` |
+| отсутствует | `plan-polish.limit: 3` |
+| `defaults.strict` из v1 | `explore.strict`, `plan.strict` |
+| `defaults.plan_size` из v1 | `plan.size` |
+| `defaults.decision_mode` из v1 | `explore.decision_mode`, `plan.decision_mode` |
+| `automate.include_plans` из v1/v2 | `discover-automations.include_plans` |
 
-У старого `review.strict` нет прямого аналога. В 1.0 каждая проверка в `review.agents` отдельно получает режим `always`, `auto` или `off` и модели для Claude/Codex. Раздел `review-check` больше не используется.
+Также сохраняются валидные `orhestra.steps`, `aim`, `explore`, остальные поля `plan`, `review.agents`, `send-review` и `discover-automations`. Неизвестные пользовательские поля не входят в v3 и после нормализации удаляются.
 
-Результат переноса старых общих настроек выглядит так:
+## Новый plan-review профиль
 
 ```yaml
-version: 2
-
-explore:
-  strict: false
-  decision_mode: recommend_and_ask
+version: 3
 
 plan:
   strict: false
+  review: true
   size: normal
   decision_mode: recommend_and_ask
   test_strategy: ask_each_time
   logging_strategy: ask_each_time
 
-plan-polish:
-  strict: false
+plan-review:
+  threshold: 95
+  agents:
+    requirements:
+      mode: always
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+    architecture:
+      mode: always
+      model:
+        claude: opus
+        codex: gpt-5.6-sol
 
-discover-automations:
-  include_plans: false
+plan-polish:
+  limit: 3
 ```
 
-Новые разделы `orhestra`, `aim`, `review.agents` и `send-review` заполняются ответами на вопросы; в non-TTY запуске используются сбалансированные defaults. Полный актуальный пример приведён в [README](README.md).
-
-## Проверка после миграции
-
-Проверь версию CLI:
+Полный профиль со всеми агентами создаётся установщиком и приведён в README.
 
-```bash
-eda --version
-```
+## Проверка миграции
 
-Затем в каждом проекте проверь:
+После `eda update` проверь:
 
-- в `docs/settings.yaml` указано `version: 2`;
-- старые имена скилов больше не используются в документации и workflow;
-- для выбранных сред появились каталоги скилов и агентов;
-- `git status` показывает только ожидаемые изменения проекта.
+- `docs/settings.yaml` содержит `version: 3`, `plan.review`, `plan-review.agents` и `plan-polish.limit`;
+- в `.claude/agents/` или `.codex/agents/` установлены `eda-plan-review-*`;
+- старые ссылки на `plan.meta_review` и `eda-plan-polish strict` удалены из локальных workflow;
+- `git status` показывает только ожидаемую нормализацию настроек и обновление управляемых компонентов.
 
-Если среда ещё не была установлена в проект, используй `eda init` вместо `eda update`.
+Установщик не создаёт и не перезаписывает корневой `AGENTS.md` пользовательского проекта и не удаляет чужие skills/agents.

package/README.md

@@ -3,7 +3,7 @@
 > Поточная разработка с AI-агентами — на русском языке.
 > Пакет готовых скилов и специализированных агентов для **Claude Code** и **Codex CLI**, которые ведут тебя через весь цикл: от исследования до коммита.
 
-`eda` — это девятнадцать скилов и пакетные агенты для повторяемых ролей. Скил отвечает за пользовательский workflow и оркестрацию, агент — за изолированную работу с закреплённой моделью и ограничениями. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
+`eda` — это двадцать два скила и пакетные агенты для повторяемых ролей. Скил отвечает за пользовательский workflow и оркестрацию, агент — за изолированную работу с закреплённой моделью и ограничениями. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
 
 ---
 
@@ -13,7 +13,7 @@
 npm install -g @gian-tiaga/eda
 ```
 
-Обновляешься с `0.8.x` или более ранней версии? Перед обновлением прочитай [гайд по миграции на 1.0](MIGRATION.md): в релизе изменились имена нескольких скилов, формат Codex-установки и структура `docs/settings.yaml`.
+Обновляешься с `1.x` или более ранней версии? Перед обновлением прочитай [гайд по миграции на 2.0](MIGRATION.md): изменились проверка планов и структура `docs/settings.yaml`.
 
 В корне твоего проекта:
 
@@ -21,9 +21,9 @@ npm install -g @gian-tiaga/eda
 eda init
 ```
 
-Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Устанавливаются и скилы, и агенты. Если `docs/settings.yaml` ещё нет, установщик предложит настройки скилов, а для каждой review-проверки отдельно спросит режим и модели Claude/Codex. В неинтерактивном запуске записывается сбалансированный профиль. В конце `eda init` отдельно пишет, какие скилы и агенты реально установлены или изменились.
+Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Устанавливаются и скилы, и агенты. Если `docs/settings.yaml` ещё нет, установщик предложит настройки скилов, а для каждой проверки `plan-review` и `review` отдельно спросит режим и модели Claude/Codex. В неинтерактивном запуске записывается сбалансированный профиль. В конце `eda init` отдельно пишет, какие скилы и агенты реально установлены или изменились.
 
-`eda update` не перенастраивает полный v2-конфиг: если все обязательные разделы уже есть, команда обновляет пакет без вопросов и сохраняет `docs/settings.yaml` байт-в-байт. Если разделов не хватает, спрашиваются только они и атомарно дописываются в существующий файл; без TTY для них используются defaults. Для отсутствующего файла или версии, отличной от 2, собирается полный v2-профиль.
+`eda update` сохраняет полный валидный v3-конфиг байт-в-байт. Старый, неизвестный или неполный файл разбирается как YAML: известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно записывается как v3. Без TTY используются перенесённые значения и defaults.
 
 Если пакет уже стоит во многих проектах, можно обновить его одной командой:
 
@@ -31,7 +31,7 @@ eda init
 eda update-all ~/Code
 ```
 
-`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть установленный скил, агент или manifest `eda` для Claude/Codex. Перед обновлением команда предлагает настроить один общий профиль для всех проектов или выбрать `skip`. В режиме `skip` вопросы не задаются, существующие `docs/settings.yaml` сохраняются байт-в-байт, а полный профиль defaults создаётся только в проектах без файла. Без TTY автоматически используется `skip`.
+`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть установленный скил, агент или manifest `eda` для Claude/Codex. Перед обновлением команда предлагает настроить один общий профиль для всех проектов или выбрать `skip`. В режиме `skip` полный v3 сохраняется, старые и неполные конфиги индивидуально переносятся, отсутствующие создаются с defaults. Без TTY автоматически используется `skip`.
 
 ---
 
@@ -39,18 +39,21 @@ eda update-all ~/Code
 
 | Скил | Что делает | Куда складывает |
 |---|---|---|
-| `eda-orhestra` | Выполняет настраиваемую цепочку `eda-*`-скилов. Каждый этап запускает в отдельном субагенте с чистым контекстом, включая составные скилы и повторы QA-цикла. По умолчанию: план → выполнение → автономное ревью и исправления → ручные тесты и QA-фиксы. В `orhestra.steps` шаги можно переставлять, отключать и снабжать `args`; для `eda-polish` там же задаются `threshold` и `limit`. В `automatic` безопасно отвечает на рабочие вопросы сам, в `manual` пишет план вместе с человеком. Не коммитит | Артефакты включённых скилов |
+| `eda-orhestra` | Выполняет настраиваемую цепочку `eda-*`-скилов. Каждый этап запускает в отдельном субагенте с чистым контекстом, включая составные скилы и повторы QA-цикла. По умолчанию: план без проверок → полировка плана → выполнение → автономное ревью и исправления → ручные тесты. Если QA нашёл баг, оркестра запускает fix и повторяет только ручной тест. В `orhestra.steps` шаги можно переставлять, отключать и снабжать `args`. Не коммитит | Артефакты включённых скилов |
 | `eda-aim` | Сначала через отдельного агента-планировщика согласует с человеком одну или несколько простых проверяемых целей, затем передаёт их агентам-исполнителям и повторяет работу до независимого подтверждения агентом-проверяющим. При необходимости использует установленные скилы в отдельных изолированных субагентах. В `automatic` отвечает на безопасные рабочие вопросы самостоятельно, в `manual` передаёт их человеку; режим задаётся через `aim.mode` или текущий вызов. Точный список новых целей человек подтверждает всегда | `docs/aims/` и артефакты задействованных скилов |
 | `eda-new-project` | Помогает стартовать новый проект: собирает и согласует требования, функциональность и границы, ограничения и архитектурные драйверы, сравнивает варианты основного стека и фиксирует выбранные компоненты с актуальными стабильными версиями. Не проектирует архитектуру, правила, проверки, AI-скилы или MCP; сохраняет подтверждённый стартовый бриф и всегда без дополнительного вопроса запускает полный технический bootstrap через `eda-prepare-ai` | `docs/project-starts/`, затем артефакты `eda-prepare-ai` |
+| `eda-business` | Совместно с человеком описывает целевое поведение проекта и его бизнес-логику по тематическим карточкам. С указанной темой работает только над ней; без темы анализирует проект, предлагает список и последовательно согласует каждую карточку. Оглавление содержит только описание и ссылку на готовую карточку | `docs/business.md`, `docs/business/` |
 | `eda-roadmap` | Создаёт roadmap-файл: список будущих задач с короткими, понятными и недвусмысленными описаниями без деталей реализации, файлов, библиотек, API и пошагового плана | `docs/roadmaps/` |
-| `eda-explore` | Исследует тему до конкретного результата: описание проблемы, релевантная архитектура, закрытые развилки, риски внутри решений и короткий выбранный вариант решения без плана. Читает только применимые карточки из `docs/references/`, если они есть. В дефолтном режиме ведёт исследование как диалог; для пакетов и ПО проверяет актуальные стабильные версии | `docs/researches/` |
-| `eda-plan` | Пишет план реализации через стандартный Plan Mode хост-агента. `docs/rules.md`, `docs/arch.md` и применимые кодовые эталоны использует как обязательную рамку. В плане явно фиксирует контракты БД/API, прямые зависимости задач и связные фазы, рассчитанные на одного исполнителя. Затем три параллельных субагента/модели проверяют реалистичность, полноту и соблюдение рамки | `docs/plans/` |
-| `eda-plan-polish` | Полирует готовый план до оценки 95/100 или заданного порога. Каждая итерация запускает три изолированных агента, которые проверяют план по правилам, архитектуре, `sources.references`, research и коду. В strict дополнительно запускается кросс-ревью Claude ↔ Codex. Основной агент правит только файл плана и не запускает проверки проекта | `docs/plans/` |
-| `eda-plan-execute` | Управляет выполнением плана по фазам. Каждую фазу целиком выполняет отдельный изолированный субагент: он читает план, правила и архитектуру, а применимые карточки — по ходу работы через индекс `docs/references.md`. Фазы проходят строго последовательно и принимаются независимыми проверяющими. Основной агент отмечает подтверждённые задачи и ведёт журнал | `docs/executions/` |
+| `eda-explore` | Исследует тему до конкретного результата: описание проблемы, релевантная архитектура, закрытые развилки, риски внутри решений и короткий выбранный вариант решения без плана. После определения темы читает только применимые business- и reference-карточки. В дефолтном режиме ведёт исследование как диалог; для пакетов и ПО проверяет актуальные стабильные версии | `docs/researches/` |
+| `eda-plan` | Пишет план реализации через Plan Mode, фиксирует БД/API-контракты, прямые зависимости и связные фазы. По `plan.review` запускает один специализированный `eda-plan-review` и при необходимости один `eda-plan-review-fix`; `plan.strict` независимо включает кросс-CLI ревью | `docs/plans/`, опционально plan-review артефакты |
+| `eda-plan-review` | Параллельно запускает узких read-only агентов требований, правил, архитектуры, реализуемости, исполнения, верификации и применимых API/DB/security/frontend/performance/previous. Дедуплицирует findings, сохраняет стабильные ID и SHA-256, экспертно выставляет score. План не меняет | `docs/plan-reviews/` |
+| `eda-plan-review-fix` | Применяет required и выбранные optional findings только к плану с совпадающим SHA-256. В `apply-optional` сам применяет полезные optional или сохраняет waived с причиной. Новое ревью не делает и код не меняет | `docs/plan-review-fixes/` |
+| `eda-plan-polish` | Оркестрирует изолированный цикл plan-review → plan-review-fix до отсутствия required и score не ниже threshold. По умолчанию максимум три review-итерации; один круг без прогресса немедленно останавливает цикл. Кросс-CLI strict не используется | `docs/plan-reviews/`, `docs/plan-review-fixes/` |
+| `eda-plan-execute` | Управляет выполнением плана по фазам. Каждую фазу целиком выполняет отдельный изолированный субагент: он читает план, правила, архитектуру и только business/reference-карточки затронутого поведения и компонентов. Фазы проходят строго последовательно и принимаются независимыми проверяющими. Основной агент отмечает подтверждённые задачи и ведёт журнал | `docs/executions/` |
 | `eda-fix` | Делает обычные фиксы по короткому контексту, баг-репорту или плану. Перед правками читает правила, архитектуру и только применимые карточки, добавляет нужные тесты, прогоняет проверки и сохраняет историю правок | `docs/fixes/` |
-| `eda-review` | Оркестрирует отдельные read-only проверки корректности, архитектуры, правил, references, плана, качества, тестов, безопасности, производительности, frontend/UI/UX, API, БД, документации и предыдущих ревью. По конфигу запускает только применимые packaged-агенты, объединяет подтверждённые проблемы, ставит экспертную оценку 0–100 и сохраняет покрытие. Без аргументов ревьюит `git diff HEAD`. Код и удалённые обсуждения не меняет | `docs/reviews/` |
+| `eda-review` | Оркестрирует отдельные read-only проверки корректности, архитектуры, правил, references, business-правил, плана, качества, тестов, безопасности, производительности, frontend/UI/UX, API, БД, документации и предыдущих ревью. Business-агент запускается только при применимой карточке и отличает нарушение правила от намеренного изменения правила с устаревшей документацией. Без аргументов ревьюит `git diff HEAD` | `docs/reviews/` |
 | `eda-fix-by-review` | Применяет замечания из ревью с учётом правил, архитектуры и применимых карточек. Обязательные пункты исправляет сразу; optional-пункты спрашивает или решает сам в `apply-optional`. В конце ссылается на отчёт прямо в файле ревью | `docs/review-fixes/` |
-| `eda-manual-test` | Делает ручную smoke/acceptance-проверку после изменений: API прогоняет через `curl`/HTTP-запросы, фронт — через Playwright или доступную browser automation. Сам строит чеклист из входа, плана или diff, запускает очевидные dev/API-серверы и сохраняет QA-отчёт. Не правит код, не пишет автотесты и не коммитит | `docs/manual-tests/` |
+| `eda-manual-test` | Делает ручную smoke/acceptance-проверку после изменений: основной чеклист строит по выполненной задаче и связанному плану/issue/review/fix-отчёту, затем сверяет фактический diff. Применимая business-карточка может добавить только относящийся к задаче инвариант или сценарий; несвязанные карточки не загружаются. Не правит код, не пишет автотесты и не коммитит | `docs/manual-tests/` |
 | `eda-polish` | Оркестрирует доводку изменений: запускает полное `eda-review`, затем `eda-fix-by-review apply-optional` и повторяет цикл до оценки 95/100 или лимита 5 итераций. Обязательные замечания чинятся все, optional-пункты fix-агент применяет или отклоняет с обоснованием. Каждый шаг идёт в изолированном нативном субагенте. Не коммитит | `docs/reviews/`, `docs/review-fixes/` |
 | `eda-send-review` | На `sonnet` / `gpt-5.6-terra` отправляет ревью на GitHub PR через `gh` всегда в едином формате: общий комментарий-сводка плюс комментарии к строкам кода. Без явно указанного типа использует `comment`; `approve` и `request-changes` берёт только из контекста текущего вызова. По настройке может скрыть предыдущие сводки eda-send-review и зарезолвить их inline-треды. По умолчанию шлёт все пункты. Claude-модель закрепляется при установке; Codex-модель хранится как рекомендуемый будущий override | (комментарий в PR) |
 | `eda-commit` | Работает как лёгкий оркестратор одного `haiku` / `gpt-5.6-luna` агента: тот сам собирает git-контекст, выбирает один логический набор файлов, пишет сообщение, точечно коммитит и выполняет явно заданные push/PR/merge-действия. В Claude Code сам оркестратор закреплён за `haiku`; в Codex остаётся на активной модели сессии из-за отсутствия per-skill override. При неоднозначном составе или вероятном секрете агент блокируется до индексации. Если продолжение не задано, предлагает применимые варианты | (git, опционально GitHub PR) |
@@ -59,6 +62,12 @@ eda update-all ~/Code
 | `eda-prepare-ai` | Выполняет технический bootstrap нового или существующего проекта: проектирует архитектуру, строгие правила и профиль инструментов, проходит полный каталог автоматических проверок, подбирает применимые AI-скилы, роли и MCP, затем создаёт AI-документацию. Подтверждённые требования, стек и архитектурные драйверы из `eda-new-project` принимает как обязательный вход и не переоткрывает без обнаруженного конфликта. Для пустого проекта не выдумывает reference-карточки и не выдаёт неустановленные инструменты за доступные | `docs/rules.md`, `docs/arch.md`, `docs/references.md`, `docs/references/`, `AGENTS.md`, `CLAUDE.md` |
 | `eda-discover-automations` | Проводит baseline gap-аудит проекта даже без истории, а при наличии анализирует ревью, планы и фиксы. Не ограничивает число предложений: проверяет тесты/e2e, стиль, статанализ, границы модулей, конфиги/IaC, API/БД, security/supply chain, performance, release, эксплуатацию, browser MCP и MCP стека. Для каждой идеи даёт команду, контур запуска и приоритет; ничего не внедряет | `docs/automations/` |
 
+### Business-контекст
+
+`eda-business` хранит в `docs/business.md` только простое оглавление из двух колонок — описание темы и ссылка на готовую согласованную карточку. Сами карточки описывают целевое поведение, требования, бизнес-сценарии и критерии приёмки; последним разделом отдельно перечисляют расхождения с текущей реализацией.
+
+Потребляющий скил сначала определяет текущую задачу и фактически затронутое поведение, а затем выбирает по описаниям только применимые business-карточки. Отсутствие подходящей карточки не является ошибкой и не требует загружать остальные. Если задача противоречит карточке, агент показывает конфликт и спрашивает человека, изменить задачу или пересогласовать правило через `eda-business`.
+
 `eda-review-check` выведен из эксплуатации: его специализированные проверки теперь входят прямо в `eda-review`. `eda-execute` переименован в `eda-plan-execute`, `eda-automate` — в `eda-discover-automations`, `eda-docs` — в `eda-prepare-ai`, а `eda-start` — в `eda-new-project`. Контекстный агент `eda-commit-context` также выведен из эксплуатации: сбор контекста теперь выполняет единый `eda-commit-executor`. При обновлении старые имена удаляются из целевых сред. Установщик удаляет только управляемые EDA-копии retired-компонентов и не трогает чужие компоненты.
 
 ### Экстремальный профиль проверок
@@ -81,10 +90,23 @@ eda update-all ~/Code
 | `eda-commit-executor` | `haiku` | `gpt-5.6-luna` | Собирает git-контекст, выбирает один логический набор файлов, точечно коммитит и выполняет явно разрешённые push/PR/merge-действия |
 | `eda-worktree-executor` | `haiku` | `gpt-5.6-luna` | Создаёт соседний worktree и одноимённую ветку, не изменяя файлы проекта |
 | `eda-merge-worktree-executor` | `haiku` | `gpt-5.6-luna` | Мержит ветку из соседнего worktree в текущую без cleanup и ручного разрешения конфликтов |
+| `eda-plan-review-requirements` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет задачу, scope, критерии готовности и business-требования |
+| `eda-plan-review-rules` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Проверяет применимые инструкции и правила проекта |
+| `eda-plan-review-architecture` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет архитектурные границы и зависимости плана |
+| `eda-plan-review-feasibility` | `opus`, read-only | `gpt-5.6-sol`, read-only | Сверяет реализуемость плана с фактическим кодом |
+| `eda-plan-review-execution` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет фазы, ID, зависимости и размер исполнительского прохода |
+| `eda-plan-review-verification` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет тесты, команды, логирование и эксплуатацию |
+| `eda-plan-review-api` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет API, события, очереди и внешние интеграции |
+| `eda-plan-review-database` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет данные, миграции, индексы, backfill и rollback |
+| `eda-plan-review-security` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет auth, permissions, ввод, секреты и чувствительные данные |
+| `eda-plan-review-frontend` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет пользовательские сценарии и состояния UI |
+| `eda-plan-review-performance` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет нагрузку, запросы, конкурентность и горячие пути |
+| `eda-plan-review-previous` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Сверяет закрытие предыдущих findings по связанной SHA-256 цепочке |
 | `eda-review-correctness` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет функциональную корректность и крайние случаи |
 | `eda-review-architecture` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет архитектурные границы и зависимости |
 | `eda-review-rules` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Проверяет инструкции и правила проекта |
 | `eda-review-references` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Проверяет применимые эталонные карточки |
+| `eda-review-business` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет изменённое поведение по применимым business-карточкам |
 | `eda-review-plan-alignment` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет соответствие реализации плану |
 | `eda-review-code-quality` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет читаемость, сложность и поддерживаемость |
 | `eda-review-tests` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет тестовое покрытие и корректность тестов |
@@ -112,11 +134,13 @@ eda update-all ~/Code
 
 | Скил | Флаг | Что включает | Когда стоит использовать |
 |---|---|---|---|
-| `eda-orhestra` | `automatic` / `manual`, `без полировки`, `полировка N итераций`, `без ручных тестов` | Разово меняет режим, состав цепочки и параметры шагов поверх `docs/settings.yaml` | Когда нужно довести задачу по сохранённому workflow или временно сократить дорогие этапы |
+| `eda-orhestra` | `automatic` / `manual`, `без полировки плана`, `без полировки кода`, `полировка кода N итераций`, `без ручных тестов` | Разово меняет режим, состав цепочки и параметры шагов поверх `docs/settings.yaml` | Когда нужно довести задачу по сохранённому workflow или временно сократить дорогие этапы |
 | `eda-aim` | `automatic` / `manual` | Разово меняет способ ответа на рабочие вопросы поверх `aim.mode`; подтверждение точного списка новых целей остаётся обязательным | Автономная работа или совместное прохождение развилок с человеком |
 | `eda-explore` | `strict` | После сохранения отчёта отдаёт его соседнему CLI (Claude → Codex или наоборот) на критическое ревью конкретности, фактов, развилок, рисков и версий; затем доправляет отчёт по замечаниям | Серьёзные исследования, которые лягут в основу больших решений; когда хочется второго мнения от другой модели/среды |
-| `eda-plan` | `strict` | После обычного мета-ревью трёх субагентов/моделей отдаёт план соседнему CLI на дополнительный круг проверки; доправляет план | Большие или ответственные планы, особенно затрагивающие смежные системы |
-| `eda-plan-polish` | `strict` | В каждой итерации после трёх полных ревью плана отдаёт план соседнему CLI (Claude → Codex или Codex → Claude) на кросс-ревью; затем учитывает его в итоговой оценке и правках | Максимальная полировка ответственных планов перед `eda-plan-execute` |
+| `eda-plan` | `strict`, `без ревью плана`, `без проверок` | `strict` независимо включает кросс-CLI проверку; `без ревью плана` отключает встроенный review/fix; `без проверок` отключает оба вида ревью | Когда нужно разделить создание плана и его последующую полировку |
+| `eda-plan-review` | `threshold N`, `без X`, `включи X`, `<check> на <model>` | Разово меняет gate, применимые проверки и их модели | Для самостоятельного аудита готового плана |
+| `eda-plan-review-fix` | `apply-optional` | Применяет required и самостоятельно разбирает optional, сохраняя waived с причинами | Для автономной правки плана и внутри `eda-plan-polish` |
+| `eda-plan-polish` | `threshold N`, `limit N` | Меняет gate и максимальное число подтверждающих review-итераций | Для доводки ответственных планов перед `eda-plan-execute` |
 | `eda-fix-by-review` | `apply-optional` | Применяет все обязательные пункты, а пункты «на усмотрение автора» разбирает без вопроса: применяет выбранные и отклоняет нецелесообразные с причиной | Для автономной доводки, прежде всего внутри `eda-polish` |
 
 ---
@@ -128,7 +152,7 @@ eda update-all ~/Code
 Файл по умолчанию:
 
 ```yaml
-version: 2
+version: 3
 
 orhestra:
   # Режим полного цикла eda-orhestra.
@@ -140,6 +164,11 @@ orhestra:
       skill: eda-plan
       enabled: true
       # Строка аргументов передаётся скиллу как часть текущего вызова.
+      args: "без проверок"
+    - id: plan-polish
+      skill: eda-plan-polish
+      enabled: true
+      # Строка аргументов передаётся скиллу как часть текущего вызова.
       args: ""
     - id: execute
       skill: eda-plan-execute
@@ -162,7 +191,6 @@ orhestra:
         args: ""
         # После исправления повторно запускаются включённые шаги с этими id.
         then:
-          - polish
           - manual-test
         max_cycles: 5
 
@@ -183,6 +211,9 @@ plan:
   # Включает кросс-CLI ревью в eda-plan.
   # true | false
   strict: false
+  # Запускает один eda-plan-review и при необходимости один eda-plan-review-fix.
+  # true | false
+  review: true
   # Задаёт размер плана.
   # normal | short | ask_each_time
   size: normal
@@ -196,10 +227,50 @@ plan:
   # debug_precise | standard | ask_each_time
   logging_strategy: ask_each_time
 
+plan-review:
+  # План готов без required findings и при score не ниже threshold.
+  threshold: 95
+  agents:
+    requirements:
+      mode: always
+      model: { claude: sonnet, codex: gpt-5.6-terra }
+    rules:
+      mode: always
+      model: { claude: haiku, codex: gpt-5.6-luna }
+    architecture:
+      mode: always
+      model: { claude: opus, codex: gpt-5.6-sol }
+    feasibility:
+      mode: always
+      model: { claude: opus, codex: gpt-5.6-sol }
+    execution:
+      mode: always
+      model: { claude: sonnet, codex: gpt-5.6-terra }
+    verification:
+      mode: always
+      model: { claude: sonnet, codex: gpt-5.6-terra }
+    api:
+      mode: auto
+      model: { claude: sonnet, codex: gpt-5.6-terra }
+    database:
+      mode: auto
+      model: { claude: opus, codex: gpt-5.6-sol }
+    security:
+      mode: auto
+      model: { claude: opus, codex: gpt-5.6-sol }
+    frontend:
+      mode: auto
+      model: { claude: sonnet, codex: gpt-5.6-terra }
+    performance:
+      mode: auto
+      model: { claude: opus, codex: gpt-5.6-sol }
+    previous:
+      mode: auto
+      model: { claude: haiku, codex: gpt-5.6-luna }
+
 plan-polish:
-  # Включает кросс-CLI ревью в eda-plan-polish.
-  # true | false
-  strict: false
+  # Максимальное число подтверждающих review-итераций.
+  limit: 3
 
 review:
   # Каждая проверка имеет собственный режим запуска и модели для обеих сред.
@@ -239,6 +310,14 @@ review:
         claude: haiku
         codex: gpt-5.6-luna
 
+    # Проверяет изменённое поведение по применимым карточкам из docs/business/.
+    # В auto запускается только когда изменения затрагивают поведение с применимой business-карточкой.
+    business:
+      mode: auto
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
     # Проверяет, что реализация соответствует указанному или однозначно найденному плану.
     # В auto запускается только когда у ревью есть конкретный план.
     plan_alignment:
@@ -337,18 +416,20 @@ discover-automations:
 - `steps[].on_failure` — настраивает исправление failed manual-test прямо рядом с этим шагом: `skill` и `args` задают фикс, `then` — повторяемые id шагов, `max_cycles` — лимит. Если обработчика нет, оркестратор сохраняет failed-отчёт и останавливается.
 - `aim.mode` — `automatic` самостоятельно выбирает безопасные ответы на рабочие вопросы; `manual` передаёт вопросы человеку. Явный режим в текущем вызове имеет приоритет.
 - `explore.strict` и `explore.decision_mode` — кросс-CLI ревью и способ выбора по исследовательским развилкам в `eda-explore`.
-- `plan.strict`, `plan.size`, `plan.decision_mode`, `plan.test_strategy`, `plan.logging_strategy` — режим и структура работы `eda-plan`.
-- `plan-polish.strict` — кросс-CLI ревью в каждой итерации `eda-plan-polish`.
+- `plan.review` — один `eda-plan-review` и при необходимости один `eda-plan-review-fix` внутри `eda-plan`; `plan.strict` независимо управляет кросс-CLI ревью.
+- `plan.size`, `plan.decision_mode`, `plan.test_strategy`, `plan.logging_strategy` — режим и структура работы `eda-plan`.
+- `plan-review.threshold` — минимальный экспертный score при отсутствии required findings; `plan-review.agents` задаёт mode и модели специализированных проверок.
+- `plan-polish.limit` — максимальное число подтверждающих review-итераций; default `3`.
 - `review.agents.<check>.mode` — запускать проверку всегда, автоматически по контексту или отключить.
 - `review.agents.<check>.model.claude` и `.codex` — модель конкретной проверки в соответствующей среде.
 - `send-review.close_previous_reviews` — после успешной новой отправки скрывает предыдущие сводки, созданные `eda-send-review` текущим GitHub-пользователем, и резолвит связанные inline-треды; прямое указание в текущем запросе переопределяет настройку.
-- `discover-automations.include_plans` — добавляет `docs/plans/` в обычный запуск `eda-discover-automations`. Если в существующем v2-файле остался только прежний раздел `automate`, скил временно использует его как fallback и просит переименовать настройку.
+- `discover-automations.include_plans` — добавляет `docs/plans/` в обычный запуск `eda-discover-automations`.
 
-Каждый скилл читает только свой раздел. Для `eda-review` прямое указание в текущем запросе может разово включить или отключить проверку и заменить её модель, например: «без performance, architecture на opus».
+Каждый скилл читает только свой раздел. Для `eda-review` прямое указание в текущем запросе может разово включить или отключить проверку и заменить её модель, например: «без performance, включи business, architecture на opus».
 
-Поддерживается только `version: 2`. Для старого v2 без `review.agents` новый review использует сбалансированные defaults и предупреждает, что устаревшие `review.strict`, `review.include_code_quality` и `review-check` игнорируются. Установщик существующий файл не переписывает.
+Поддерживается только `version: 3`. Полный валидный v3 установщик сохраняет байт-в-байт. Старые, неизвестные и неполные файлы разбираются через YAML: валидные известные значения переносятся, в TTY спрашиваются только отсутствующие, затем профиль целиком атомарно нормализуется. Без TTY недостающие поля получают defaults. `plan.meta_review` переносится в `plan.review`, а `plan-polish.strict` удаляется.
 
-`eda init` создаёт `docs/settings.yaml`, только если файла ещё нет; существующий v1 автоматически мигрируется в v2, а v2 и неизвестные версии сохраняются. `eda update` сохраняет полный v2-файл без вопросов, а в неполный v2 атомарно дописывает только отсутствующие разделы после вопросов только по ним; без TTY используются defaults недостающих разделов. Для отсутствующего файла или другой версии команда заново собирает полный v2-профиль. `eda update-all` предлагает общий профиль с перезаписью или `skip`, который сохраняет существующие файлы и создаёт defaults только при их отсутствии. Без TTY используется `skip`.
+`eda update-all configure` записывает один общий v3-профиль. `skip` сохраняет полный v3, индивидуально переносит остальные конфиги и создаёт defaults при отсутствии файла. Подробности перехода приведены в [MIGRATION.md](MIGRATION.md)
 
 ---
 
@@ -359,9 +440,9 @@ discover-automations:
 Каждая стрелка между этапами передаёт только явный вход и пути к артефактам: каждый этап работает в новом изолированном субагенте без истории диалога.
 
 ```text
-plan → plan-execute → polish → manual-test ──passed──> готово
-                           ^          │
-                           └── fix <───┘ failed
+plan без проверок → plan-polish → plan-execute → polish → manual-test ──passed──> готово
+                                                                  ^          │
+                                                                  └── fix <───┘ failed
 ```
 
 `eda-aim` может обернуть любую цепочку ниже в автономный цикл:
@@ -394,14 +475,14 @@ roadmap ────────> explore ─────> plan ───> plan-
                                                       fix ─────────────> manual-test
 
 polish = полное review ─> fix-by-review apply-optional ─> повтор до нужной оценки
-plan-polish = 3 полных ревью плана разными моделями ─> strict: кросс-CLI ─> оценка ─> правка плана ─> повтор до 95/100
+plan-polish = специализированный plan-review ─> plan-review-fix apply-optional ─> подтверждающий review до gate или limit
 
 discover-automations может запускаться от review, fix-by-review или fix.
 ```
 
 `eda-manual-test` обычно ставится после `eda-plan-execute`, `eda-fix` или `eda-fix-by-review`, чтобы руками проверить API/UI перед ревью или коммитом.
 
-Использовать всю цепочку не обязательно — каждый скил самодостаточен. Для полного прохода одной задачи можно вызвать `eda-orhestra automatic <задача>` или `eda-orhestra manual <задача>`. Разовые варианты: `eda-orhestra automatic без полировки <задача>`, `eda-orhestra полировка 2 итерации <задача>`, `eda-orhestra без ручных тестов <задача>`. Постоянный порядок и аргументы задаются в `orhestra.steps`. Новый проект можно начать с `eda-new-project`; существующий — с `eda-prepare-ai`, `eda-roadmap`, `eda-explore`, или сразу с `eda-plan-execute` на готовом плане, или просто `eda-commit`, когда правки уже сделаны. Для параллельной работы есть `eda-worktree`, а для возврата ветки из worktree в текущую ветку — `eda-merge-worktree`.
+Использовать всю цепочку не обязательно — каждый скил самодостаточен. Для полного прохода одной задачи можно вызвать `eda-orhestra automatic <задача>` или `eda-orhestra manual <задача>`. Разовые варианты: `eda-orhestra automatic без полировки плана <задача>`, `eda-orhestra полировка кода 2 итерации <задача>`, `eda-orhestra без ручных тестов <задача>`. Постоянный порядок и аргументы задаются в `orhestra.steps`. Новый проект можно начать с `eda-new-project`; существующий — с `eda-prepare-ai`, `eda-roadmap`, `eda-explore`, или сразу с `eda-plan-execute` на готовом плане, или просто `eda-commit`, когда правки уже сделаны. Для параллельной работы есть `eda-worktree`, а для возврата ветки из worktree в текущую ветку — `eda-merge-worktree`.
 
 Например, запрос `eda-commit сразу отправь ветку, создай PR и дай ссылку` выполняет всю указанную цепочку без отдельного вопроса после коммита.
 
@@ -457,7 +538,7 @@ eda update-all ~/Code
 | Агент | `.claude/agents/<agent>.md` | `.codex/agents/<agent>.toml` |
 | Manifest владения | `.claude/eda-manifest.json` | `.codex/eda-manifest.json` |
 
-`eda update` сохраняет полный v2-конфиг как есть или дополняет только отсутствующие разделы, затем идемпотентно синхронизирует обе группы компонентов и отдельно показывает реально изменившиеся скилы и агенты. Manifest хранит только идентификаторы компонентов, которыми владеет `eda`: благодаря этому retired-компоненты удаляются, а чужие скилы и агенты остаются нетронутыми. `eda update-all [dir]` либо один раз собирает и записывает общий конфиг, либо в режиме `skip` сохраняет существующие настройки и создаёт defaults только при отсутствии файла; после этого синхронизирует компоненты каждого проекта. Старые Codex-файлы `.codex/skills/<skill>.md` также удаляются при миграции.
+`eda update` сохраняет полный v3-конфиг как есть, а старый или неполный умно переносит и целиком нормализует; затем идемпотентно синхронизирует обе группы компонентов и отдельно показывает реально изменившиеся скилы и агенты. Manifest хранит только идентификаторы компонентов, которыми владеет `eda`: retired-компоненты удаляются, а чужие скилы и агенты остаются нетронутыми. `eda update-all [dir]` либо записывает общий профиль, либо в `skip` сохраняет полный v3 и переносит остальные настройки. Старые Codex-файлы `.codex/skills/<skill>.md` также удаляются при миграции.
 
 Установленные копии не являются источником правды. Локальные изменения внутри `.claude/skills/eda-*`, `.codex/skills/eda-*`, `.claude/agents/eda-*` или `.codex/agents/eda-*` будут заменены следующим обновлением.
 

package/agents/eda-plan-review-api/agent.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": 1,
+  "name": "eda-plan-review-api",
+  "description": "Проверяет API, события, очереди, интеграции и совместимость контрактов в плане.",
+  "models": { "claude": "sonnet", "codex": "gpt-5.6-terra" },
+  "reasoning": { "claude": "medium", "codex": "medium" },
+  "access": "read-only",
+  "maxTurns": 30
+}

package/agents/eda-plan-review-api/prompt.md

@@ -0,0 +1,34 @@
+# Роль
+
+Ты — read-only проверяющий API и интеграций для `eda-plan-review`. Проверяй только HTTP/RPC/GraphQL-контракты, DTO, события, очереди, webhooks и внешние сервисы.
+
+## Вход и работа
+
+Получи рабочую директорию, `PLAN_FILE`, `PLAN_SHA256`, `REFERENCE_FILES`, `MODEL` и `PLAN_CONTEXT`. Если план не затрагивает API или интеграции, верни `not_applicable`. Иначе прочитай существующие handlers, схемы и применимые карточки.
+
+Проверяй method/path, auth, request/query/body, response, errors/status codes, идемпотентность и обратную совместимость. Не выполняй общее ревью архитектуры, требований или тестов. Не правь файлы.
+
+## Результат
+
+Верни один YAML-блок:
+
+```yaml
+status: completed | not_applicable | blocked
+check: api
+model: <MODEL>
+summary: <краткий итог>
+findings:
+  - fingerprint: <api|plan-location|root-cause>
+    severity: critical | high | medium | low
+    recommendation: required | optional
+    plan_location: <раздел или задача плана>
+    problem: <дефект контракта>
+    evidence: [<план, схема или код>]
+    impact: <риск для клиента или интеграции>
+    fix: <конкретное уточнение контракта>
+    acceptance: <как подтвердить закрытие>
+prior_findings: []
+question: <блокер или null>
+```
+
+При отсутствии проблем верни `findings: []`. Не выставляй score.

package/agents/eda-plan-review-architecture/agent.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": 1,
+  "name": "eda-plan-review-architecture",
+  "description": "Проверяет архитектурные границы, зависимости и соответствие плана docs/arch.md.",
+  "models": { "claude": "opus", "codex": "gpt-5.6-sol" },
+  "reasoning": { "claude": "high", "codex": "high" },
+  "access": "read-only",
+  "maxTurns": 30
+}