@gian-tiaga/eda 0.4.6 → 0.5.1

package/README.md

@@ -3,7 +3,7 @@
 > Поточная разработка с AI-агентами — на русском языке.
 > Набор готовых скилов для **Claude Code** и **Codex CLI**, которые ведут тебя через весь цикл: от исследования до коммита.
 
-`eda` — это десять скилов, каждый отвечает за свой кусок работы. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
+`eda` — это одиннадцать скилов, каждый отвечает за свой кусок работы. Вместо того чтобы каждый раз объяснять модели, как делать ревью или как исполнять план, ты говоришь одно слово — и она следует чёткой инструкции на русском, со всеми правилами, проверками и артефактами в нужных папках.
 
 ---
 
@@ -19,7 +19,7 @@ npm install -g @gian-tiaga/eda
 eda init
 ```
 
-Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Если `docs/settings.yaml` ещё нет, установщик также предложит выбрать настройки скилов и создаст этот файл.
+Установщик покажет чекбоксы: стрелками выбираешь среду, пробелом отмечаешь, Enter продолжает. Можно поставить Claude Code, Codex CLI или обе среды сразу. Если `docs/settings.yaml` ещё нет, установщик также предложит выбрать настройки скилов и создаст этот файл. В конце `eda init` пишет, сколько скилов установлено.
 
 ---
 
@@ -27,6 +27,7 @@ eda init
 
 | Скил | Что делает | Куда складывает |
 |---|---|---|
+| `eda-roadmap` | Создаёт roadmap-файл: список будущих задач с короткими, понятными и недвусмысленными описаниями без деталей реализации, файлов, библиотек, API и пошагового плана | `docs/roadmaps/` |
 | `eda-explore` | Исследует тему до конкретного результата: описание проблемы, релевантная архитектура, закрытые развилки, риски внутри решений и короткий выбранный вариант решения без плана. Если нужны пакеты или ПО — проверяет актуальные стабильные версии через context7 или web search | `docs/researches/` |
 | `eda-plan` | Пишет план реализации через стандартный Plan Mode хост-агента. Подтягивает контекст из `docs/rules.md`, `docs/arch.md`, при желании — релевантное исследование. Затем три параллельных модели (слабая, средняя, мощная) проверяют план на реалистичность, пропущенные шаги и нарушения правил — главный планировщик сам решает, что применить | `docs/plans/` |
 | `eda-execute` | Выполняет план. Спрашивает, где работать (текущая ветка, новая ветка, отдельный worktree). Тесты пишет внутри каждого шага. В конце — полный прогон тестов и линтеров | `docs/executions/` |
@@ -64,22 +65,29 @@ eda init
 version: 1
 
 defaults:
+  # Включает strict-режим по умолчанию для eda-explore, eda-plan и eda-review.
   # true | false
   strict: false
+  # Задаёт размер плана по умолчанию для eda-plan.
   # normal | short | ask_each_time
   plan_size: normal
+  # Определяет, как eda-explore и eda-plan принимают существенные решения.
   # autonomous | recommend_and_ask | ask_each_time
   decision_mode: recommend_and_ask
+  # Задаёт стратегию тестов по умолчанию для eda-plan.
   # after_each_phase | tdd_each_phase | end_of_plan | ask_each_time
   test_strategy: ask_each_time
+  # Задаёт стратегию логирования по умолчанию для eda-plan.
   # debug_precise | standard | ask_each_time
   logging_strategy: ask_each_time
 
 automate:
+  # Добавляет docs/plans/ в обычный запуск eda-automate.
   # true | false
   include_plans: false
 
 review:
+  # Добавляет в eda-review проверку качества кода и meta-reviewer quality-check.
   # true | false
   include_code_quality: true
 ```
@@ -103,15 +111,15 @@ review:
 docs ───────────────┬───────────────┐
                     │               │
                     v               v
-explore ─────────> plan ────────> execute ───┬──> review ───> fix-by-review ───┬──> send-review
-                                             │                                  │
-                                             v                                  └──> commit
-                                            fix ─────────────> review
+roadmap ────────> explore ─────> plan ───> execute ───┬──> review ───> fix-by-review ───┬──> send-review
+                    │                                  │                                  │
+                    └──────────────> plan              v                                  └──> commit
+                                                      fix ─────────────> review
 
 automate может запускаться от review, fix-by-review или fix.
 ```
 
-Использовать всю цепочку не обязательно — каждый скил самодостаточен. Можно начать с `eda-explore`, или сразу с `eda-execute` на готовом плане, или просто `eda-commit`, когда правки уже сделаны.
+Использовать всю цепочку не обязательно — каждый скил самодостаточен. Можно начать с `eda-roadmap`, `eda-explore`, или сразу с `eda-execute` на готовом плане, или просто `eda-commit`, когда правки уже сделаны.
 
 ---
 
@@ -129,7 +137,7 @@ automate может запускаться от review, fix-by-review или fix
 
 ```bash
 eda init      # выбрать Claude Code / Codex / обе среды и установить скилы
