К основному содержанию
плагин CX Codex

roadmapsmith — плагин для Claude Code: что делает и как установить

Плагин roadmapsmith держит ROADMAP.md в согласии с кодом: одна команда создаёт файл, вторая предлагает правки с подтверждением и ждёт вашего ok.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install roadmapsmith@awesome-codex-plugins
Открыть на GitHub

Что делает roadmapsmith

Плагин добавляет агенту две слэш-команды. /roadmap-init спрашивает имя проекта, проблему и пользователя, сканирует репозиторий и собирает ROADMAP.md с задачами по фазам P0/P1/P2 и по областям кода. Существующий файл команда не перезаписывает.

/roadmap-update ищет в коде подтверждение для каждой задачи и показывает diff прямо в чате: что можно отметить, где стоит [x] без evidence, какие задачи уже есть в коде, но не попали в файл. Запись начинается только после вашего ok. Режимов два: full-scan проходит репозиторий целиком, short-circuit опирается на контекст текущей сессии.

Работает на Claude и Codex, в корне репозитория лежит манифест .codex-plugin/plugin.json с теми же скиллами. Если раньше вы ставили глобальный CLI через npm i -g roadmapsmith, он останется на месте и не будет обновляться вместе со скиллами: это отдельный путь установки.

Какие задачи решает

  • создать ROADMAP.md с задачами по фазам и областям кода
  • отмечать готовое только там, где в коде есть подтверждение
  • найти задачи, отмеченные без опоры в коде
  • посмотреть diff правок до перезаписи файла
  • добавить в план то, что уже написано в коде

Примеры запросов агенту

  • Запусти /roadmap-init и собери ROADMAP.md по фазам P0/P1/P2.
  • Прогони /roadmap-update в режиме full-scan и покажи diff до записи.
  • Обнови ROADMAP.md через /roadmap-update, но не переключай [ ] на [x] без evidence.

Как установить roadmapsmith

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install roadmapsmith@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о roadmapsmith

Как установить roadmapsmith в Claude Code?

Через маркетплейс плагинов: сначала /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install roadmapsmith@awesome-codex-plugins.

Что делает roadmapsmith?

Приводит ROADMAP.md в соответствие с кодом. /roadmap-init собирает файл один раз при старте репозитория, /roadmap-update предлагает правки и ждёт ok перед записью.

Что будет, если задача отмечена, но подтверждения в коде нет?

В предложенном diff она попадёт в предупреждения как отмеченная без evidence. Файл не изменится, пока вы не подтвердите правку.

Исходный текст

roadmapsmith · MIT
# roadmapsmith

