@gian-tiaga/eda 0.8.6 → 1.0.0

package/README.md

@@ -1,9 +1,9 @@
 # 🌊 eda
 
 > Поточная разработка с AI-агентами — на русском языке.
-> Набор готовых скилов для **Claude Code** и **Codex CLI**, которые ведут тебя через весь цикл: от исследования до коммита.
+> Пакет готовых скилов и специализированных агентов для **Claude Code** и **Codex CLI**, которые ведут тебя через весь цикл: от исследования до коммита.
 
-`eda` — это восемнадцать скилов, каждый отвечает за свой кусок работы. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
+`eda` — это девятнадцать скилов и пакетные агенты для повторяемых ролей. Скил отвечает за пользовательский workflow и оркестрацию, агент — за изолированную работу с закреплённой моделью и ограничениями. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
 
 ---
 
@@ -13,21 +13,23 @@
 npm install -g @gian-tiaga/eda
 ```
 
+Обновляешься с `0.8.x` или более ранней версии? Перед обновлением прочитай [гайд по миграции на 1.0](MIGRATION.md): в релизе изменились имена нескольких скилов, формат Codex-установки и структура `docs/settings.yaml`.
+
 В корне твоего проекта:
 
 ```bash
 eda init
 ```
 
-Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Если `docs/settings.yaml` ещё нет, установщик также предложит выбрать настройки скилов и создаст этот файл. В конце `eda init` пишет, какие скилы реально установлены или изменились.
+Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Устанавливаются и скилы, и агенты. Если `docs/settings.yaml` ещё нет, установщик предложит настройки скилов, а для каждой review-проверки отдельно спросит режим и модели Claude/Codex. В неинтерактивном запуске записывается сбалансированный профиль. В конце `eda init` отдельно пишет, какие скилы и агенты реально установлены или изменились.
 
-Если скилы уже стоят во многих проектах, можно обновить их одной командой:
+Если пакет уже стоит во многих проектах, можно обновить его одной командой:
 
 ```bash
 eda update-all ~/Code
 ```
 
-`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть `.claude/skills` или `.codex/skills`. Команда обновляет только найденные среды и не создаёт `docs/settings.yaml`, чтобы массовый запуск не добавлял новые файлы в проекты.
+`eda update-all` ищет проекты в указанной директории, её прямых подпапках и подпапках второго уровня. Проект считается найденным, если в нём уже есть установленный скил, агент или manifest `eda` для Claude/Codex. Команда обновляет только найденные среды и не создаёт `docs/settings.yaml`, чтобы массовый запуск не добавлял новые файлы в проекты.
 
 ---
 
@@ -35,41 +37,85 @@ eda update-all ~/Code
 
 | Скил | Что делает | Куда складывает |
 |---|---|---|
-| `eda-start` | Помогает стартовать новый проект: собирает требования, вместе с пользователем выбирает стек, архитектуру, инструменты качества кода, AI-скилы, агентные инструкции, MCP-серверы и правила проекта. Для выбранных пакетов всегда ищет последние стабильные версии по официальным источникам. Не пишет код и не ставит зависимости; сохраняет согласованные стартовые решения и по подтверждению создаёт черновики правил/архитектуры/AGENTS | `docs/project-starts/`, опционально `docs/rules.md`, `docs/arch.md`, `AGENTS.md` |
+| `eda-orhestra` | Выполняет настраиваемую цепочку `eda-*`-скилов. Каждый этап запускает в отдельном субагенте с чистым контекстом, включая составные скилы и повторы QA-цикла. По умолчанию: план → выполнение → автономное ревью и исправления → ручные тесты и QA-фиксы. В `orhestra.steps` шаги можно переставлять, отключать и снабжать `args`; для `eda-polish` там же задаются `threshold` и `limit`. В `automatic` безопасно отвечает на рабочие вопросы сам, в `manual` пишет план вместе с человеком. Не коммитит | Артефакты включённых скилов |
+| `eda-aim` | Сначала через отдельного агента-планировщика согласует с человеком одну или несколько простых проверяемых целей, затем передаёт их агентам-исполнителям и повторяет работу до независимого подтверждения агентом-проверяющим. При необходимости использует установленные скилы в отдельных изолированных субагентах. В `automatic` отвечает на безопасные рабочие вопросы самостоятельно, в `manual` передаёт их человеку; режим задаётся через `aim.mode` или текущий вызов. Точный список новых целей человек подтверждает всегда | `docs/aims/` и артефакты задействованных скилов |
+| `eda-new-project` | Помогает стартовать новый проект: собирает и согласует требования, функциональность и границы, ограничения и архитектурные драйверы, сравнивает варианты основного стека и фиксирует выбранные компоненты с актуальными стабильными версиями. Не проектирует архитектуру, правила, проверки, AI-скилы или MCP; сохраняет подтверждённый стартовый бриф и всегда без дополнительного вопроса запускает полный технический bootstrap через `eda-prepare-ai` | `docs/project-starts/`, затем артефакты `eda-prepare-ai` |
 | `eda-roadmap` | Создаёт roadmap-файл: список будущих задач с короткими, понятными и недвусмысленными описаниями без деталей реализации, файлов, библиотек, API и пошагового плана | `docs/roadmaps/` |
-| `eda-explore` | Исследует тему до конкретного результата: описание проблемы, релевантная архитектура, закрытые развилки, риски внутри решений и короткий выбранный вариант решения без плана. В дефолтном режиме ведёт исследование как диалог: факты собирает сам, а значимые развилки выносит тебе с рекомендацией. Если нужны пакеты или ПО — проверяет актуальные стабильные версии через context7 или web search | `docs/researches/` |
-| `eda-plan` | Пишет план реализации через стандартный Plan Mode хост-агента. `docs/rules.md` и `docs/arch.md` использует как обязательную рамку, а не справочный контекст: план должен строго следовать правилам и архитектуре. В плане явно фиксирует контракты БД/API, если задача их затрагивает. Затем три параллельных субагента/модели (слабая, средняя, мощная) проверяют план на реалистичность, пропущенные шаги и нарушения правил — главный планировщик сам решает, что применить | `docs/plans/` |
-| `eda-plan-polish` | Полирует уже готовый план до оценки 95/100 или заданного порога. Каждая итерация сразу запускает три изолированных параллельных агента на быстрой, кодовой и флагманской моделях. В strict дополнительно отдаёт план соседнему CLI (Claude ↔ Codex) на кросс-ревью. Основной агент после ответов выставляет оценку, анализирует предложения, содержательно правит только файл плана при оценке ниже порога и не запускает проверки проекта | `docs/plans/` |
-| `eda-execute` | Выполняет план. Спрашивает, где работать (текущая ветка, новая ветка, отдельный worktree). Перед правками читает план, `docs/rules.md` и `docs/arch.md`; правила и архитектура обязательны к исполнению. Если шаг плана им противоречит, останавливается и спрашивает. Тесты пишет внутри каждого шага. В конце — полный прогон тестов и линтеров | `docs/executions/` |
-| `eda-fix` | Делает обычные фиксы по короткому контексту, баг-репорту или файлу плана. Перед правками читает правила и архитектуру, добавляет нужные тесты, прогоняет проверки и сохраняет историю правок | `docs/fixes/` |
-| `eda-review` | Делает код-ревью с оценкой 0–100 и сверкой с планом работ, но в файл пишет только проблемы: ошибки, недоделки, неточности, нарушения правил/архитектуры, риски и недостающие тесты. Сверяет с планом, только если он указан или однозначно найден; иначе ревьюит без сверки с планом и про план не спрашивает. Без аргументов ревьюит незакоммиченный `git diff HEAD`. Не перечисляет выполненную работу. В обычном режиме после черновика передаёт файл в `eda-review-check`; с флагом `draft` сохраняет только первичное ревью без субагентов | `docs/reviews/` |
-| `eda-review-check` | Проверяет готовое ревью из `docs/reviews/` специализированными субагентами: архитектуру, правила, выполнение плана при указанном plan-файле и при включённой настройке качество кода. В строгом режиме добавляет кросс-ревью между Claude и Codex. Сам применяет подтверждённые замечания к файлу ревью, но не правит код | `docs/reviews/` |
-| `eda-fix-by-review` | Применяет замечания из ревью. Обязательные — все сразу. Optional-пункты в обычном режиме спрашивает, а в `apply-optional` сам решает: применяет полезные, отклонённые обосновывает в отчёте. В конце ссылается на отчёт прямо в файле ревью | `docs/review-fixes/` |
+| `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/executions/` |
+| `eda-fix` | Делает обычные фиксы по короткому контексту, баг-репорту или плану. Перед правками читает правила, архитектуру и только применимые карточки, добавляет нужные тесты, прогоняет проверки и сохраняет историю правок | `docs/fixes/` |
+| `eda-review` | Оркестрирует отдельные read-only проверки корректности, архитектуры, правил, references, плана, качества, тестов, безопасности, производительности, frontend/UI/UX, API, БД, документации и предыдущих ревью. По конфигу запускает только применимые packaged-агенты, объединяет подтверждённые проблемы, ставит экспертную оценку 0–100 и сохраняет покрытие. Без аргументов ревьюит `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-polish` | Оркестрирует доводку изменений: запускает `eda-review draft`, затем `eda-review-check`, затем `eda-fix-by-review apply-optional` и повторяет цикл до оценки 95/100 или лимита 5 итераций. Обязательные замечания чинятся все, optional-пункты fix-агент применяет или отклоняет сам с обоснованием. Каждый шаг идёт в изолированном субагенте или отдельном CLI-процессе. Не коммитит | `docs/reviews/`, `docs/review-fixes/` |
-| `eda-send-review` | Отправляет ревью на GitHub PR через `gh` всегда в едином формате: общий комментарий-сводка плюс комментарии к строкам кода. Тип (`comment`/`approve`/`request-changes`) задаёт только статус review; `approve` и `request-changes` подтверждаются. По умолчанию шлёт все пункты. Сам определяет PR по текущей ветке | (комментарий в PR) |
-| `eda-commit` | Делает один аккуратный коммит в стиле проекта. В конце спрашивает: push, merge в main + удалить ветку, или ничего | (git) |
-| `eda-worktree` | Создаёт git worktree рядом с основным проектом в папке `{name}-work-{n}` и одноимённую ветку. Базу берёт из аргумента или спрашивает | соседняя папка `{name}-work-{n}` |
-| `eda-merge-worktree` | Мержит ветку из соседнего worktree в текущую ветку. Принимает номер `1`, короткое имя `work-1` или полное имя `{name}-work-1`. Worktree и ветку после merge не удаляет | (git) |
-| `eda-docs` | Создаёт или обновляет `docs/rules.md` (максимально строгие правила для твоего стека), `docs/arch.md` (архитектура проекта) и шапку `AGENTS.md`. Может предлагать инструменты, которых ещё нет в проекте | `docs/rules.md`, `docs/arch.md`, `AGENTS.md` |
-| `eda-automate` | Анализирует историю ревью и фиксов. Если ошибка повторяется — предлагает автоматизации на уровне языка и тулчейна: линтеры, статанализаторы, typecheck, тесты, pre-commit/CI-проверки. Если кодовая проверка не подходит, может предложить MCP-сервер, агентную проверку, новый скил или уточнение правил/архитектуры | `docs/automations/` |
+| `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` собирает контекст, затем `sonnet` / `gpt-5.6-terra` пишет сообщение и коммитит. В Claude Code сам оркестратор закреплён за `haiku`; в Codex остаётся на активной модели сессии из-за отсутствия per-skill override. Явно заданные рядом с вызовом действия выполняет без повторного вопроса: например, отправляет ветку, создаёт PR и возвращает ссылку. Если продолжение не задано, предлагает применимые варианты | (git, опционально GitHub PR) |
+| `eda-worktree` | На `haiku` / `gpt-5.6-luna` создаёт через пакетного агента git worktree рядом с основным проектом в папке `{name}-work-{n}` и одноимённую ветку. Базу берёт из аргумента или спрашивает | соседняя папка `{name}-work-{n}` |
+| `eda-merge-worktree` | На `haiku` / `gpt-5.6-luna` мержит через пакетного агента ветку из соседнего worktree в текущую ветку. Принимает номер `1`, короткое имя `work-1` или полное имя `{name}-work-1`. Worktree и ветку после merge не удаляет | (git) |
+| `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/` |
+
+`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-копии retired-скилов и не трогает чужие компоненты.
+
+### Экстремальный профиль проверок
+
+`eda-prepare-ai` и `eda-discover-automations` проходят не короткий список, а полный стек-зависимый каталог. В него входят unit/integration/component/contract/API/e2e/smoke/regression-тесты; property-based, mutation и fuzz; visual regression, accessibility и cross-browser; форматирование, lint, сложность, дубли и dead code; typecheck, taint и sanitizers; границы модулей, циклы и направления зависимостей; валидация env, CI, Docker, Kubernetes, Terraform и других конфигов; API/схемы и migrations; security, supply chain и SBOM; performance/load/soak/chaos; reproducible build, compatibility и release checks; документация, observability, backup/restore, доменные инварианты и AI evals.
+
+Для каждой применимой проверки скил указывает инструмент, точную команду или сценарий, риск и место запуска: `pre-commit`, `pre-push`, `PR CI`, `nightly`, `release`, `post-deploy` или `MCP/manual`. Browser/Playwright MCP и MCP выбранного стека рассматриваются отдельно и не подменяют детерминированные CLI/CI-проверки. Фиксированного лимита предложений нет; неприменимые группы должны иметь явное обоснование.
+
+`eda-prepare-ai` разбирает значимые настройки каждого выбранного инструмента и предлагает самый строгий стабильный применимый профиль, а не конфигурацию по умолчанию. Для динамических и слаботипизированных языков это включает строгий typecheck, nullability, типизированные публичные контракты и runtime-валидацию внешних данных; для линтеров, статанализа, тестов, security и CI — максимальные полезные наборы проверок, нулевой бюджет предупреждений и явное обоснование каждого ослабления.
+
+---
+
+## 🤖 Пакетные агенты
+
+| Агент | Claude Code | Codex | Роль |
+|---|---|---|---|
+| `eda-aim-planner` | `sonnet`, workspace-write | `gpt-5.6-terra`, workspace-write | Задаёт вопросы, формулирует простой проверяемый список и создаёт файл только после подтверждения человека |
+| `eda-aim-executor` | `opus`, workspace-write | `gpt-5.6-sol`, workspace-write | Выполняет назначенные пункты, при необходимости запрашивает установленные скилы для запуска в изолированных субагентах и дополняет общий журнал |
+| `eda-aim-verifier` | `opus`, workspace-write | `gpt-5.6-sol`, workspace-write | Независимо проверяет каждый критерий, отмечает подтверждённые цели и возвращает пробелы на новый круг выполнения |
+| `eda-commit-context` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Собирает git-контекст, правила, стиль истории, состав изменений и риски; ничего не меняет |
+| `eda-commit-executor` | `sonnet` | `gpt-5.6-terra` | Формирует сообщение, точечно коммитит и выполняет явно разрешённые push/PR/merge-действия |
+| `eda-worktree-executor` | `haiku` | `gpt-5.6-luna` | Создаёт соседний worktree и одноимённую ветку, не изменяя файлы проекта |
+| `eda-merge-worktree-executor` | `haiku` | `gpt-5.6-luna` | Мержит ветку из соседнего worktree в текущую без cleanup и ручного разрешения конфликтов |
+| `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-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 | Проверяет тестовое покрытие и корректность тестов |
+| `eda-review-security` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет безопасность и границы доверия |
+| `eda-review-performance` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет производительность и масштабирование |
+| `eda-review-frontend` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет frontend-код, UI и UX по исходникам |
+| `eda-review-api` | `sonnet`, read-only | `gpt-5.6-terra`, read-only | Проверяет API-контракты и совместимость |
+| `eda-review-database` | `opus`, read-only | `gpt-5.6-sol`, read-only | Проверяет схемы, миграции, запросы и целостность данных |
+| `eda-review-documentation` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Проверяет обязательные обновления документации |
+| `eda-review-previous-reviews` | `haiku`, read-only | `gpt-5.6-luna`, read-only | Перепроверяет незакрытые удалённые замечания |
+
+Агенты устанавливаются отдельно от скилов. Модели review-агентов в таблице — сбалансированные defaults; `docs/settings.yaml` или прямое указание пользователя может заменить модель конкретной проверки на текущий запуск. `eda-aim` последовательно разделяет согласование, выполнение и независимую проверку, а при необходимости использует установленные скилы только в отдельных изолированных субагентах; основной агент передаёт вопросы и структурированные результаты. `eda-commit` сохраняет исходный запрос, запускает двух агентов по очереди и передаёт полный структурированный результат первого второму. `eda-worktree` и `eda-merge-worktree` передают одному специализированному агенту git-операцию, обрабатывают его вопрос или результат и сами команды не выполняют. `eda-review` параллельно запускает только применимые review-агенты; полный prompt каждой роли хранится в агенте, а скил отвечает за выбор, retry и агрегацию.
+
+Для Claude Code установленные `eda-commit`, `eda-worktree` и `eda-merge-worktree` получают `model: haiku`. В Codex у скилов пока нет отдельного per-skill model override: основной поток остаётся на выбранной пользователем модели, но он выполняет только лёгкую оркестрацию, а содержательная работа закреплена за моделями агентов. Для worktree-операций это `gpt-5.6-luna`.
 
 ---
 
 ## 🚩 Флаги скилов
 