-eda update    # обновить скилы и создать docs/settings.yaml, если его ещё нет
+eda update    # обновить скилы, показать их количество и создать docs/settings.yaml, если его ещё нет
 eda --version # показать версию установленного пакета
 eda --help    # справка
 ```
@@ -152,7 +160,7 @@ eda update           # синхронизировать скилы в текущ
 | **Claude Code** | `<project>/.claude/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
 | **Codex CLI** | `<project>/.codex/skills/<skill>/SKILL.md` — отдельная папка на каждый скил |
 
-`eda update` идемпотентно перезаписывает файлы в обеих папках. При обновлении старые файлы Codex-формата `<project>/.codex/skills/<skill>.md`, созданные версиями `eda` до этой структуры, удаляются. Если ты хочешь подправить скил локально — лучше копию сделай рядом, а не прямо в `.claude/skills/` или `.codex/skills/`, иначе при следующем `update` твои правки потеряются.
+`eda update` идемпотентно перезаписывает файлы в обеих папках и в конце пишет, сколько скилов обновлено. При обновлении старые файлы Codex-формата `<project>/.codex/skills/<skill>.md`, созданные версиями `eda` до этой структуры, удаляются. Если ты хочешь подправить скил локально — лучше копию сделай рядом, а не прямо в `.claude/skills/` или `.codex/skills/`, иначе при следующем `update` твои правки потеряются.
 
 `AGENTS.md` (как и любые другие файлы в корне проекта) установщик **не трогает**. Если хочешь, чтобы Codex автоматически подгружал скилы, дай ему знать сам — например, одной строкой в `AGENTS.md`: «следуй инструкциям из `.codex/skills/`».
 

package/lib/install.js

