@gian-tiaga/eda 3.14.0 → 4.0.0

package/lib/prompts.js

@@ -0,0 +1,53 @@
+import { cancel, intro, isCancel, log, multiselect, outro, select, updateSettings } from '@clack/prompts';
+
+updateSettings({ messages: { cancel: 'Отменено', error: 'Ошибка' } });
+
+// Промпты принимают { message, choices: [{ value, name, description, checked }], default },
+// поэтому установщик и тесты не зависят от API конкретной TUI-библиотеки.
+// Подсказки clack по клавишам англоязычные, поэтому они отключены и заменены своими.
+
+export async function selectPrompt({ message, choices, default: initialValue }, { input, output } = {}) {
+  const value = await select({
+    message,
+    options: choices.map(toOption),
+    initialValue,
+    showInstructions: false,
+    input,
+    output
+  });
+  return unlessCancelled(value, output);
+}
+
+export async function checkboxPrompt({ message, choices, required = false }, { input, output } = {}) {
+  for (;;) {
+    const value = unlessCancelled(await multiselect({
+      message: `${message}\nПробел — отметить, Enter — продолжить`,
+      options: choices.map(toOption),
+      initialValues: choices.filter(choice => choice.checked).map(choice => choice.value),
+      required: false,
+      showInstructions: false,
+      input,
+      output
+    }), output);
+    if (!required || value.length > 0) return value;
+    log.warn('Отметьте хотя бы один вариант.', { output });
+  }
+}
+
+export function startPrompts(title, { output } = {}) {
+  intro(title, { output });
+}
+
+export function finishPrompts(message, { output } = {}) {
+  outro(message, { output });
+}
+
+function toOption({ value, name, description }) {
+  return { value, label: name, ...(description ? { hint: description } : {}) };
+}
+
+function unlessCancelled(value, output) {
+  if (!isCancel(value)) return value;
+  cancel('Установка прервана.', { output });
+  throw new Error('Установка прервана пользователем.');
+}

package/lib/renderers/codex-agent.js

@@ -1,3 +1,5 @@
+import { CODEX_READING_RULE } from './codex-skill.js';
+
 function tomlString(value) {
   return JSON.stringify(value);
 }
@@ -19,6 +21,6 @@ export function renderCodexAgent(agent, prompt) {
   if (agent.access === 'read-only') lines.push('sandbox_mode = "read-only"');
   if (agent.access === 'workspace-write') lines.push('sandbox_mode = "workspace-write"');
 
-  lines.push('developer_instructions = """', prompt.trimEnd(), '"""', '');
+  lines.push('developer_instructions = """', prompt.trimEnd(), '', `## Чтение файлов\n\n${CODEX_READING_RULE}`, '"""', '');
   return lines.join('\n');
 }

package/lib/renderers/codex-skill.js

@@ -1,3 +1,23 @@
+// Codex обрезает середину длинного вывода команды, и агент принимает остаток за прочитанный файл.
+// Блок вставляется после front matter каждого скила, как адаптер OpenCode.
+export const CODEX_READING_RULE = 'Читай файлы полностью. Вывод с пометкой `tokens truncated` или `truncated output` — не прочитанный файл: дочитай пропущенный диапазон по строкам (`sed -n \'A,Bp\'`) до последней строки. Файл больше 400 строк или 20 КБ сразу читай частями. Документы рамки (`AGENTS.md`, `docs/rules*`, `docs/arch*`, карточки `docs/business/` и `docs/references/`) и план — только целиком.';
+
+const CODEX_INSTRUCTIONS = `## Среда исполнения: Codex
+
+Этот раздел адаптирует только платформенные механизмы инструкции ниже; её scope, режимы исполнения, подтверждения и контракты результатов сохраняются.
+
+- ${CODEX_READING_RULE}
+- \`AskUserQuestion\` в инструкции — блокирующий вопрос: \`request_user_input\`, если инструмент доступен, иначе короткий вопрос с вариантами в чат и остановка до ответа. В \`codex exec\` не читай stdin, верни \`blocked: нужен ответ пользователя\`.
+- \`Agent\` в инструкции — \`spawn_agent\` с \`fork_turns: "none"\`.
+- Если инструкция требует Plan Mode, а Plan mode не включён, покажи полный текст в чате и остановись до подтверждения. План — документ из инструкции; \`update_plan\` его не заменяет.
+
+`;
+
 export function renderCodexSkill(content) {
-  return content;
+  const closingMarker = content.indexOf('\n---', 4);
+  if (!content.startsWith('---\n') || closingMarker === -1) {
+    throw new Error('Не удалось добавить настройки Codex: некорректный front matter скила.');
+  }
+  const bodyStart = closingMarker + '\n---'.length;
+  return `${content.slice(0, bodyStart)}\n\n${CODEX_INSTRUCTIONS}${content.slice(bodyStart).trimStart()}`;
 }

package/lib/renderers/opencode-skill.js