-У некоторых скилов есть флаг `strict` — он включает дополнительные тяжёлые проверки. Передаётся как часть запроса агенту, например: `eda-explore strict <тема>` или просто `сделай ревью этого PR в strict-режиме`. Также strict можно включить по умолчанию через `defaults.strict: true` в `docs/settings.yaml`.
+У некоторых скилов есть флаг `strict` — он включает дополнительные тяжёлые проверки. Передаётся как часть запроса агенту, например: `eda-explore strict <тема>`. Также strict можно включить отдельно в `docs/settings.yaml`, например через `explore.strict: true`. У `eda-review` вместо общего режима каждая проверка имеет собственные `mode` и `model`.
+
+У `eda-aim` есть режимы `automatic` / `manual`. В автоматическом основной агент сам отвечает на безопасные рабочие вопросы по рекомендации субагента и фактам проекта, в ручном передаёт их человеку. Режим можно разово указать в вызове; без него используется `aim.mode` из настроек. Точный список новых целей перед записью в `docs/aims/` всё равно один раз подтверждает человек.
 
-Скилы, которых нет в таблице ниже, флагов не поддерживают — у них всё включено по умолчанию.
+Скилы, которых нет в таблице ниже, не поддерживают эти флаги. Набор проверок `eda-review` отдельно управляется через `review.agents`.
 
 | Скил | Флаг | Что включает | Когда стоит использовать |
 |---|---|---|---|