@@ -108,7 +108,7 @@ export async function init({ cwd, input = process.stdin, output = process.stdout
     return;
   }
   await ensureSettings(cwd, { input, output });
-  await syncSkills(cwd, targets, output);
+  await syncSkills(cwd, targets, output, { action: 'install' });
 }
 
 export async function update({ cwd, input = process.stdin, output = process.stdout }) {
@@ -119,7 +119,7 @@ export async function update({ cwd, input = process.stdin, output = process.stdo
   }
   output.write(`Найдены установленные среды: ${targets.join(', ')}\n`);
   await ensureSettings(cwd, { input, output });
-  await syncSkills(cwd, targets, output);
+  await syncSkills(cwd, targets, output, { action: 'update' });
 }
 
 export async function askTargets({ input = process.stdin, output = process.stdout } = {}) {
@@ -211,7 +211,7 @@ async function detectTargets(cwd) {
   return targets;
 }
 
-async function syncSkills(cwd, targets, output = process.stdout) {
+async function syncSkills(cwd, targets, output = process.stdout, { action = 'update' } = {}) {
   const skills = await listSkills();
   if (skills.length === 0) {
     throw new Error(`В пакете нет скилов (искал в ${SKILLS_SRC}).`);
@@ -222,6 +222,8 @@ async function syncSkills(cwd, targets, output = process.stdout) {
   if (targets.includes('codex')) await installToCodex(cwd, skills, output);
   await removeRetiredSkills(cwd, targets);
 
+  const actionLabel = action === 'install' ? 'Установлено' : 'Обновлено';
+  output.write(`${actionLabel} ${formatSkillCount(skills.length)}.\n`);
   output.write('\nГотово.\n');
 }
 
@@ -252,22 +254,29 @@ function formatSettings(settings) {
   return `version: 1
 
 defaults:
+  # Включает strict-режим по умолчанию для eda-explore, eda-plan и eda-review.
   # true | false
   strict: ${settings.strict ? 'true' : 'false'}
+  # Задаёт размер плана по умолчанию для eda-plan.
   # normal | short | ask_each_time
   plan_size: ${settings.planSize}
+  # Определяет, как eda-explore и eda-plan принимают существенные решения.
   # autonomous | recommend_and_ask | ask_each_time
   decision_mode: ${settings.decisionMode}
+  # Задаёт стратегию тестов по умолчанию для eda-plan.
   # after_each_phase | tdd_each_phase | end_of_plan | ask_each_time
   test_strategy: ${settings.testStrategy}
+  # Задаёт стратегию логирования по умолчанию для eda-plan.
   # debug_precise | standard | ask_each_time
   logging_strategy: ${settings.loggingStrategy}
 
 automate:
+  # Добавляет docs/plans/ в обычный запуск eda-automate.
   # true | false
   include_plans: ${settings.includePlans ? 'true' : 'false'}
 
 review:
+  # Добавляет в eda-review проверку качества кода и meta-reviewer quality-check.
   # true | false
   include_code_quality: ${settings.includeCodeQuality ? 'true' : 'false'}
 `;
@@ -282,7 +291,7 @@ async function installToClaude(cwd, skills, output = process.stdout) {
     const content = await fs.readFile(skill.path, 'utf-8');
     await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
   }
-  output.write(`  ✓ Claude Code: ${dst}\n`);
+  output.write(`  ✓ Claude Code: ${dst} (${formatSkillCount(skills.length)})\n`);
 }
 
 async function installToCodex(cwd, skills, output = process.stdout) {
@@ -295,7 +304,19 @@ async function installToCodex(cwd, skills, output = process.stdout) {
     await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
     await removeObsoleteCodexFile(dst, skill.name);
   }
-  output.write(`  ✓ Codex CLI: ${dst}\n`);
+  output.write(`  ✓ Codex CLI: ${dst} (${formatSkillCount(skills.length)})\n`);
+}
+
+function formatSkillCount(count) {
+  return `${count} ${pluralizeSkill(count)}`;
+}
+
+function pluralizeSkill(count) {
+  const mod10 = count % 10;
+  const mod100 = count % 100;
+  if (mod10 === 1 && mod100 !== 11) return 'скил';
+  if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return 'скила';
+  return 'скилов';
 }
 
 async function removeObsoleteCodexFile(dst, skillName) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "0.4.6",
-  "description": "Набор скилов eda-* для Claude Code и Codex CLI: explore, plan, execute, fix, review, fix-by-review, send-review, commit, docs, automate",
+  "version": "0.5.1",
+  "description": "Набор скилов eda-* для Claude Code и Codex CLI: roadmap, explore, plan, execute, fix, review, fix-by-review, send-review, commit, docs, automate",
   "type": "module",
   "bin": {
     "eda": "bin/cli.js"

package/skills/eda-roadmap.md

@@ -0,0 +1,142 @@
+---
+name: eda-roadmap
+description: 'Создаёт roadmap-файл по продуктовой или технической теме: собирает из сообщения пользователя цель, ограничения и список задач, формулирует задачи коротко, понятно и недвусмысленно, без деталей реализации, файлов, библиотек, API и пошагового плана. При необходимости читает docs/rules.md, docs/arch.md и существующие docs/roadmaps/. Задаёт вопросы только если без ответа нельзя составить корректный список задач. Итог сохраняет в docs/roadmaps/. Не исследует глубоко, не планирует реализацию и не меняет код.'
+---
+
+# Скил: Roadmap (eda-roadmap)
+
+Создаёшь roadmap: список будущих задач по продуктовой или технической теме. Roadmap отвечает на вопрос «что нужно сделать и зачем», но не отвечает «как именно реализовывать».
+
+## Режимы вызова
+
+| Режим | Запуск | Что делает |
+|---|---|---|
+| Обычный | `eda-roadmap <тема>` | Создаёт roadmap-файл в `docs/roadmaps/`. |
+| Из текста | `eda-roadmap <список идей или требований>` | Нормализует вход в ясный список задач без деталей реализации. |
+
+## Вход из сообщения пользователя
+
+Текст рядом с вызовом скилла в текущем сообщении пользователя — главный вход. Сначала разбери именно его: тему, цель, аудиторию, ограничения, примерный горизонт roadmap, уже названные задачи и прямые указания.
+
+Если входа достаточно, продолжай без вопроса. `AskUserQuestion` задавай только если входа нет, он противоречивый, найдено несколько равных вариантов или есть риск составить roadmap не для той цели. Старое обсуждение в истории не считай входом, если пользователь не связал его с текущим вызовом явно.
+
+## Главные правила
+
+1. **Никаких правок кода.** Запись только в `docs/roadmaps/`.
+2. **Roadmap — не план реализации.** Не указывай файлы, модули, библиотеки, API, миграции, команды, схемы данных, тесты и порядок технической реализации.
+3. **Задачи формулируй как пользовательскую или проектную ценность.** Хорошо: «Аутентификация через email, ВК и Яндекс». Плохо: «Добавить OAuth-клиент, роуты callback и таблицу provider_accounts».
+4. **Каждая задача короткая, но однозначная.** Читатель должен понять границы задачи без дополнительного созвона.
+5. **Можно чуть подробнее, если это снимает двусмысленность.** Допускается одно короткое описание: что должно появиться, для кого и какой результат ожидается.
+6. **Не выдумывай обязательства.** Если пользователь дал только направление, формулируй разумный черновик и явно помечай предположения.
+7. **Прочитай `docs/rules.md` и `docs/arch.md`**, если есть, чтобы не противоречить зафиксированным правилам и архитектурным ограничениям.
+8. **Существующие roadmap-файлы учитывай только при явной необходимости.** Если пользователь просит продолжить, обновить или не дублировать прошлый roadmap — прочитай релевантные файлы из `docs/roadmaps/`.
+
+## Интерактивные вопросы
+
+Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
+- Claude Code: используй `AskUserQuestion`.
+- Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
+- Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
+- Не запускай команды, которые ждут интерактивного ввода в терминале.
+
+## Этапы
+
+### 1. Понять назначение roadmap
+
+Определи:
+- тему roadmap;
+- для кого он нужен: продукт, команда разработки, владелец проекта, пользовательский сценарий;
+- горизонт, если он указан: ближайший релиз, квартал, MVP, несколько этапов;
+- уровень детализации: только список задач или задачи с короткими описаниями.
+
+Если тема или назначение неясны — задай `AskUserQuestion` и остановись до ответа.
+
+### 2. Собрать минимальный контекст
+
+Прочитай `docs/rules.md` и `docs/arch.md`, если они есть. Не делай глубокое исследование кода, если пользователь прямо не просит привязать roadmap к текущему состоянию проекта.
+
+Если пользователь просит продолжить или обновить существующий roadmap:
+- найди релевантный файл по указанному пути или теме;
+- если найдено несколько равных вариантов, спроси, какой использовать;
+- не перезаписывай старый файл, если пользователь явно не попросил обновить именно его.
+
+### 3. Сформировать задачи
+
+Собери задачи в список. Для каждой задачи:
+- дай короткое название;
+- добавь 1–2 предложения описания, если без них задача может быть понята по-разному;
+- опиши результат на уровне поведения или возможности, а не реализации;
+- не добавляй подзадачи с техническими шагами;
+- не добавляй оценки сроков, если пользователь не просил.
+
+Хорошие формулировки:
+- «Аутентификация через email, ВК и Яндекс. Пользователь может войти удобным способом и восстановить доступ без обращения в поддержку.»
+- «Личный кабинет пользователя. Пользователь видит свои данные, статус подписки и основные действия по аккаунту в одном месте.»
+- «Базовая модерация контента. Команда может скрывать спорные материалы и видеть причину модерационного решения.»
+
+Плохие формулировки:
+- «Подключить `passport-yandex`, добавить callback route и таблицу OAuth-профилей.»
+- «Создать `auth.service.ts`, миграцию и e2e-тесты.»
+- «Реализовать через Redis и очередь фоновых задач.»
+
+### 4. Сохранить файл
+
+Сохрани roadmap в `docs/roadmaps/{YYYY-MM-DD}_{HH-MM}_{slug}.md`.
+
+Формат файла:
+
+```markdown
+---
+title: <заголовок>
+date: <YYYY-MM-DD HH:MM>
+status: draft
+sources:
+  rules: <путь или —>
+  arch: <путь или —>
+  previous_roadmap: <путь или —>
+---
+
+# <Заголовок>
+
+## Контекст
+
+Коротко: зачем нужен roadmap, для кого он и какой горизонт покрывает.
+
+## Предположения
+
+- <предположение, если было>
+
+Если предположений нет: «Не требовались.»
+
+## Задачи
+
+| # | Задача | Описание |
+|---|---|---|
+| 1 | <короткая задача> | <понятное описание без деталей реализации> |
+
+## Не входит
+
+- <что явно не включаем, если это важно>
+
+Если явных исключений нет: «Не зафиксировано.»
+```
+
+Quality gate перед сохранением:
+- файл лежит в `docs/roadmaps/`;
+- есть ровно один основной список задач в разделе `Задачи`;
+- каждая задача имеет короткое название и понятное описание;
+- задачи не содержат деталей реализации: файлов, библиотек, API, команд, миграций, схем таблиц, тестовых стратегий;
+- roadmap можно использовать как вход для `eda-explore` или `eda-plan`, но сам он не является исследованием или планом реализации.
+
+### 5. Финал
+
+Короткое сообщение: путь к roadmap-файлу, количество задач, 3–5 самых важных задач простыми словами. Если были предположения — явно скажи, что они записаны в файл.
+
+## Чего НЕ делать
+
+- Править код, конфиги, зависимости или тесты.
+- Писать план реализации по фазам.
+- Делать техническое исследование вместо roadmap.
+- Указывать конкретные библиотеки, файлы, API, миграции, команды или тестовые сценарии.
+- Раздувать задачу до спецификации или ТЗ.
+- Сохранять файл куда-либо кроме `docs/roadmaps/`.