@gian-tiaga/eda 3.2.1 → 3.3.0

package/MIGRATION.md

@@ -1,4 +1,4 @@
-# Миграция на eda 3.2
+# Миграция на eda 3.3
 
 Версия 3.0 перенесла все рабочие результаты скилов в `docs/artifacts/`; постоянная документация проекта остаётся непосредственно в `docs/`. Версия 3.1 дополнительно переработала проверку плана, ревью кода и циклы полировки. Версия 3.2 обновила commit-flow и расположение проектных Codex-скиллов. В npm 3.0 не публиковалась, поэтому переход с 2.x выполняется сразу на актуальную версию 3.x.
 
@@ -75,7 +75,7 @@ docs/
 
 ## Настройки
 
-Версия npm-пакета и версия схемы настроек независимы: в eda 3.2 актуальным остаётся `docs/settings.yaml` с `version: 3`.
+Версия npm-пакета и версия схемы настроек независимы: в eda 3.3 актуальным остаётся `docs/settings.yaml` с `version: 3`.
 
 Установщик по-прежнему сохраняет полный валидный v3 байт-в-байт — кроме случая, когда в файле остались устаревшие ключи: тогда он перезаписывает файл без вопросов и печатает, что именно убрал. Старый, неизвестный или неполный YAML нормализуется: известные валидные значения переносятся, а отсутствующие спрашиваются в TTY или получают defaults без TTY.
 
@@ -97,7 +97,7 @@ docs/
 - старые рабочие каталоги исчезли из `docs/`, а файлы находятся в `docs/artifacts/`;
 - `docs/business.md`, `docs/business/`, `docs/references.md`, `docs/references/`, `docs/arch.md` и `docs/rules.md` остались на месте;
 - `docs/settings.yaml` содержит `version: 3`;
-- `eda --version` выводит версию `3.2.x`;
+- `eda --version` выводит версию `3.3.x`;
 - в `docs/settings.yaml` нет секции `plan-review.agents` и аргумента `threshold N` у шага `eda-polish`;
 - в `.claude/agents/` и `.codex/agents/` не осталось файлов `eda-plan-review-*`;
 - Claude-скиллы установлены в `.claude/skills/`, Codex-скиллы — в `.agents/skills/`, агенты — в `.claude/agents/` и `.codex/agents/`.

package/README.md

@@ -56,7 +56,7 @@ eda update-all ~/Code
 | `eda-review` | Оркестрирует отдельные read-only проверки корректности, архитектуры, правил, references, business-правил, плана, качества, тестов, безопасности, производительности, frontend/UI/UX, API, БД, документации и предыдущих ревью. Сохраняет только доказанные дефекты, которые обязательно исправить; косметические и спекулятивные предложения отбрасывает. Любая находка даёт `changes-required`, а чистое ревью — `clean` и 100/100. Без аргументов ревьюит `git diff HEAD` | `docs/artifacts/reviews/` |
 | `eda-fix-by-review` | Применяет все находки из ревью с учётом правил, архитектуры и применимых карточек. Спрашивает только при неоднозначности, конфликте, расширении scope или рискованном действии. В конце ссылается на отчёт прямо в файле ревью | `docs/artifacts/review-fixes/` |
 | `eda-manual-test` | Делает ручную smoke/acceptance-проверку после изменений: основной чеклист строит по выполненной задаче и связанному плану/issue/review/fix-отчёту, затем сверяет фактический diff. Применимая business-карточка может добавить только относящийся к задаче инвариант или сценарий; несвязанные карточки не загружаются. Не правит код, не пишет автотесты и не коммитит | `docs/artifacts/manual-tests/` |