@@ -6,8 +6,8 @@ const OPEN_CODE_INSTRUCTIONS = `## Среда исполнения: OpenCode V2
 - Установленного агента запускай через \`subagent\` с \`agent: <имя>\` и \`prompt: <вход>\`. Для изолированного выполнения скила используй установленного \`eda-skill-runner\` с указанием загрузить нужный скил. Дочерние сессии получают свежий контекст: передавай весь необходимый вход явно. Не передавай Codex-параметр \`fork_turns\`.
 - Для параллельных проверок отправь независимые вызовы одновременно, используй background только при независимой работе; ожидай уведомления, не опрашивай shell или файлы. Для продолжения передай \`sessionID\` того же агента.
 - Не заменяй \`eda-skill-runner\` встроенным general: general не может запускать субагентов. При недоступности нужной роли, вложенного запуска или инструмента верни конкретный \`blocked\`, не меняй режим и не подменяй работу отдельным CLI или основным агентом.
-- Вместо \`AskUserQuestion\` / \`request_user_input\` используй \`question\`; если интерактивный инструмент недоступен, задай короткий вопрос и остановись. В неинтерактивном запуске не читай stdin, верни \`blocked: нужен ответ пользователя\`.
-- Модели из колонок Claude/Codex и \`review.agents.*.model.claude/codex\` не относятся к OpenCode. По умолчанию используй модель установленного агента или наследуемую модель сессии; в поле MODEL передавай фактическую модель, иначе \`current\`. Явный runtime override должен иметь формат \`provider/model#variant\` (variant необязателен); если хост не может его применить, верни \`blocked\`. Не выдумывай provider ID и не переписывай настройки проекта.
+- Вместо \`AskUserQuestion\` используй \`question\`; если интерактивный инструмент недоступен, задай короткий вопрос и остановись. В неинтерактивном запуске не читай stdin, верни \`blocked: нужен ответ пользователя\`.
+- Модели из колонок Claude/Codex в таблицах скилов не относятся к OpenCode. По умолчанию используй модель установленного агента или наследуемую модель сессии; в поле MODEL передавай фактическую модель, иначе \`current\`. Явный runtime override должен иметь формат \`provider/model#variant\` (variant необязателен); если хост не может его применить, верни \`blocked\`. Исключение — \`review.agents\` в \`eda-review\`: значение \`provider/model#variant\` передавай как есть, а неприменимое заменяй моделью агента с warning по правилам скила. Не выдумывай provider ID и не переписывай настройки проекта.
 - Read-only агенты не имеют shell, редакторов, MCP и субагентов. Оркестратор заранее получает diff и нужные git/CI-данные разрешёнными read-only командами и передаёт их вместе с исходным target в prompt. Агент может дочитывать исходники; отсутствие shell не означает, что тесты были выполнены. Если доказательств недостаточно, сообщи блокер.
 - Если инструкция требует Plan Mode, используй доступный нативный режим планирования без изменения кода. Если его нет либо он запрещает сохранение подтверждённого плана в требуемый каталог, остановись с конкретным блокером, не обходи permissions.
 - Для strict кросс-CLI ревью из OpenCode попроси выбрать Claude Code или Codex CLI, если CLI не указан явно. Не считай OpenCode автоматически одной из двух сторон и не пропускай включённый strict.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "3.14.0",
+  "version": "4.0.0",
   "description": "Пакет скилов и специализированных агентов eda-* для Claude Code, Codex CLI и OpenCode",
   "type": "module",
   "bin": {
@@ -40,8 +40,7 @@
     "url": "https://github.com/falur/eda/issues"
   },
   "dependencies": {
-    "@inquirer/checkbox": "^4.3.2",
-    "@inquirer/select": "^5.1.5",
+    "@clack/prompts": "^1.8.1",
     "yaml": "^2.9.0"
   }
 }

package/skills/_shared/done.md

@@ -0,0 +1,15 @@
+## Доказательство готовности
+
+«Готово», «исправлено», «тесты проходят» пиши только с доказательством из текущего запуска: команда и итог из её вывода — число прошедших и упавших тестов, код выхода, ошибки.
+
+| Утверждение | Доказательство | Не доказательство |
+|---|---|---|
+| Тесты, линтер, typecheck или сборка проходят | команда в этом запуске и её итог: 0 падений, код выхода 0 | прошлый запуск; «должно пройти»; линтер вместо сборки |
+| Ошибка исправлена | исходный симптом воспроизведён до правки и не воспроизводится после той же проверкой | код изменён |
+| Регрессионный тест ловит ошибку | тест падает на коде до исправления и проходит после | тест один раз прошёл |
+| Пункт плана или задачи выполнен | сверка изменений с текстом пункта | зелёные тесты |
+| Субагент выполнил работу | diff и проверка результата | отчёт субагента |
+
+- Проверку, которую не удалось запустить, называй невыполненной с причиной, а не пройденной.
+- Новые предупреждения и ошибки в выводе проверок — тоже результат: сообщи о них.
+- **Не перебирай исправления.** Если три попытки исправить одну и ту же проблему не помогли, четвёртую не делай: остановись и сообщи, что пробовал, что наблюдал и какую причину подозреваешь — вероятно, неверен сам подход. Если скил задаёт свой лимит повторов или порядок продолжения, действует он.

package/skills/_shared/questions.md

@@ -0,0 +1,9 @@
+## Как задавать вопросы
+
+Пользователю — только решения. Факты из кода, документов, истории и внешних источников выясняй сам. Какие решения выносить на вопрос, задают правила этого скила и его режим решений, если он есть; здесь — как спрашивать.
+
+1. **Дерево решений.** Выпиши открытые решения и для каждого — какие другие решения нужны, чтобы его задать. Граница — решения, у которых все такие предпосылки уже закрыты.
+2. **Раунд — вся граница сразу.** Задай все вопросы границы одним раундом, а не по одному. Вопрос, варианты которого зависят от ответа на другой вопрос этого же раунда, переносится в следующий. Если инструмент принимает меньше вопросов за вызов, задай раунд несколькими вызовами подряд. Каждый вопрос — внутри инструмента вопросов, а не дополнительным абзацем рядом с ним: такой вопрос теряется.
+3. **Вопрос с рекомендацией.** В каждом вопросе: суть одной фразой; почему это важно — что изменится в результате; 2–4 варианта; рекомендованный вариант первым с пометкой «(рекомендую)» и причиной. Формулируй так, чтобы согласие принимало рекомендацию.
+4. **Следующий раунд.** Ответы закрывают решения и открывают зависящие от них: пересчитай границу и задай следующий раунд. Не переспрашивай то, на что уже ответили, и не повторяй вопрос другими словами.
+5. **Конец вопросов.** Вопросы заканчиваются, когда граница пуста: каждое решение закрыто ответом, выяснено по фактам или выбрано самостоятельно там, где режим это разрешает. Только после этого переходи к результату.

package/skills/eda-aim/SKILL.md

@@ -62,9 +62,8 @@ aim:
 
 В ручном режиме передай вопрос пользователю:
 
-- Claude Code: используй `AskUserQuestion`;
-- Интерактивный Codex: используй `request_user_input`, если доступен; иначе задай короткий вопрос с вариантами и остановись до ответа;
-- Неинтерактивный Codex: не читай stdin; заверши `blocked: нужен ответ пользователя` и перечисли вопрос с вариантами.
+- интерактивный запуск: `AskUserQuestion`, затем остановись до ответа;
+- неинтерактивный запуск: не читай stdin; заверши `blocked: нужен ответ пользователя` и перечисли вопрос с вариантами.
 
 В автоматическом режиме не спрашивай пользователя: выбери `recommended_answer`, если он не противоречит исходному запросу, правилам или безопасности; иначе выбери лучший безопасный вариант по фактам проекта. Запиши автоматический ответ в данные продолжения и передай тому же агенту. Не принимай автоматически необратимые внешние действия, расширение цели, публикацию, расходы, удаление данных или ослабление проверок — для них нужен человек.
 

package/skills/eda-business/SKILL.md

@@ -32,17 +32,16 @@ description: 'Создаёт и обновляет согласованное о
 11. **`about` — только обзор.** Это не сводная бизнес-спецификация и не каталог остальных карточек. Кратко опиши сам проект и перечисли его основные пользовательские возможности; не раскладывай их по модулям и не детализируй правила, сценарии и исключения других тем.
 12. **Карточка не привязана к коду.** Код, тесты и конфиги используй для поиска вопросов и проверки текущего поведения, но пиши карточку устойчивым предметным языком. Не включай пути и строки исходников, имена классов, функций, файлов и внутренних модулей — в том числе в `about` и `Расхождения с реализацией`.
 13. **Алгоритм допустим, стек — нет.** Фиксируй выбранный функциональный или security-механизм, если он определяет поведение продукта: например, JWT либо непрозрачные токены с хранением в базе данных, правила выпуска, срока действия, обновления и отзыва. Не регламентируй язык, framework, библиотеку, конкретную СУБД, таблицы и способ программной сборки механизма, если это не отдельное подтверждённое ограничение продукта.
+14. **Карточка не больше 20 КБ.** Тему, которая не помещается, раздели на самостоятельные подтемы с отдельными карточками и строками индекса, а не урезай правила. Карточка описывает текущее согласованное поведение: изменение вносится в раздел-владелец на месте, без датированных дополнений и журнала изменений.
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
 
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос с 2–3 вариантами, рекомендацией и остановись до ответа.
-- Codex exec / неинтерактивный запуск: не читай stdin. Если требуется решение или подтверждение, заверши `blocked: нужен ответ пользователя`, перечисли варианты и не записывай неподтверждённые файлы.
+- Неинтерактивный запуск: не читай stdin. Если требуется решение или подтверждение, заверши `blocked: нужен ответ пользователя`, перечисли варианты и не записывай неподтверждённые файлы.
 - Не запускай команды, ожидающие интерактивный ввод в терминале.
 
-Задавай пакетами не больше трёх связанных вопросов. Не спрашивай факты, которые можно надёжно выяснить из проекта.
+<!-- include: skills/_shared/questions.md -->
 
 ## Процесс
 
@@ -133,7 +132,7 @@ description: 'Создаёт и обновляет согласованное о
 Убедись, что:
 
 - индекс содержит только существующие согласованные карточки и ровно две колонки `Описание` и `Карточка`;
-- новая или обновлённая карточка соответствует подтверждённому содержанию;
+- новая или обновлённая карточка соответствует подтверждённому содержанию, не больше 20 КБ и без датированных дополнений;
 - карточка не содержит сведений о соседних темах и не раздута необязательными разделами;
 - `about` остаётся коротким обзором проекта и его основных возможностей без описания внутренних модулей;
 - сложная тема подробно фиксирует все значимые подтверждённые правила, алгоритмы, состояния и исключения;

package/skills/eda-commit/SKILL.md

@@ -52,9 +52,8 @@ description: 'Коммитит выбранные или все незакомм
 
 Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю.
 
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: используй `request_user_input`, если доступен; иначе задай короткий вопрос с вариантами 1–3 и остановись до ответа.
-- Codex exec / неинтерактивный запуск: не читай stdin; заверши со статусом `blocked: нужен ответ пользователя`, перечисли вопрос и варианты.
+- Интерактивный запуск: `AskUserQuestion`, затем остановись до ответа.
+- Неинтерактивный запуск: не читай stdin; заверши со статусом `blocked: нужен ответ пользователя`, перечисли вопрос и варианты.
 - Никогда не задавай общий вопрос о дальнейших действиях, если `$REQUESTED_ACTIONS` уже содержит их.
 
 После ответа сохрани исходный `$USER_REQUEST`, добавь новый ответ и продолжи того же агента, если хост это поддерживает. Иначе запусти этого же custom agent заново с предыдущим результатом, актуальным состоянием и ответом.

package/skills/eda-discover-automations/SKILL.md

@@ -36,10 +36,8 @@ description: 'Аудирует автоматические проверки п
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
 - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
 
 ## Этапы
@@ -69,18 +67,19 @@ description: 'Аудирует автоматические проверки п
 4. **Стиль и качество:** formatter, linter, naming, complexity, duplication, dead code, unused exports/dependencies, forbidden patterns, TODO/FIXME policy и лимиты размера.
 5. **Статический анализ:** typecheck, nullability, data-flow/taint, API misuse, unreachable code, unsafe/undefined behavior, memory/thread/address sanitizers и анализаторы выбранного языка.
 6. **Границы кода:** forbidden imports, dependency direction, cycles, layers, public API, ownership, package/module boundaries, generated-code boundaries и architecture fitness functions.
-7. **Конфиги и инфраструктура:** schema/parse для env, YAML/JSON/TOML, CI, Docker/Compose, Kubernetes/Helm, Terraform/IaC, proxy, feature flags, IAM, observability и env-example drift.
+7. **Конфиги и инфраструктура:** schema/parse для env, YAML/JSON/TOML, CI, Docker/Compose и Dockerfile lint, Kubernetes/Helm, Terraform/IaC, proxy и его анализатор конфигурации, редиректы на HTTPS и канонический хост, HSTS, feature flags, IAM, observability и env-example drift.
 8. **API и совместимость:** OpenAPI/GraphQL/Proto, breaking changes, generated-code drift, serialization, backward/forward compatibility, idempotency, pagination/filter/sort.
 9. **БД и данные:** migration lint/forward/rollback/dry-run, schema drift, constraints, fixtures, transactions, concurrency, query plans/N+1, backup/restore, retention/anonymization и data invariants.
 10. **Безопасность и supply chain:** secrets, SAST, DAST, dependency/container/IaC scan, licenses, SBOM, lockfile integrity, provenance/signatures, authn/authz negative tests, injection, XSS/CSRF/SSRF, CORS/CSP/headers, rate limits и PII leakage.
-11. **Производительность и надёжность:** benchmarks/budgets, bundle size, load/stress/spike/soak, leaks, startup, timeouts/retries/circuit breakers, graceful shutdown, fault injection/chaos и recovery.
+11. **Производительность и надёжность:** benchmarks/budgets, тесты на число запросов к БД и внешних вызовов на операцию, bundle size и бюджет веса CSS/JS, проверка сжатия и кеш-заголовков production после деплоя, load/stress/spike/soak, leaks, startup, timeouts/retries/circuit breakers, graceful shutdown, fault injection/chaos и recovery.
 12. **Сборка и релиз:** clean-clone/reproducible build, generated artifacts, package contents, runtime/OS/architecture matrix, install/upgrade/downgrade, semver/changelog, release dry-run, canary/rollback и post-deploy smoke.
 13. **Документация:** Markdown/style/spell, links, executable snippets, CLI help/API docs drift, diagrams/schemas и migration/release notes.
 14. **Эксплуатация:** health/readiness/liveness, metrics/log/trace schemas, no secrets/PII in logs, alert rules, dashboards as code, SLO/error budgets, disaster recovery и restore drills.
 15. **Доменные проверки:** платежи, почта, очереди, jobs, webhooks, поиск, файлы/media, mobile signing, offline/sync, localization, analytics events и другие инварианты продукта.
 16. **AI-функции:** prompt/output schemas, evals, prompt injection/jailbreak, data leakage, tool permissions, nondeterminism, latency и token/cost budgets.
 17. **MCP:** browser/Playwright MCP для сценариев и визуальных доказательств; MCP для БД, API, документации, GitHub/GitLab, cloud, observability и выбранного языка/фреймворка. Укажи точный сценарий, минимальные права и почему CLI/CI недостаточно.
-18. **Агентный процесс и планы:** чтение обязательных источников, формат артефактов, проверка критериев готовности, файлов/модулей и зависимостей задач, rollback/backup для рискованных действий, запрет пропуска команд и повторяющиеся ошибки агентов.
+18. **SEO и индексация:** для публичных страниц — коды ответов и редиректы, canonical, robots и `noindex` в production, sitemap, title/description, hreflang, структурированные данные и SEO-аудит страниц в CI.
+19. **Агентный процесс и планы:** чтение обязательных источников, формат артефактов, проверка критериев готовности, файлов/модулей и зависимостей задач, rollback/backup для рискованных действий, запрет пропуска команд и повторяющиеся ошибки агентов.
 
 Для каждого паттерна собери: доказательство из истории либо baseline-пробел в текущем проекте, затронутые файлы, возможный ущерб, вероятность, надёжность проверки и стоимость внедрения. Повторяющиеся паттерны обычно приоритетнее, но не отбрасывай сильного кандидата из-за одного случая или потому, что ошибка ещё не произошла.
 

package/skills/eda-explore/SKILL.md

@@ -34,27 +34,33 @@ description: 'Исследует техническую тему или зада
 
 Всегда значимые развилки: новые зависимости и сервисы; БД/ORM/очереди/кэш/storage/search/background jobs; миграции и формат хранения; auth/permissions/payments/secrets/персональные данные; cloud/provider/cost/lock-in/SLA; архитектурные паттерны и публичные контракты; продуктовые компромиссы скорости, качества, UX, стоимости, срока или объёма; выбор, который влияет на то, какой результат будет передан в `eda-plan`.
 
-Не начинай с вопросов, если можно сначала быстро собрать факты. После первичного контекста сгруппируй близкие развилки в пакет из 1–3 вопросов. Если выбрать нельзя без пользовательского решения, задай `AskUserQuestion` и не продолжай финализацию.
+Не начинай с вопросов, если можно сначала быстро собрать факты. Если выбрать нельзя без пользовательского решения, задай вопрос по разделу «Как задавать вопросы» и не продолжай финализацию.
+
+<!-- include: skills/_shared/questions.md -->
 
 ## Главные правила
 
 1. **Никаких правок кода.** Запись только в `docs/artifacts/researches/`.
 2. **Итог — конкретика.** Нельзя заканчивать абстрактными описаниями, списком возможностей или «можно выбрать один из вариантов».
 3. **Развилки закрывай по `decision_mode`.** Значимые развилки подтверждай до финализации, мелкие локальные решения выбирай сам и не создавай шум.
-4. **Риски вплетай в исследование.** Не создавай отдельный обязательный раздел или этап рисков. Если риск влияет на выбор, источник, ограничение или будущую проверку, фиксируй его рядом с соответствующим решением: что может пойти не так и как это учитывается — снимаем, принимаем или выносим за рамки.
-5. **Версии проверяй.** Если речь о пакетах, библиотеках, CLI, сервисах или другом ПО, а версия не задана контекстом, проверь последнюю стабильную версию через context7, если он доступен, или через web search по официальным источникам.
-6. **Прочитай рамку проекта.** Прочитай `docs/rules.md` и `docs/arch.md`, если есть. Сначала определи исследуемую задачу, затем через `docs/business.md` выбери только карточки затронутого поведения, а через `docs/references.md` — только карточки затронутых компонентов. Нерелевантные карточки не загружай.
-7. **Разделяй источники.** Текущий запрос задаёт область исследования; применимые business-карточки — требования к затронутому поведению; rules, architecture и references — техническая рамка. Если запрос противоречит business-карточке, остановись и через `AskUserQuestion` спроси, изменить задачу или пересогласовать правило через `eda-business`. Не рекомендуй отклонение от технического эталона без явной причины и подтверждения пользователя.
-7. **Каждое фактическое утверждение — со ссылкой** (`file.ext:42`, URL, коммит). Без ссылки — помечай как «гипотеза» и не делай её основанием выбранного решения.
-8. **Простой язык.** Термины — только когда без них нельзя, сразу с пояснением.
-9. **Таблицы > сплошной текст** для фактов, развилок, сравнений, версий и источников.
+4. **Все открытые вопросы закрываются до сохранения.** Открытый вопрос — любое невыясненное место, от которого зависят выбранное решение, границы задачи, контракт или следующий шаг: развилка без выбора, непроверенный факт, недостающее требование, гипотеза в основании решения, условная рекомендация «если X — A, иначе B» без выясненного X, «уточнить позже», «требует дополнительного исследования», «TBD». Каждый такой вопрос закрой одним из способов:
+   - выясни по коду, документам или источникам и дай ссылку;
+   - реши по `decision_mode`: в `autonomous` выбери сам и запиши причину, в остальных режимах спроси пользователя через `AskUserQuestion`;
+   - вынеси за границы исследования только с подтверждением пользователя (в `autonomous` — с записанной причиной) и запиши границу в `Суть`.
+
+   Вопрос, который не меняет решение, границы, контракт или следующий шаг, не поднимай и в отчёт не пиши. Раздела «Открытые вопросы» в отчёте нет. Если вопрос нельзя закрыть без пользователя, а спросить нельзя, заверши `blocked: нужен ответ пользователя` и перечисли вопросы; отчёт с открытыми вопросами не выдавай за готовый.
+5. **Риски вплетай в исследование.** Не создавай отдельный обязательный раздел или этап рисков. Если риск влияет на выбор, источник, ограничение или будущую проверку, фиксируй его рядом с соответствующим решением: что может пойти не так и как это учитывается — снимаем, принимаем или выносим за рамки.
+6. **Версии проверяй.** Если речь о пакетах, библиотеках, CLI, сервисах или другом ПО, а версия не задана контекстом, проверь последнюю стабильную версию через context7, если он доступен, или через web search по официальным источникам.
+7. **Прочитай рамку проекта.** Прочитай `docs/rules.md` и `docs/arch.md`, если есть. Сначала определи исследуемую задачу, затем через `docs/business.md` выбери только карточки затронутого поведения, а через `docs/references.md` — только карточки затронутых компонентов. Нерелевантные карточки не загружай.
+8. **Разделяй источники.** Текущий запрос задаёт область исследования; применимые business-карточки — требования к затронутому поведению; rules, architecture и references — техническая рамка. Если запрос противоречит business-карточке, остановись и через `AskUserQuestion` спроси, изменить задачу или пересогласовать правило через `eda-business`. Не рекомендуй отклонение от технического эталона без явной причины и подтверждения пользователя.
+9. **Каждое фактическое утверждение — со ссылкой** (`file.ext:42`, URL, коммит). Без ссылки — помечай как «гипотеза» и не делай её основанием выбранного решения.
+10. **Простой язык.** Термины — только когда без них нельзя, сразу с пояснением.
+11. **Таблицы > сплошной текст** для фактов, развилок, сравнений, версий и источников.
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
 - Не запускай команды, которые ждут интерактивного ввода в терминале.
 
 ## Этапы
@@ -66,6 +72,8 @@ description: 'Исследует техническую тему или зада
 - какой результат нужен пользователю;
 - какие вопросы должны быть закрыты, чтобы можно было переходить к плану или реализации.
 
+Запиши эти вопросы в рабочий список открытых вопросов и дополняй его всем, что всплывает при сборе контекста и сравнении вариантов. Список — внутренний инструмент: в отчёт он не идёт, туда попадают только закрывающие его факты, решения и ответы.
+
 Если тема неоднозначна или критерий готовности нельзя вывести из запроса — задай `AskUserQuestion` и остановись до ответа.
 
 ### 2. Собрать контекст
@@ -79,12 +87,14 @@ description: 'Исследует техническую тему или зада
 - выбирай последнюю стабильную версию, не preview/beta/rc, если пользователь явно не попросил иначе;
 - запиши источник, дату проверки и причину выбора.
 
-### 3. Закрыть развилки
+### 3. Закрыть развилки и открытые вопросы
 
 Собери значимые развилки: архитектурные, продуктовые, технические, миграционные, по зависимостям и совместимости. Для каждой дай варианты, выбранный вариант или рекомендацию, источник, причину и важные риски рядом с решением.
 
 Не прячь значимый выбор внутри текста: если нужен пакет, БД или другой ключевой компонент, сначала сравни 2–3 подходящих варианта, затем закрой выбор по `decision_mode`. Если появляется высокий риск без понятного решения, это блокер: задай `AskUserQuestion` или заверши со статусом `blocked`. Не выноси риски в отдельную секцию ради формы; они должны лежать в `Решении`, причинах выбора, ограничениях, проверках версий или итоговом выводе.
 
+Перед отчётом пройди весь рабочий список открытых вопросов — из критерия готовности этапа 1 и найденных по ходу — и закрой каждый по правилу 4. Не переходи к этапу 4, пока в списке остаётся хотя бы один незакрытый вопрос.
+
 ### 4. Собрать отчёт
 
 Сохрани отчёт в `docs/artifacts/researches/{YYYY-MM-DD}_{HH-MM}_{slug}.md`.
@@ -133,7 +143,9 @@ Quality gate перед сохранением:
 - в `Решение` есть описание архитектуры или явно сказано, почему архитектурный слой не затронут;
 - в `Ответы на вопросы` записаны все вопросы и пользовательские выборы по развилкам, заданные в процессе исследования, чтобы `eda-plan` не задавал их повторно;
 - в `Итог` есть короткая конкретика, что делать дальше на уровне подхода, без пошагового плана;
-- нет незакрытых развилок;
+- нет незакрытых развилок и открытых вопросов: каждый вопрос из критерия готовности этапа 1 и найденный по ходу закрыт фактом со ссылкой, решением или подтверждённой границей;
+- в отчёте нет «уточнить позже», «требует дополнительного исследования», «TBD», «на усмотрение», раздела «Открытые вопросы» и условных рекомендаций без выясненного условия;
+- выбранное решение не опирается на гипотезу;
 - нет рисков, которые перечислены отдельно от решения и никак не влияют на выбор, ограничения или будущие проверки;
 - нет высокого риска без понятного решения;
 - версии пакетов/ПО проверены или объяснено, почему это не требуется;
@@ -162,7 +174,7 @@ CLI нет — `AskUserQuestion`: продолжать без ревью или
 
 ### 6. Допилить по ревью — только в `strict`
 
-Бесспорные замечания → правь. Спорные → `AskUserQuestion`. Отклонённые → оставь с причиной. В конец отчёта добавь раздел `## Реакция на ревью` (Принято / Отклонено / Спорное). `status: reviewed`. Покажи дифф.
+Бесспорные замечания → правь. Спорные → `AskUserQuestion`. Отклонённые → оставь с причиной. Новые открытые вопросы из ревью закрой по правилу 4 до `status: reviewed`. В конец отчёта добавь раздел `## Реакция на ревью` (Принято / Отклонено / Спорное). `status: reviewed`. Покажи дифф.
 
 ### 7. Финал
 
