| source | pablontiv/roadmapctl |
| name | roadmap |
| description | Usar cuando el usuario sabe QUÉ construir y necesita planificar CÓMO —
descomponiendo trabajo en Outcomes opcionales y Tasks ejecutables por agentes,
con criterios de aceptación, dependencias y validación. También para ver
progreso, trabajo pendiente o ejecutar tasks en secuencia. Usar si el usuario
describe capacidades a construir, pregunta "cómo estructuro esto", lista
requerimientos, quiere ver pendientes/progreso, o dice "next task",
"planificar" o "descomponer".
|
| argument-hint | <texto libre> | [pending|loop|plan] [args] |
| effort | xhigh |
| execution-model | sonnet |
| worktree-per-outcome | false |
| parallel-independent-tasks | false |
| hooks | {"Stop":[{"type":"agent","prompt":"Verify that the critic agent was invoked during this skill execution and its evaluation passed. If no critic evaluation occurred and the skill produced artifacts, return {ok: false, reason: 'Critic evaluation was skipped'}. If work is still in progress, return {ok: true}.","timeout":60}]} |
/roadmap — Planificación AI-Native Simple
Outcome/Objetivo (opcional)
└── Task (unidad ejecutable)
Para trabajo chico, usar solo tasks.
Invariante de materialización
Materializar tareas significa crear archivos canónicos, no un único archivo resumen:
<roadmap-root>/OXX-slug/README.md
<roadmap-root>/OXX-slug/TXXX-task.md
<roadmap-root>/TXXX-task.md (Task directa)
Si no se puede crear esa estructura, detenerse. No fallback a markdown libre.
Invariante de escritura segura
El skill es el coordinador de la materialización — responsable de la corrección del proceso, no el único escritor. Después de aprobación explícita y preflight pasado, puede escribir directamente o despachar Agents coordinados para escritura paralela.
Prohibido: heredocs/cat> en shell para múltiples archivos; loops con rootline new; escribir sin aprobación; escribir si roadmapctl doctor o check --strict retornan non-zero.
Permitido: Write tool por archivo canónico tras aprobación y preflight exitoso. Permitido: despachar Agents coordinados para escritura paralela tras aprobación y preflight exitoso.
Bootstrap
Ejecutar roadmapctl bootstrap --repo <repo> --output json. Su JSON es fuente de verdad para config, helpers y comportamiento. Gate inicial: command -v roadmapctl. Detalle: bootstrap-reference.md | config-reference.md.
Frontera de responsabilidad
roadmapctl gobierna guards, validación, estado, cola, readiness y decisiones.- Rootline es la base Markdown genérica; usarlo directamente solo donde no exista comando vivo de
roadmapctl.
- El skill conversa, descompone, pide aprobación, escribe Markdown canónico aprobado y orquesta ejecución.
- Reglas específicas del repo (lint, coverage, toolchain, hooks locales) viven en docs locales del repo, no en este skill compartido.
Gates CLI
Antes de escribir/mutar/ejecutar/declarar validez:
roadmapctl doctor --repo <repo> --output json --strict
roadmapctl check --repo <repo> --output json --strict
Si sale non-zero, detenerse. No auto-fix, no fallback. Verificación del skill: verification-reference.md.
Routing por subcomando
Flag global --repo
Solo workspace mode: --repo <name> resuelve un repo. Single-repo: se ignora.
Regla de dispatch
- Vacío →
pending.
pending, loop, plan, bootstrap → subcomando directo.decision/next/priorización → decision-tree.- Estado/progreso/pendientes →
pending.
- "crea las tareas"/"materializa"/"genera archivos" →
plan.
bootstrap → bootstrap subcommand.- Texto libre sin pedir archivos → modo autónomo.
Ambigüedad: "descompón/planifica" = propuesta (no escribe); "crea/materializa" = plan. Si no hay plan suficiente, preguntar antes de escribir.
Referencia