-| `eda-polish` | Оркестрирует доводку изменений: запускает полное `eda-review`, затем `eda-fix-by-review` и повторяет цикл до `clean`, отсутствия находок и оценки не ниже 95/100 либо до лимита 5 итераций. Все находки исправляются. Каждый шаг идёт в изолированном нативном субагенте. Не коммитит | `docs/artifacts/reviews/`, `docs/artifacts/review-fixes/` |
+| `eda-polish` | Оркестрирует доводку изменений: запускает полное `eda-review`, затем `eda-fix-by-review` и повторяет цикл до `clean` и отсутствия находок либо до лимита 5 итераций. Все находки исправляются, score остаётся справочным. Каждый шаг идёт в изолированном нативном субагенте. Не коммитит | `docs/artifacts/reviews/`, `docs/artifacts/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-действия. С явным контекстом охватывает указанный состав; без контекста берёт все tracked-изменения и содержательные untracked-файлы, кроме очевидных кэшей и локальных служебных артефактов. В Claude Code сам оркестратор закреплён за `haiku`; в Codex остаётся на активной модели сессии из-за отсутствия per-skill override. При вероятном секрете агент блокируется до индексации затронутой группы. После любого push всегда возвращает ссылку — на существующий PR или на его создание — и спрашивает, создавать ли PR, если его нет. Если продолжение не задано, предлагает применимые варианты | (git, опционально GitHub PR) |
 | `eda-worktree` | На `haiku` / `gpt-5.6-luna` создаёт через пакетного агента git worktree рядом с основным проектом в папке `{name}-work-{n}` и одноимённую ветку. Базу берёт из аргумента или спрашивает | соседняя папка `{name}-work-{n}` |
@@ -114,7 +114,7 @@ eda update-all ~/Code
 | `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 и агрегацию.
+Агенты устанавливаются отдельно от скилов. Модели review-агентов в таблице — сбалансированные defaults; `docs/settings.yaml` или прямое указание пользователя может заменить модель конкретной проверки на текущий запуск. `eda-aim` последовательно разделяет согласование, выполнение и независимую проверку, а при необходимости использует установленные скилы только в отдельных изолированных субагентах; основной агент передаёт вопросы и структурированные результаты. `eda-commit` сохраняет исходный запрос и целиком передаёт сбор контекста, выбор файлов, коммит и разрешённое продолжение одному простому агенту. `eda-worktree` и `eda-merge-worktree` передают одному специализированному агенту git-операцию, обрабатывают его вопрос или результат и сами команды не выполняют. `eda-review` параллельно запускает только применимые review-агенты; полный prompt каждой роли хранится в агенте, а скил отвечает за выбор, retry и агрегацию. В Claude Code установленный `eda-review` всегда выполняется через `context: fork`, в том числе из `eda-polish`. В Codex шаги polish и специализированные review-агенты запускаются с `fork_turns: "none"`, без наследования истории. Все выбранные проверки отправляются одним нативным параллельным пакетом без ручных партий и shell-опроса.
 
 Для Claude Code установленные `eda-commit`, `eda-worktree` и `eda-merge-worktree` получают `model: haiku`. В Codex у скилов пока нет отдельного per-skill model override: основной поток остаётся на выбранной пользователем модели, но он выполняет только лёгкую оркестрацию, а содержательная работа `eda-commit` и worktree-операций закреплена за `gpt-5.6-luna`.
 
@@ -451,6 +451,7 @@ discover-automations может запускаться от review, fix-by-revie
 - **Простой язык.** Скилы общаются с тобой так, чтобы понял человек без глубоких знаний предмета. Термины — только когда без них нельзя.
 - **Все вопросы — интерактивно.** В Claude Code — через `AskUserQuestion`; в интерактивном Codex — через `request_user_input` или блокирующий вопрос в чат. В `codex exec` и других неинтерактивных запусках скил не имитирует диалог: если без ответа нельзя безопасно продолжать, он завершает работу со статусом `blocked: нужен ответ пользователя`.
 - **Проверки — через субагентов.** `eda-review` запускает установленных read-only агентов нативным механизмом Claude/Codex. Если субагенты недоступны, review останавливается: CLI-fallback, кросс-проверки соседним провайдером и подмена ролей главным агентом не используются.
+- **Технические остановки обрабатываются по причине.** Оркестраторы ждут свободный слот при лимите параллельности, запрашивают недостающее разрешение, один раз продолжают агента после временной API-ошибки и без бессмысленных retry останавливаются при лимите глубины, исчерпанной квоте или неизвестном сбое.
 - **Повторяемые роли — в пакетных агентах.** Скилы управляют процессом, а стабильные изолированные роли получают собственный prompt, модель и доступ. Полные review-prompts не дублируются в оркестраторе.
 - **Артефакты по папкам.** Исследования отдельно, планы отдельно, ревью отдельно. Между файлами — ссылки. Через месяц легко найти, кто что когда решал.
 - **Границы между скилами жёсткие.** `plan-execute` только управляет субагентами и не коммитит — это работа `commit`. `review` не правит код — это `fix-by-review`. Никаких размытых ответственностей.
@@ -486,7 +487,7 @@ eda update-all ~/Code
 
 ## 📁 Структура и установка компонентов
 
-Исходники скилов лежат в `skills/<skill>/SKILL.md`. Дополнительные ресурсы скила можно хранить рядом; `skill.json` содержит только платформенные настройки и в проект пользователя не копируется. `models.codex` можно хранить как зарезервированную настройку для будущего per-skill override, но текущий Codex renderer её не добавляет в `SKILL.md`.
+Исходники скилов лежат в `skills/<skill>/SKILL.md`. Дополнительные ресурсы скила можно хранить рядом; `skill.json` содержит только платформенные настройки и в проект пользователя не копируется. Поля `claude.context: fork` и `claude.agent` renderer добавляет только во front matter Claude-копии скила. `models.codex` можно хранить как зарезервированную настройку для будущего per-skill override, но текущий Codex renderer её не добавляет в `SKILL.md`.
 
 Исходники агентов лежат в `agents/<agent>/agent.json` и `prompt.md`. Установщик рендерит единый агентный контракт в нативный формат выбранной среды.
 

package/agents/eda-aim-executor/agent.json

@@ -10,6 +10,5 @@
     "claude": "high",
     "codex": "high"
   },
-  "access": "workspace-write",
-  "maxTurns": 80
+  "access": "workspace-write"
 }

package/agents/eda-aim-planner/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "workspace-write",
-  "maxTurns": 30
+  "access": "workspace-write"
 }

package/agents/eda-aim-verifier/agent.json

@@ -10,6 +10,5 @@
     "claude": "high",
     "codex": "high"
   },
-  "access": "workspace-write",
-  "maxTurns": 50
+  "access": "workspace-write"
 }

package/agents/eda-commit-executor/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "git-write",
-  "maxTurns": 30
+  "access": "git-write"
 }

package/agents/eda-merge-worktree-executor/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "git-write",
-  "maxTurns": 20
+  "access": "git-write"
 }

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

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

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

@@ -10,6 +10,5 @@
     "claude": "high",
     "codex": "high"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-business/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-code-quality/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-correctness/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-database/agent.json

@@ -10,6 +10,5 @@
     "claude": "high",
     "codex": "high"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-documentation/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-frontend/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-performance/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

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

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-previous-reviews/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-references/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-rules/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-security/agent.json

@@ -10,6 +10,5 @@
     "claude": "high",
     "codex": "high"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-review-tests/agent.json

@@ -10,6 +10,5 @@
     "claude": "medium",
     "codex": "medium"
   },
-  "access": "read-only",
-  "maxTurns": 30
+  "access": "read-only"
 }

package/agents/eda-worktree-executor/agent.json

@@ -10,6 +10,5 @@
     "claude": "low",
     "codex": "low"
   },
-  "access": "git-write",
-  "maxTurns": 20
+  "access": "git-write"
 }

package/lib/catalog.js