[![skills.sh](https://skills.sh/b/PapiScholz/roadmapsmith)](https://skills.sh/PapiScholz/roadmapsmith)

Un skill para agentes de IA (Claude Code, Codex, y cualquier host que lea `SKILL.md`) que mantiene tu `ROADMAP.md` coherente con lo que hay en el código. Dos slashcommands: uno para crearlo, otro para actualizarlo — el agente escanea el repo, pide evidence real antes de marcar `[x]`, y te pasa un diff antes de escribir.

## El problema

- Los `ROADMAP.md` se pudren: alguien marca `[x]` una task que no está terminada, o deja `[ ]` algo que ya se shippeó, y a los dos meses el archivo miente.
- Chequear a mano cada task contra el código no escala: el agente puede leer todo el repo en segundos y proponerte el diff.
- Marcar completado sin evidence verificable es autoengaño — este skill nunca flipea `[ ] → [x]` sin encontrar el archivo/símbolo que respalda la task.

## Cómo funciona (dos slashcommands)

```
/roadmap-init      # una vez, al arrancar un repo
/roadmap-update    # cuando querés reflejar tu progreso
```

- **`/roadmap-init`** — Te hace 3 preguntas mínimas (nombre, problema, usuario), escanea el repo, y genera `ROADMAP.md` con tasks agrupadas por fase (P0/P1/P2) y área del código. Nunca sobreescribe un `ROADMAP.md` existente.
- **`/roadmap-update`** — Releva el código en busca de evidence, te propone un diff (tareas a marcar, warnings de checked-sin-evidence, tareas nuevas detectadas), y espera tu `ok` antes de escribir. Modo `full-scan` (determinístico) o `short-circuit` (usa el contexto de la sesión si alcanza).

Full spec de cada uno:
[`skills/roadmap-init/SKILL.md`](skills/roadmap-init/SKILL.md) · [`skills/roadmap-update/SKILL.md`](skills/roadmap-update/SKILL.md)

## Cómo se ve

Antes:

```markdown
## Phase 0 — Baseline
### auth
- [ ] [P0] Add login endpoint
- [ ] [P0] Hash passwords with bcrypt
- [ ] [P0] Session cookies
```

Después de `/roadmap-update` (ya implementaste dos):

```markdown
## Phase 0 — Baseline
### auth
- [x] [P0] Add login endpoint <!-- evidence: src/auth/login.ts:14 -->
- [x] [P0] Hash passwords with bcrypt <!-- evidence: src/auth/hash.ts:8 -->
- [ ] [P0] Session cookies
```

El diff se te muestra en el chat antes de escribir. Si el agente marcó algo sin evidence real, aparece como `⚠️ checked pero sin evidence` en la propuesta.

## Install

Un comando:

```bash
npx skills add PapiScholz/roadmapsmith
```

Detecta el agente (Claude Code, Codex, 70+ más) e instala los dos skills en el lugar correcto. Nada más.

<details>
<summary>Otras vías de instalación</summary>

```bash
# Ver qué skills declara el repo antes de instalar
npx skills add PapiScholz/roadmapsmith --list

# Buscar por keyword (una vez que skills.sh indexa el repo, ~1h después del primer add)
npx skills find roadmap
```

- **Web:** [`https://skills.sh/PapiScholz/roadmapsmith`](https://skills.sh/PapiScholz/roadmapsmith)
- **Shim legacy** (equivalente, delega al `skills add` de arriba): `npx github:PapiScholz/roadmapsmith`
- **Codex plugin nativo:** el manifest `.codex-plugin/plugin.json` en la raíz declara los mismos skills — instalación vía Codex plugin marketplace funciona sin pasos extra.

</details>

## Update

```bash
npx skills update
```

Actualiza todos los skills instalados. Para actualizar solo uno: `npx skills update roadmap-init` o `npx skills update roadmap-update` (nombres de los skills, no del repo).

> **Warning esperado** — vas a ver `the following skills appear to have been deleted upstream` listando ~19 nombres viejos (`roadmap-sync`, `audit`, `zero`, `road`, etc.) y una cascada de `No matching skills found`. Es ruido cosmético del catálogo público de skills.sh, que todavía cachea entries de pre-v1.3.0. Ya está reportado upstream — respondé `Yes` para limpiar, los `No matching skills found` que siguen son no-ops porque nunca los tuviste instalados.

### ¿Ya tenías el CLI viejo instalado global?

Pre-v1.0.0 el paquete era un CLI y se instalaba con `npm i -g roadmapsmith`. Si `roadmapsmith --version` te devuelve `0.14.x`, tenés ese binario colgado — la instalación de skills es una ruta paralela y no lo pisa. Podés dejarlo (no molesta) o limpiarlo:

```bash
npm uninstall -g roadmapsmith
```

Post-v1.0.0 la única "instalación" que necesitás es la de skills; ya no hay CLI global que actualizar.

## Estado

Herramienta personal, sin roadmap comercial. Feedback y bug reports bienvenidos vía [issues](https://github.com/PapiScholz/roadmapsmith/issues). MIT.

Mantenimiento y flujo de release: [`docs/RELEASING.md`](docs/RELEASING.md).

<details>
<summary>Legacy — CLI v0.15 (deprecated)</summary>

La versión previa (v0.10 a v0.15) era un CLI en Node con validator, audit engine, drift detection y 312 tests. Todo eso vive en [`legacy/`](legacy/) sin desarrollo activo — ver [`legacy/README.md`](legacy/README.md).

El pivote a v1.0.0 tiró la ceremonia (validator, tests, marketing) y dejó solo lo que el user original quería: un skill, dos slashcommands, `ROADMAP.md` al día.

</details>

© PapiScholz · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
planning davila7 Скилл planning ведёт markdown-файлы с целями, находками и логом сессии, чтобы агент не потерял задачу на длинной цепочке шагов. CX Codex +1 712установок new-work Garrick Aden-Buie (@gadenbuie) Скилл new-work для Claude Code ведёт markdown-файл с чек-листом, решениями и ссылками на issue и PR. Хранит контекст задачи между сессиями. CX Codex +1 405установок plan CloudAI-X Создаёт и ведёт файл PLAN.md в корне проекта для фиксации этапов разработки, зависимостей между задачами и лога прогресса. CX Codex +1 ★ 1 424звёзд репо todo-tracker jdrhyne Скилл todo-tracker ведёт список задач в локальном Markdown-файле и сохраняет стабильные ID между сессиями. Попросите добавить, найти, завершить или удалить задачу. CX Codex +1 ★ 239звёзд репо transform-roadmap Paweł Huryn Команда transform-roadmap превращает список функций в дорожную карту с результатами, метриками и стратегическим контекстом. Подходит для работы с продуктовыми планами. CX Codex +1 ★ 28 211звёзд репо presentation iii-hq Скилл presentation для Claude Code превращает каталог технической спецификации в интерактивную веб-презентацию, чтобы показать спецификацию как связный публичный дек. CX Codex +1 4 400установок

Из того же набора391

Весь набор →
since-cutoff Плагин since-cutoff сравнивает публичные API зависимостей в Python-проекте с датой обучения модели и создаёт краткие памятки в AGENTS.md, чтобы ассистент не использовал устаревший синтаксис. CX Codex ★ 1 596звёзд репо simple-man Плагин simple-man для Claude Code и Codex убирает из ответов агента похвалу, пересказы и лишние фразы, сохраняя факты для действий. Сокращает рабочие ответы. CX Codex ★ 1 596звёзд репо sealos Разворачивает приложения в Sealos Cloud прямо из агента, настраивает базы данных, хранилище и публичный HTTPS с проверкой готовности. CX Codex ★ 1 596звёзд репо runtype-skills Набор скиллов для разработки AI-продуктов на Runtype: от настройки проекта до инструментов агента, Persona-виджетов и рабочих процессов. CX Codex ★ 1 596звёзд репо river-review Плагин river-review запускает аудит кода по версионируемым правилам команды прямо в Claude Code и Codex с проверкой находок по diff и тестам. CX Codex ★ 1 596звёзд репо reviewable-html-workbench Плагин reviewable-html-workbench превращает HTML-документы агента в документы для браузерной проверки с inline-комментариями и повторными правками. Подходит для отчётов, дизайн-документов и таблиц сравнения. CX Codex ★ 1 596звёзд репо research-agent-skills Плагин research-agent-skills добавляет 281 скилл для научных исследований в Claude Code и Codex. Охватывает весь цикл: от поиска литературы и выдвижения гипотез до проверки цитат и ответов рецензентам. CX Codex ★ 1 596звёзд репо repopilot Плагин repopilot фиксирует срез репозитория на старте сессии и блокирует завершение работы агента, если тот ослабил тесты или убрал проверки безопасности. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой