@gian-tiaga/eda 3.2.1 → 3.2.2

package/README.md

@@ -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`. Никаких размытых ответственностей.

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "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

@@ -22,6 +22,19 @@ description: 'Итеративно ревьюит и исправляет изм
 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

@@ -98,6 +98,19 @@ description: 'Проводит полное read-only ревью diff, ветк
 
 В Claude Code запускай установленный custom agent через `Agent` tool. В Codex запускай установленный custom agent через `spawn_agent` или аналог. Передай выбранную модель как runtime override. Если хост не умеет применить выбранную модель или нативные субагенты недоступны, остановись: не выполняй роли главным агентом и не создавай отдельные CLI-процессы.
 
+### Технические остановки субагентов
+
+Техническую ошибку инструмента субагентов не смешивай со статусами `failed` и `blocked` содержательного контракта. Сохрани полный исходный текст ошибки и обработай её по причине:
+
+- лимит параллельности или отсутствие свободного слота — дождись уже запущенного этим workflow агента, при необходимости закрой завершённые потоки и повтори тот же запуск; если управляемых активных агентов нет, заверши `blocked: заняты слоты субагентов`;
+- лимит глубины вложения — не повторяй запуск и не выполняй проверку сам; заверши `blocked: достигнут лимит глубины субагентов`, указав наблюдаемую и требуемую глубину;
+- исчерпана usage-квота — не делай автоматических повторов; заверши `blocked: исчерпана квота`, сохрани время reset или условие продолжения, если хост его сообщил;
+- не хватает разрешения — запроси одно конкретное разрешение по правилам текущей среды и после ответа продолжи того же агента; в неинтерактивной среде заверши `blocked: нужно разрешение пользователя`;
+- временная API-, server-, overload- или network-ошибка — один раз продолжи того же агента; если resume недоступен, один раз запусти ту же роль с исходным входом, полным частичным результатом и требованием сначала сверить текущее состояние; повторный такой сбой заверши как `blocked` с исходной ошибкой;
+- неизвестная техническая ошибка — не угадывай причину и не зацикливай retry; заверши `blocked: техническая ошибка субагента` с полным исходным текстом.
+
+Ожидание слота и один технический retry не считаются повторной содержательной проверкой агента.
+
 Запусти все выбранные проверки одним параллельным пакетом; если хост ограничивает concurrency, разреши ему поставить лишние задачи в очередь. Каждому агенту передай только:
 
 ```text

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`.