@@ -62,6 +62,18 @@ function validateSkillConfig(skillName, config) {
   if (config.models && typeof config.models !== 'object') {
     throw new Error(`Скил ${skillName}: models должен быть объектом.`);
   }
+  if (config.claude && (typeof config.claude !== 'object' || Array.isArray(config.claude))) {
+    throw new Error(`Скил ${skillName}: claude должен быть объектом.`);
+  }
+  if (config.claude?.context && config.claude.context !== 'fork') {
+    throw new Error(`Скил ${skillName}: claude.context поддерживает только fork.`);
+  }
+  if (config.claude?.agent && (typeof config.claude.agent !== 'string' || !config.claude.agent.trim())) {
+    throw new Error(`Скил ${skillName}: claude.agent должен быть непустой строкой.`);
+  }
+  if (config.claude?.agent && config.claude.context !== 'fork') {
+    throw new Error(`Скил ${skillName}: claude.agent требует claude.context fork.`);
+  }
 }
 
 function validateAgent(directoryName, agent, prompt) {

package/lib/renderers/claude-agent.js

@@ -17,7 +17,6 @@ export function renderClaudeAgent(agent, prompt) {
   lines.push(`model: ${agent.models.claude}`);
   if (agent.reasoning?.claude) lines.push(`effort: ${agent.reasoning.claude}`);
   if (agent.access === 'read-only') lines.push('permissionMode: plan');
-  if (agent.maxTurns) lines.push(`maxTurns: ${agent.maxTurns}`);
 
   lines.push('---', '', prompt.trimEnd(), '');
   return lines.join('\n');

package/lib/renderers/claude-skill.js

@@ -1,11 +1,19 @@
 export function renderClaudeSkill(content, config = {}) {
   const model = config.models?.claude;
-  if (!model) return content;
+  const context = config.claude?.context;
+  const agent = config.claude?.agent;
+  const fields = [
+    model && `model: ${model}`,
+    context && `context: ${context}`,
+    agent && `agent: ${agent}`
+  ].filter(Boolean);
+
+  if (fields.length === 0) return content;
 
   const closingMarker = content.indexOf('\n---', 4);
   if (!content.startsWith('---\n') || closingMarker === -1) {
-    throw new Error('Не удалось добавить Claude model override: некорректный front matter скила.');
+    throw new Error('Не удалось добавить настройки Claude: некорректный front matter скила.');
   }
 
-  return `${content.slice(0, closingMarker)}\nmodel: ${model}${content.slice(closingMarker)}`;
+  return `${content.slice(0, closingMarker)}\n${fields.join('\n')}${content.slice(closingMarker)}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Пакет скилов и специализированных агентов eda-* для Claude Code и Codex CLI",
   "type": "module",
   "bin": {

package/skills/eda-aim/SKILL.md

@@ -43,6 +43,19 @@ aim:
 - Не копируй системный промпт агента в сообщение с заданием.
 - Если нужный агент или нативные субагенты недоступны, остановись: `blocked: нужен установленный агент <имя>`. Не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не расходуют лимиты содержательных итераций или циклов достижения цели.
+
 ## Вопросы и автоматический режим
 
 Агент может вернуть один конкретный `question`, 1–3 взаимоисключающих `options` и `recommended_answer`.

package/skills/eda-commit/SKILL.md

@@ -31,6 +31,19 @@ description: 'Коммитит выбранные или все незакомм
 - Передавай агенту только рабочую директорию, данные текущего запуска и требуемый формат результата.
 - Если custom agent или инструмент субагентов недоступен, остановись: `blocked: нужен установленный агент <имя>`; не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй работу сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не меняют `$REQUESTED_ACTIONS` и не разрешают повторять уже выполненные git/GitHub-действия без сверки текущего состояния.
+
 ## Интерактивные вопросы
 
 Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю.

package/skills/eda-merge-worktree/SKILL.md

@@ -25,6 +25,19 @@ description: 'Мержит ветку из соседнего git worktree в т
 - Передавай агенту только рабочую директорию, данные текущего запуска и требуемый формат результата.
 - Если custom agent или инструмент субагентов недоступен, остановись: `blocked: нужен установленный агент eda-merge-worktree-executor`. Не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй работу сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не разрешают повторять уже выполненный merge без сверки текущего состояния.
+
 ## Интерактивные вопросы
 
 Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю через общий паттерн `AskUserQuestion`.

package/skills/eda-orhestra/SKILL.md

@@ -110,6 +110,19 @@ orhestra:
 5. Каждый повтор шага и каждый `on_failure.skill` считай новым вызовом: запускай его в новом изолированном субагенте с полным актуальным входом.
 6. Если чистый контекст, субагент этапа или нужная составному скилу вложенная делегация недоступны, остановись с `blocked: недоступна изоляция этапа`. Не выполняй этап основным агентом и не вводи новый CLI-fallback, которого нет в инструкции вызываемого скилла.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не расходуют лимиты содержательных итераций или QA-циклов.
+
 ## Выполнение и QA-цикл
 
 Веди внутренний журнал: нормализованные шаги, текущий id, итоговый ввод, статус, созданные артефакты, review score и число QA-циклов. Отдельный orchestration-файл не создавай.

package/skills/eda-plan/SKILL.md

@@ -64,6 +64,19 @@ description: 'Создаёт понятный исполнимый план ре
 14. Если нужны пакеты, библиотеки, CLI или сервисы, а версия не указана в контексте или lock-файлах, найди последнюю стабильную версию через context7 или web search. Не пиши `latest` без конкретной версии и источника.
 15. Финальный план прост, исполним и без альтернатив вида «выбрать», «решить», «можно так или так», «предпочтительно».
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не расходуют лимиты содержательных итераций.
+
 ## Этапы
 
 ### 1. Собрать контекст

package/skills/eda-plan-execute/SKILL.md

@@ -84,6 +84,19 @@ current_phase: <номер>
 
 В Codex используй `spawn_agent` с `fork_turns: "none"`, в Claude Code — новый `Agent` с самодостаточным сообщением. Если изоляция или субагенты недоступны, остановись: `blocked: недоступно изолированное выполнение`. Работу основным агентом не делай и CLI-fallback не добавляй.
 
+#### Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не считаются попыткой исправления фазы и не расходуют её лимит сходимости.
+
 Каждому исполнителю фазы передай: рабочую директорию, `$PLAN_FILE`, номер и полный текст фазы, краткие результаты завершённых фаз, пути к `docs/rules.md`, `docs/arch.md`, `docs/business.md` и `docs/references.md`, ограничения пользователя, критерии проверки фазы и запрет коммитить и менять план и журнал.
 
 Требуй YAML-результат:

package/skills/eda-plan-polish/SKILL.md

@@ -33,6 +33,19 @@ description: 'Доводит план циклом ревью и исправл
 4. Основной агент не меняет содержание плана. После `ready` он может обновить только front matter: `status`, `plan_review`, `plan_review_fix`.
 5. Не запускай проверки проекта и не коммить.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не расходуют `$LIMIT` и не считаются новой review-итерацией.
+
 ## Снапшот лучшей версии
 
 Перед первым fix скопируй план в `docs/artifacts/plan-snapshots/{slug}.md` и запомни его score как лучший.

package/skills/eda-polish/SKILL.md

@@ -16,12 +16,27 @@ description: 'Итеративно ревьюит и исправляет изм
 ## Правила
 
 1. Каждый вызов `eda-review` и `eda-fix-by-review` запускай отдельным изолированным субагентом. Основной агент не делает их работу.
+   - В Claude Code вызывай установленный `eda-review` именно через `Skill`: его отрендеренная копия содержит `context: fork` и сама создаёт изолированный review-runner. Не читай инструкцию `eda-review` в текущий контекст, не воспроизводи её процедуру самостоятельно и не запускай `eda-review-*` агентов напрямую из полировщика.
+   - В Codex каждый вызов `eda-review` и `eda-fix-by-review` запускай через `spawn_agent` с `fork_turns: "none"`. Не оставляй `fork_turns` по умолчанию и не используй `"all"`: субагент получает только самодостаточное task-сообщение и явно указанные пути к артефактам.
 2. Если нативные субагенты недоступны, остановись; не заменяй шаги CLI-процессами.
 3. Успех требует одновременно: полный review со статусом `reviewed` или `reviewed-with-warnings`, `result: clean` и ноль находок. Score — только справочное число, условием завершения он не является.
 4. Любая находка обязательно исправляется. Отклонить находку может только `eda-fix-by-review` и только при её фактической неверности.
 5. Не коммить и не отправляй ревью.
 6. Останавливайся при повторном сбое обязательной проверки review, блокере fix-агента, несокращении числа открытых находок за полный круг или достижении лимита.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй этап сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не расходуют `$LIMIT` и не считаются новой polish-итерацией.
+
 ## Вопросы
 
 Если target неоднозначен, передай управление первому `eda-review`: он задаст один конкретный вопрос по правилам своей среды. Если шаг вернул `blocked`, основной агент повторяет только этот вопрос и после ответа продолжает тот же шаг.

package/skills/eda-review/SKILL.md

@@ -96,9 +96,26 @@ description: 'Проводит полное read-only ревью diff, ветк
 - `previous_reviews` → `eda-review-previous-reviews`;
 - остальные → `eda-review-<check>`.
 
-В Claude Code запускай установленный custom agent через `Agent` tool. В Codex запускай установленный custom agent через `spawn_agent` или аналог. Передай выбранную модель как runtime override. Если хост не умеет применить выбранную модель или нативные субагенты недоступны, остановись: не выполняй роли главным агентом и не создавай отдельные CLI-процессы.
+В Claude Code запускай установленный custom agent через `Agent` tool. Установленная Claude-копия самого `eda-review` выполняется с `context: fork`, поэтому review-оркестрация не должна оставаться в контексте вызвавшего `eda-polish` или другого скила. В Codex каждого установленного custom agent запускай через `spawn_agent` с `fork_turns: "none"`; не оставляй `fork_turns` по умолчанию и не передавай историю review-runner. Передай выбранную модель как runtime override. Если хост не умеет применить выбранную модель или нативные субагенты недоступны, остановись: не выполняй роли главным агентом и не создавай отдельные CLI-процессы.
 
-Запусти все выбранные проверки одним параллельным пакетом; если хост ограничивает concurrency, разреши ему поставить лишние задачи в очередь. Каждому агенту передай только:
+### Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй проверку сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не считаются повторной содержательной проверкой агента.
+
+Сначала сформируй весь набор выбранных проверок, затем отправь все вызовы одним параллельным пакетом в одном ответе ассистента. Не дели проверки заранее на волны, партии или последовательные группы и не жди завершения части агентов перед запуском остальных. Если хост ограничивает concurrency, разреши нативному механизму поставить лишние задачи в очередь; повторный запуск допустим только после фактической ошибки лимита по правилам технических остановок выше.
+
+Ожидай результаты только нативным механизмом субагентов и их уведомлениями о завершении; в Codex используй `wait_agent`. Не используй Bash, shell-циклы, `sleep`, опрос файлов или артефактов и фиксированные таймауты для ожидания агентов. После отправки всего пакета собирай ответы по мере нативного завершения.
+
+Каждому агенту передай только:
 
 ```text
 Рабочая директория: <cwd>

package/skills/eda-review/skill.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "claude": {
+    "context": "fork",
+    "agent": "general-purpose"
+  }
+}

package/skills/eda-worktree/SKILL.md

@@ -27,6 +27,19 @@ description: 'Создаёт новый соседний git worktree и одн
 - Передавай агенту только рабочую директорию, данные текущего запуска и требуемый формат результата.
 - Если custom agent или инструмент субагентов недоступен, остановись: `blocked: нужен установленный агент eda-worktree-executor`. Не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
 
+## Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй работу сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не разрешают создавать второй worktree без сверки текущего состояния.
+
 ## Интерактивные вопросы
 
 Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю через общий паттерн `AskUserQuestion`.