+| `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-execute` |
-| `eda-review` | `draft` | Сохраняет первичное ревью со статусом `draft` и не запускает `eda-review-check`, субагентов и кросс-CLI | Когда ревью нужно как черновик для внешней оркестрации, например `eda-polish` |
-| `eda-review` | `strict` | После draft-ревью запускает `eda-review-check strict`: специализированные субагенты плюс соседний CLI; доправляет ревью по подтверждённым замечаниям | Ревью важных PR; когда нужен максимальный охват |
-| `eda-review-check` | `strict` | Проверяет уже готовое ревью специализированными субагентами и затем отдаёт его соседнему CLI на дополнительный круг проверки | Когда черновик ревью уже есть и нужно усилить только проверку ревью |
+| `eda-plan-polish` | `strict` | В каждой итерации после трёх полных ревью плана отдаёт план соседнему CLI (Claude → Codex или Codex → Claude) на кросс-ревью; затем учитывает его в итоговой оценке и правках | Максимальная полировка ответственных планов перед `eda-plan-execute` |
 | `eda-fix-by-review` | `apply-optional` | Применяет все обязательные пункты, а пункты «на усмотрение автора» разбирает без вопроса: применяет выбранные и отклоняет нецелесообразные с причиной | Для автономной доводки, прежде всего внутри `eda-polish` |
 
 ---
@@ -81,81 +127,282 @@ eda update-all ~/Code
 Файл по умолчанию:
 
 ```yaml
-version: 1
+version: 2
+
+orhestra:
+  # Режим полного цикла eda-orhestra.
+  # automatic | manual
+  mode: automatic
+  # Упорядоченная цепочка. Шаги можно отключать, удалять и переставлять.
+  steps:
+    - id: plan
+      skill: eda-plan
+      enabled: true
+      # Строка аргументов передаётся скиллу как часть текущего вызова.
+      args: ""
+    - id: execute
+      skill: eda-plan-execute
+      enabled: true
+      # Строка аргументов передаётся скиллу как часть текущего вызова.
+      args: ""
+    - id: polish
+      skill: eda-polish
+      enabled: true
+      # Строка аргументов передаётся скиллу как часть текущего вызова.
+      args: "limit 5"
+    - id: manual-test
+      skill: eda-manual-test
+      enabled: true
+      # Строка аргументов передаётся скиллу как часть текущего вызова.
+      args: ""
+      # Обработка failed-результата этого шага.
+      on_failure:
+        skill: eda-fix
+        args: ""
+        # После исправления повторно запускаются включённые шаги с этими id.
+        then:
+          - polish
+          - manual-test
+        max_cycles: 5
+
+aim:
+  # Режим ответов на рабочие вопросы eda-aim.
+  # automatic | manual
+  mode: automatic
+
+explore:
+  # Включает кросс-CLI ревью в eda-explore.
+  # true | false
+  strict: false
+  # Определяет, как eda-explore ведёт исследовательские развилки.
+  # autonomous | recommend_and_ask | ask_each_time
+  decision_mode: recommend_and_ask
 
-defaults:
-  # Включает strict-режим по умолчанию для eda-explore, eda-plan, eda-plan-polish, eda-review и eda-review-check.
+plan:
+  # Включает кросс-CLI ревью в eda-plan.
   # true | false
   strict: false
-  # Задаёт размер плана по умолчанию для eda-plan.
+  # Задаёт размер плана.
   # normal | short | ask_each_time
-  plan_size: normal
-  # Определяет, как eda-explore ведёт исследовательские развилки, а eda-plan принимает существенные решения.
+  size: normal
+  # Определяет, как eda-plan принимает существенные решения.
   # autonomous | recommend_and_ask | ask_each_time
   decision_mode: recommend_and_ask
-  # Задаёт стратегию тестов по умолчанию для eda-plan.
+  # Задаёт стратегию тестов.
   # after_each_phase | tdd_each_phase | end_of_plan | ask_each_time
   test_strategy: ask_each_time
-  # Задаёт стратегию логирования по умолчанию для eda-plan.
+  # Задаёт стратегию логирования.
   # debug_precise | standard | ask_each_time
   logging_strategy: ask_each_time
 
-automate:
-  # Добавляет docs/plans/ в обычный запуск eda-automate.
+plan-polish:
+  # Включает кросс-CLI ревью в eda-plan-polish.
   # true | false
-  include_plans: false
+  strict: false
 
 review:
-  # Добавляет в eda-review / eda-review-check проверку качества кода и meta-reviewer quality-check.
+  # Каждая проверка имеет собственный режим запуска и модели для обеих сред.
+  agents:
+    # Проверяет ошибки в логике, крайние случаи и обработку ошибок.
+    # Эта базовая проверка по умолчанию запускается всегда.
+    correctness:
+      # always — всегда, auto — когда применимо, off — отключено.
+      mode: always
+      model:
+        # Модель для Claude Code.
+        claude: sonnet
+        # Модель для Codex.
+        codex: gpt-5.6-terra
+
+    # Проверяет архитектурные границы, зависимости и разделение ответственности.
+    # В auto запускается при изменении модулей, зависимостей, публичных контрактов или границ системы.
+    architecture:
+      mode: auto
+      model:
+        claude: opus
+        codex: gpt-5.6-sol
+
+    # Проверяет соблюдение AGENTS.md, CLAUDE.md и docs/rules.md.
+    # Эта базовая проверка по умолчанию запускается всегда.
+    rules:
+      mode: always
+      model:
+        claude: haiku
+        codex: gpt-5.6-luna
+
+    # Проверяет соответствие применимым карточкам из docs/references/.
+    # В auto запускается только когда для изменений выбраны применимые карточки.
+    references:
+      mode: auto
+      model:
+        claude: haiku
+        codex: gpt-5.6-luna
+
+    # Проверяет, что реализация соответствует указанному или однозначно найденному плану.
+    # В auto запускается только когда у ревью есть конкретный план.
+    plan_alignment:
+      mode: auto
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет читаемость, сложность, дублирование и поддерживаемость кода.
+    # Эта базовая проверка по умолчанию запускается всегда.
+    code_quality:
+      mode: always
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет достаточность, корректность и устойчивость тестов.
+    # Эта базовая проверка по умолчанию запускается всегда.
+    tests:
+      mode: always
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет уязвимости, права доступа, валидацию и работу с чувствительными данными.
+    # В auto запускается для auth, permissions, внешнего ввода, файлов, сети, секретов и криптографии.
+    security:
+      mode: auto
+      model:
+        claude: opus
+        codex: gpt-5.6-sol
+
+    # Проверяет запросы, циклы, память, конкурентность и другие риски производительности.
+    # В auto запускается при изменении запросов, кешей, конкурентности или горячих путей.
+    performance:
+      mode: auto
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет фронтенд-код, UI, UX, адаптивность и состояния интерфейса.
+    # В auto обязательно запускается при изменении компонентов, стилей, клиентских маршрутов или состояния UI.
+    frontend:
+      mode: auto
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет API-контракты, совместимость, валидацию и обработку ошибок.
+    # В auto запускается при изменении маршрутов, handlers, DTO, схем API, GraphQL или RPC.
+    api:
+      mode: auto
+      model:
+        claude: sonnet
+        codex: gpt-5.6-terra
+
+    # Проверяет схемы, миграции, запросы, индексы и целостность данных.
+    # В auto запускается при изменении миграций, моделей хранения, SQL, схем или транзакций.
+    database:
+      mode: auto
+      model:
+        claude: opus
+        codex: gpt-5.6-sol
+
+    # Проверяет, обновлена ли документация для изменившегося пользовательского поведения.
+    # В auto запускается при изменении публичного API, CLI, настроек или документируемого поведения.
+    documentation:
+      mode: auto
+      model:
+        claude: haiku
+        codex: gpt-5.6-luna
+
+    # Перепроверяет незакрытые замечания предыдущих ревью для удалённого PR или MR.
+    # В auto запускается только для ссылки на PR/MR или другой цели с доступными удалёнными обсуждениями.
+    previous_reviews:
+      mode: auto
+      model:
+        claude: haiku
+        codex: gpt-5.6-luna
+
+send-review:
+  # После успешной отправки скрывает предыдущие сводки eda-send-review и резолвит их inline-треды.
   # true | false
-  include_code_quality: true
+  close_previous_reviews: false
+
+discover-automations:
+  # Добавляет docs/plans/ в обычный запуск eda-discover-automations.
+  # true | false
+  include_plans: false
 ```
 
 Что означают настройки:
-- `defaults.strict` — включает strict-режим по умолчанию для `eda-explore`, `eda-plan`, `eda-plan-polish`, `eda-review` и `eda-review-check`.
-- `defaults.plan_size` — размер плана для `eda-plan`: `normal`, `short` или `ask_each_time`.
-- `defaults.decision_mode` — как `eda-explore` ведёт исследовательские развилки, а `eda-plan` принимает существенные решения: `autonomous` выбирает сам, `recommend_and_ask` рекомендует и спрашивает по значимым развилкам, `ask_each_time` спрашивает по каждой развилке, которая влияет на ход работы или итоговый выбор.
-- `defaults.test_strategy` — стратегия тестов для `eda-plan`: `after_each_phase`, `tdd_each_phase`, `end_of_plan` или `ask_each_time`.
-- `defaults.logging_strategy` — стратегия логирования для `eda-plan`: `debug_precise`, `standard` или `ask_each_time`.
-- `automate.include_plans` — добавляет `docs/plans/` в обычный запуск `eda-automate`.
-- `review.include_code_quality` — добавляет в `eda-review` / `eda-review-check` проверку качества кода и отдельного мета-ревьюера `quality-check`.
+- `orhestra.mode` — `automatic` безопасно закрывает рабочие вопросы без промежуточных подтверждений; `manual` пишет план вместе с человеком и передаёт ему вопросы.
+- `orhestra.steps` — выполняемый сверху вниз workflow. `enabled: false` отключает шаг, а `args` передаёт ему дополнительные параметры. Например, для `eda-polish`: `args: "threshold 90 limit 2"`. Шаги можно переставлять или добавлять, но git/publish-скиллы оркестратор не запускает.
+- Старое значение `steps[].skill: eda-execute` во время запуска автоматически понимается как `eda-plan-execute`; существующий `docs/settings.yaml` установщик не переписывает.
+- `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`.
+- `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 и просит переименовать настройку.
+
+Каждый скилл читает только свой раздел. Для `eda-review` прямое указание в текущем запросе может разово включить или отключить проверку и заменить её модель, например: «без performance, architecture на opus».
+
+Поддерживается только `version: 2`. Для старого v2 без `review.agents` новый review использует сбалансированные defaults и предупреждает, что устаревшие `review.strict`, `review.include_code_quality` и `review-check` игнорируются. Установщик существующий файл не переписывает.
 
-`eda init` и `eda update` создают `docs/settings.yaml`, только если файла ещё нет. Существующий файл не перезаписывается. `eda update-all` настройки не создаёт и не меняет.
+`eda init` и `eda update` создают `docs/settings.yaml`, только если файла ещё нет. Существующий файл, включая v1, не перезаписывается; его нужно перевести вручную. `eda update-all` настройки не создаёт и не меняет.
 
 ---
 
 ## 🔄 Воркфлоу
 
+`eda-orhestra` по умолчанию запускает основной цикл одной командой:
+
+Каждая стрелка между этапами передаёт только явный вход и пути к артефактам: каждый этап работает в новом изолированном субагенте без истории диалога.
+
+```text
+plan → plan-execute → polish → manual-test ──passed──> готово
+                           ^          │
+                           └── fix <───┘ failed
+```
+
+`eda-aim` может обернуть любую цепочку ниже в автономный цикл:
+
+```text
+согласование цели → выполнение с нужными скилами в изолированных субагентах → независимая проверка
+                              ^                         │
+                              └──── устранение пробелов ─┘
+```
+
 ```text
-start ─────────────> docs ───────────────┬───────────────┐
+new-project ───────> prepare-ai ─────────┬───────────────┐
                     │                     │               │
                     v                     v               v
-                 roadmap ────────> explore ─────> plan ───> plan-polish ───> execute ───┬──> manual-test ───> review ───> review-check ───> fix-by-review ───┬──> send-review
+                 roadmap ────────> explore ─────> plan ───> plan-polish ───> plan-execute ───┬──> manual-test ───> review ───> fix-by-review ───┬──> send-review
                                               │                         │                                  │
                                               └────────────> plan       v                                  └──> commit
                                                                      fix ─────────────> manual-test
 ```
 
-Если проект уже существует, можно начинать без `eda-start`:
+Если проект уже существует, можно начинать без `eda-new-project`:
 
 ```text
-docs ───────────────┬───────────────┐
+prepare-ai ─────────┬───────────────┐
                     │               │
                     v               v
-roadmap ────────> explore ─────> plan ───> plan-polish ───> execute ───┬──> manual-test ───> review ───> review-check ───> fix-by-review ───┬──> send-review
+roadmap ────────> explore ─────> plan ───> plan-polish ───> plan-execute ───┬──> manual-test ───> review ───> fix-by-review ───┬──> send-review
                     │                                  │                                  │
                     └──────────────> plan              v                                  └──> commit
                                                       fix ─────────────> manual-test
 
-polish = review draft ─> review-check ─> fix-by-review apply-optional ─> повтор до нужной оценки
+polish = полное review ─> fix-by-review apply-optional ─> повтор до нужной оценки
 plan-polish = 3 полных ревью плана разными моделями ─> strict: кросс-CLI ─> оценка ─> правка плана ─> повтор до 95/100
 
-automate может запускаться от review, fix-by-review или fix.
+discover-automations может запускаться от review, fix-by-review или fix.
 ```
 
-`eda-manual-test` обычно ставится после `eda-execute`, `eda-fix` или `eda-fix-by-review`, чтобы руками проверить API/UI перед ревью или коммитом.
+`eda-manual-test` обычно ставится после `eda-plan-execute`, `eda-fix` или `eda-fix-by-review`, чтобы руками проверить API/UI перед ревью или коммитом.
 
-Использовать всю цепочку не обязательно — каждый скил самодостаточен. Новый проект можно начать с `eda-start`; существующий — с `eda-roadmap`, `eda-explore`, или сразу с `eda-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 и дай ссылку` выполняет всю указанную цепочку без отдельного вопроса после коммита.
 
 ---
 
@@ -163,9 +410,10 @@ automate может запускаться от review, fix-by-review или fix
 
 - **Простой язык.** Скилы общаются с тобой так, чтобы понял человек без глубоких знаний предмета. Термины — только когда без них нельзя.
 - **Все вопросы — интерактивно.** В Claude Code — через `AskUserQuestion`; в интерактивном Codex — через `request_user_input` или блокирующий вопрос в чат. В `codex exec` и других неинтерактивных запусках скил не имитирует диалог: если без ответа нельзя безопасно продолжать, он завершает работу со статусом `blocked: нужен ответ пользователя`.
-- **Мета-проверки — через субагентов.** В интерактивном Codex обычные проверки планов и ревью запускаются через `spawn_agent` или аналогичный инструмент субагентов. Проверки готового ревью собраны в `eda-review-check`. Отдельный `codex exec` остаётся fallback для неинтерактивного режима и механизмом strict-кросс-проверки соседним CLI.
+- **Проверки — через субагентов.** `eda-review` запускает установленных read-only агентов нативным механизмом Claude/Codex. Если субагенты недоступны, review останавливается: CLI-fallback, кросс-проверки соседним провайдером и подмена ролей главным агентом не используются.
+- **Повторяемые роли — в пакетных агентах.** Скилы управляют процессом, а стабильные изолированные роли получают собственный prompt, модель и доступ. Полные review-prompts не дублируются в оркестраторе.
 - **Артефакты по папкам.** Исследования отдельно, планы отдельно, ревью отдельно. Между файлами — ссылки. Через месяц легко найти, кто что когда решал.
-- **Границы между скилами жёсткие.** `execute` не коммитит — это работа `commit`. `review` не правит код — это `fix-by-review`. Никаких размытых ответственностей.
+- **Границы между скилами жёсткие.** `plan-execute` только управляет субагентами и не коммитит — это работа `commit`. `review` не правит код — это `fix-by-review`. Никаких размытых ответственностей.
 - **Доверие модели.** Скилы короткие. Они говорят «что» и «почему», а «как именно» — модель разбирается сама.
 
 ---
@@ -173,9 +421,9 @@ automate может запускаться от review, fix-by-review или fix
 ## 💻 Команды
 
 ```bash