@@ -172,6 +184,7 @@ CLI нет — `AskUserQuestion`: продолжать без ревью или
 
 - Править код, миграции, конфиги или зависимости.
 - Оставлять несколько равных вариантов «на выбор» в итоговом отчёте.
+- Сохранять отчёт с открытыми вопросами, «уточнить позже», «TBD» или разделом «Открытые вопросы».
 - Писать общий обзор вместо конкретного описания проблемы, архитектуры и решения.
 - Перечислять риски без выбранного закрытия.
 - Планировать реализацию по шагам — это работа `eda-plan`.

package/skills/eda-fix/SKILL.md

@@ -23,12 +23,12 @@ description: 'Вносит изменения в код по плану или
 6. **Историю фиксируй в `docs/artifacts/fixes/`.** Отчёт обязателен даже для маленькой правки.
 7. **Не коммить и не пушь.** Это `eda-commit`. Не делай ревью — это `eda-review`.
 
+<!-- include: skills/_shared/done.md -->
+
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
 - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
 
 ## Этапы
@@ -40,13 +40,13 @@ description: 'Вносит изменения в код по плану или
 Прочитай `docs/rules.md` и `docs/arch.md`, если есть. Сначала определи задачу фикса и затронутое поведение. Если связанный план содержит `sources.business`, прочитай только перечисленные применимые карточки; иначе через `docs/business.md` выбери по описаниям только карточки этой темы. Если подходящих карточек нет, продолжай без business-контекста. Если существует `docs/references.md`, выбери по индексу только применимые технические карточки и используй их примеры как ожидаемую форму реализации. Если `$FIX_CONTEXT` ссылается на research, review, issue или другой файл — прочитай и его.
 
 ### 3. Сделать фикс
-Найди релевантный код и внеси минимальные правки. Текущая задача задаёт scope, применимая business-карточка — требования к затронутому поведению, reference-карточка — форму реализации. Если задача противоречит business-карточке, остановись, покажи конфликт и через `AskUserQuestion` спроси: изменить задачу или сначала пересогласовать правило через `eda-business`. Следуй применимому техническому примеру; отклоняйся только по причине, подтверждённой пользователем или уже записанной во входном плане. Если задача состоит из нескольких пунктов, иди по ним последовательно. Останавливайся и спрашивай также при рискованной операции, миграции, удалении данных или работе с секретами.
+Если задача — ошибка, сначала воспроизведи её симптом тестом, командой или запросом и сохрани вывод. Если воспроизвести нельзя, напиши в отчёте, что пробовал и по каким признакам выбрано исправление. Затем найди релевантный код и внеси минимальные правки. Текущая задача задаёт scope, применимая business-карточка — требования к затронутому поведению, reference-карточка — форму реализации. Если задача противоречит business-карточке, остановись, покажи конфликт и через `AskUserQuestion` спроси: изменить задачу или сначала пересогласовать правило через `eda-business`. Следуй применимому техническому примеру; отклоняйся только по причине, подтверждённой пользователем или уже записанной во входном плане. Если задача состоит из нескольких пунктов, иди по ним последовательно. Останавливайся и спрашивай также при рискованной операции, миграции, удалении данных или работе с секретами.
 
 ### 4. Добавить или обновить тесты