-eda init      # выбрать Claude Code / Codex / обе среды и установить скилы
-eda update    # обновить скилы, показать реально изменившиеся и создать docs/settings.yaml, если его ещё нет
-eda update-all [dir] # обновить скилы во всех найденных проектах внутри dir на глубине 2
+eda init      # выбрать Claude Code / Codex / обе среды и установить пакет
+eda update    # обновить скилы и агенты, создать docs/settings.yaml, если его ещё нет
+eda update-all [dir] # обновить пакет во всех найденных проектах внутри dir на глубине 2
 eda --version # показать версию установленного пакета
 eda --help    # справка
 ```
@@ -184,7 +432,7 @@ eda --help    # справка
 
 ```bash
 npm update -g @gian-tiaga/eda    # подтянуть новый код
-eda update           # синхронизировать скилы в текущем проекте
+eda update           # синхронизировать пакет в текущем проекте
 ```
 
 Для папки с несколькими проектами:
@@ -196,16 +444,21 @@ eda update-all ~/Code
 
 ---
 
-## 📁 Куда устанавливаются скилы
+## 📁 Структура и установка компонентов
+
+Исходники скилов лежат в `skills/<skill>/SKILL.md`. Дополнительные ресурсы скила можно хранить рядом; `skill.json` содержит только платформенные настройки и в проект пользователя не копируется. `models.codex` можно хранить как зарезервированную настройку для будущего per-skill override, но текущий Codex renderer её не добавляет в `SKILL.md`.
 
-Исходники скилов в этом пакете лежат в `skills/`. Установщик читает именно эту папку и копирует каждый `<skill>.md` в формат `<skill>/SKILL.md` для выбранной среды.
+Исходники агентов лежат в `agents/<agent>/agent.json` и `prompt.md`. Установщик рендерит единый агентный контракт в нативный формат выбранной среды.
+
+| Компонент | Claude Code | Codex CLI |
+|---|---|---|
+| Скил | `.claude/skills/<skill>/SKILL.md` | `.codex/skills/<skill>/SKILL.md` |
+| Агент | `.claude/agents/<agent>.md` | `.codex/agents/<agent>.toml` |
+| Manifest владения | `.claude/eda-manifest.json` | `.codex/eda-manifest.json` |
 
-| Среда | Куда |
-|---|---|
-| **Claude Code** | `<project>/.claude/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
-| **Codex CLI** | `<project>/.codex/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
+`eda update` идемпотентно синхронизирует обе группы компонентов и отдельно показывает реально изменившиеся скилы и агенты. Manifest хранит только идентификаторы компонентов, которыми владеет `eda`: благодаря этому retired-компоненты удаляются, а чужие скилы и агенты остаются нетронутыми. `eda update-all [dir]` делает то же самое для каждого найденного проекта, но не создаёт `docs/settings.yaml`. Старые Codex-файлы `.codex/skills/<skill>.md` также удаляются при миграции.
 
-`eda update` идемпотентно перезаписывает файлы в обеих папках и в конце пишет только те скилы, содержимое которых реально изменилось относительно установленной копии. `eda update-all [dir]` делает то же самое для каждого найденного проекта внутри `dir`, но не создаёт `docs/settings.yaml`. При обновлении старые файлы Codex-формата `<project>/.codex/skills/<skill>.md`, созданные версиями `eda` до этой структуры, удаляются. Если ты хочешь подправить скил локально — лучше копию сделай рядом, а не прямо в `.claude/skills/` или `.codex/skills/`, иначе при следующем `update` твои правки потеряются.
+Установленные копии не являются источником правды. Локальные изменения внутри `.claude/skills/eda-*`, `.codex/skills/eda-*`, `.claude/agents/eda-*` или `.codex/agents/eda-*` будут заменены следующим обновлением.
 
 `AGENTS.md` (как и любые другие файлы в корне проекта) установщик **не трогает**. Если хочешь, чтобы Codex автоматически подгружал скилы, дай ему знать сам — например, одной строкой в `AGENTS.md`: «следуй инструкциям из `.codex/skills/`».
 
@@ -215,7 +468,7 @@ eda update-all ~/Code
 
 - Для тех, кто **постоянно** пишет код с AI-агентом и устал каждый раз заново объяснять, как делать ревью.
 - Для команд, где хочется единый стандарт работы с агентами — чтобы ревью у всех было пронумеровано и оценено, планы лежали в одной папке, а коммиты были по одному стилю.
-- Для разработчиков, которые любят **строгость**: максимально жёсткие правила, обязательные тесты, мета-проверки ревью несколькими моделями, кросс-проверка через соседний CLI.
+- Для разработчиков, которые любят **строгость**: максимально жёсткие правила, обязательные тесты и отдельные контекстные проверки ревью на подходящих моделях.
 
 ---