-Если фикс меняет поведение — добавь тест рядом с изменением или обнови существующий. Если тесты не нужны, в отчёте коротко объясни почему.
+Если фикс меняет поведение — добавь тест рядом с изменением или обнови существующий. Тест на исправленную ошибку должен падать на коде до исправления. Если тесты не нужны, в отчёте коротко объясни почему.
 
 ### 5. Финальная проверка
-Прогони подходящие тесты и линтеры. Команды определи по стеку проекта. Свои поломки — исправь и повтори. Чужие или несвязанные поломки — зафиксируй в отчёте и спроси через `AskUserQuestion`, если без решения нельзя продолжать.
+Повтори проверку, которой воспроизводил ошибку: симптом больше не воспроизводится. Прогони подходящие тесты и линтеры. Команды определи по стеку проекта. Свои поломки — исправь и повтори. Чужие или несвязанные поломки — зафиксируй в отчёте и спроси через `AskUserQuestion`, если без решения нельзя продолжать.
 
 ### 6. Сохранить отчёт
 Сохрани отчёт в `docs/artifacts/fixes/{YYYY-MM-DD}_{HH-MM}_{slug}.md`.

package/skills/eda-fix-by-review/SKILL.md

@@ -24,13 +24,14 @@ description: 'Исправляет код по готовому ревью из
 7. В конце обязательно прогони полный набор тестов и линтеров один раз.
 8. Пиши просто и конкретно; в отчёте используй таблицу.
 
+<!-- include: skills/_shared/done.md -->
+
 ## Интерактивные вопросы
 
 Когда без ответа нельзя безопасно продолжать:
 
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: используй `request_user_input`, если доступен; иначе задай один короткий вопрос с 2–3 вариантами и остановись до ответа.
-- Codex exec и другой неинтерактивный запуск: не читай stdin; верни `blocked: нужен ответ пользователя`, перечисли вопрос и варианты, не выполняй рискованное действие.
+- Интерактивный запуск: `AskUserQuestion`, затем остановись до ответа.
+- Неинтерактивный запуск: не читай stdin; верни `blocked: нужен ответ пользователя`, перечисли вопрос и варианты, не выполняй рискованное действие.
 
 Не запускай команды, которые ждут интерактивного ввода в терминале. Вопрос не разрешает молча заменить находку другой правкой или исправлять несвязанные поломки.
 

package/skills/eda-just-do-it/SKILL.md

@@ -24,6 +24,8 @@ description: 'Прямо выполняет задачу, указанную п
 7. **Новый проект разворачивай штатным CLI.** Если для выбранного стека существует официальный generator/scaffold CLI, используй его через package manager или runtime (`composer create-project`, `npm create`, `npx`, `cargo new` или реальный аналог), а не создавай генерируемую основу вручную. Затем меняй полученный scaffold в рамках запроса. Если подходящих CLI несколько и выбор меняет результат, задай `AskUserQuestion`.
 8. **Артефакт обязателен.** Создай отчёт до первого содержательного изменения и поддерживай его в актуальном состоянии. Заверши отчёт даже при частичном результате, блокере или ошибке.
 
+<!-- include: skills/_shared/done.md -->
+
 ## Как выбрать контекст
 
 1. Прочитай применимые `AGENTS.md` и другие проектные инструкции для затронутых путей.
@@ -46,11 +48,9 @@ description: 'Прямо выполняет задачу, указанную п
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
 
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, запиши вопрос и варианты в отчёт.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, запиши вопрос и варианты в отчёт.
 - Не запускай команды, которые ждут интерактивного ввода в терминале.
 
 ## Артефакт

package/skills/eda-manual-test/SKILL.md

@@ -48,10 +48,8 @@ description: 'Проводит ручную проверку изменений
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
 - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
 
 ## Этапы
@@ -76,7 +74,7 @@ description: 'Проводит ручную проверку изменений
 | Раздел артефакта | Что из него обязательно проверить |
 |---|---|
 | Задача, критерии готовности | каждый заявленный результат — отдельным сценарием |
-| Целевой алгоритм | каждый путь от входного события до финального состояния, включая ошибочные ветки |
+| Целевой алгоритм | каждый сценарий от первого шага до результата, включая ветки «Если …» и ошибки |
 | Контракты: Данные и БД | каждую таблицу, поле, связь, индекс, unique и миграцию |
 | Контракты: API и внешние контракты | каждый новый и изменённый endpoint, событие, очередь, внешний вызов |
 | Фазы выполнения | `Результат` и `Проверка` каждой фазы |
@@ -101,6 +99,8 @@ description: 'Проводит ручную проверку изменений
 | Права и роли | что доступ есть у кого положено и его нет у остальных — на API и в интерфейсе |
 | Конфигурация | новые env-переменные и настройки: значение по умолчанию, поведение при отсутствии и при выключенной фиче |
 | Логи и ошибки | по сценарию пишутся ожидаемые записи с нужными полями; в логах и ответах нет секретов и stack traces наружу |
+| Скорость и отдача | изменённые страницы и endpoints: время ответа сервера и полной загрузки, вес HTML, CSS, JS и изображений; сжатие (`Content-Encoding`) и кеширование статики (`Cache-Control`) по заголовкам ответа; рост относительно состояния до изменения, если его можно замерить |
+| Ответ наружу | ошибка и несуществующий адрес не показывают stack trace, текст SQL и пути к файлам; debug выключен; заголовки безопасности, которые ставит проект, на месте; в консоли браузера нет отладочного вывода |
 | Регрессии рядом | соседние сценарии, которые используют изменённый код или таблицы, продолжают работать |
 
 В `smoke` глубоко проверяется только основной сценарий изменённой области; остальные области помечаются `— не проверялось в smoke`.
@@ -161,6 +161,8 @@ status: <passed | failed | blocked>
 | Права и роли | | |
 | Конфигурация | | |
 | Логи и ошибки | | |
+| Скорость и отдача | | |
+| Ответ наружу | | |
 | Регрессии рядом | | |
 
 ## Чеклист

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

@@ -42,9 +42,8 @@ description: 'Мержит ветку из соседнего git worktree в т
 
 Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю через общий паттерн `AskUserQuestion`.
 
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: используй `request_user_input`, если доступен; иначе задай один короткий вопрос с 1–3 вариантами и остановись до ответа.
-- Codex exec / неинтерактивный запуск: не читай stdin; заверши со статусом `blocked: нужен ответ пользователя`, перечисли вопрос и варианты.
+- Интерактивный запуск: `AskUserQuestion`, затем остановись до ответа.
+- Неинтерактивный запуск: не читай stdin; заверши со статусом `blocked: нужен ответ пользователя`, перечисли вопрос и варианты.
 - Не запускай команды, которые ждут интерактивного ввода в терминале.
 
 После ответа продолжи того же агента, если хост это поддерживает. Иначе запусти `eda-merge-worktree-executor` заново с исходным запросом, полным предыдущим результатом и ответом пользователя.

package/skills/eda-new-project/SKILL.md

@@ -27,13 +27,11 @@ description: 'Собирает и согласует требования, гр
 
 ## Интерактивные вопросы
 
-Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
-- Claude Code: используй `AskUserQuestion`.
-- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
-- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос: задай его и остановись до ответа.
+- Неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
 - Не запускай команды, которые ждут интерактивного ввода в терминале.
 
-Вопросы задавай пакетами по 1–3 решения за раз. Считай каждую отдельную развилку, включая вопрос без номера и уточнение после списка; не добавляй четвёртый вопрос другим абзацем. Сначала спрашивай только то, без чего следующий шаг будет гаданием. После каждого пакета используй ответ, обновляй рекомендацию и продолжай.
+<!-- include: skills/_shared/questions.md -->
 
 ## Этапы