Referencia Claude Code

52 comandos para planificar, ejecutar y cerrar trabajo con Claude

Inventario completo de comandos expuestos por el plugin. Cada entrada resume argumentos, comportamiento esperado, casos de uso y el archivo fuente donde vive la implementación.

Ver tutoriales Ver skills en GitHub

Inicialización y captura

Comandos para preparar el sistema de planning y capturar ideas antes de expandirlas.

/plan-init

Inicializa el sistema de planning en el proyecto actual.

plan-init/SKILL.md

/plan-init [--blank] [--force]

Copia workflows, templates, tutoriales y glosario desde planning-template/.
Crea la estructura .planning/, detecta áreas del repositorio y configura la rama base git.
Debe ejecutarse una vez antes de usar el resto de comandos plan-*.

/plan-git-config

Ve o actualiza la configuración git del sistema de planning.

plan-git-config/SKILL.md

/plan-git-config [--base-branch <branch>]

Útil en proyectos que ya tienen .planning/ inicializado antes de la configuración git.
Sin argumentos, muestra la config actual y ofrece editarla.
Con --base-branch <branch>, establece la rama base para nuevas ramas de story.

/plan-smoke-config

Configura o genera un smoke test plan específico del stack para proyectos software.

plan-smoke-config/SKILL.md

/plan-smoke-config [--blank]

Escribe el plan de smoke tests en .planning/SMOKE-TESTS.md por defecto.
Puede hacer preguntas guiadas, prellenar desde inferencia del repositorio o crear un esqueleto vacío.
Documenta el arranque, dependencias, migraciones y smoke checks necesarios antes del code review humano.

/plan-template

Genera un documento de idea listo para alimentar /plan-new.

plan-template/SKILL.md

/plan-template [slug] [--interactive | --blank]

Guarda la idea en .planning/ideas/.
Permite capturar intent, contexto, restricciones, criterios de éxito y preguntas abiertas.
Sirve para trabajos que todavía necesitan aclaración antes de convertirse en planning.

/plan-new

Crea una nueva entrada de planning en estado INITIAL.

plan-new/SKILL.md

/plan-new <NNN-slug> -- <intent> | /plan-new <NNN-slug> @<path/to/idea.md>

Acepta una captura inline rápida o un documento de idea enriquecido.
Crea los archivos base del planning sin expandir todavía las stories.
Requiere que .planning/ exista previamente.

Backlog de producto

Herramientas para crear, enriquecer y dividir historias o épicas antes de ejecutar.

/us-new

Agrega una nueva user story a un container existente.

us-new/SKILL.md

/us-new <path/to/container> [--interactive | --blank]

El container puede ser un directorio de stories o un único documento markdown.
Respeta el formato y convenciones que encuentra en el proyecto.
Actualiza índices cuando corresponde.

/us-enrich

Enriquece una story con secciones ejecutables faltantes.

us-enrich/SKILL.md

/us-enrich <path/to/story.md> | <story-id> | <partial-filename>

Agrega Definition of Done, Technical Notes, Dependencies y Complexity cuando faltan.
Puede resolver la story por path, ID o coincidencia parcial.
Lee contexto del epic si existe para mantener coherencia.

/us-split

Divide una user story en dos historias con referencias cruzadas.

us-split/SKILL.md

/us-split <path/to/story.md>

Mantiene el flujo principal en la story original.
Extrae comportamiento secundario o independiente a una nueva story.
Deja trazabilidad entre ambas piezas.

/us-status

Muestra el estado de enriquecimiento de las stories de un container.

us-status/SKILL.md

/us-status <path/to/container/>

Detecta si cada story tiene DoD, notas técnicas y dependencias.
Indica si ya está vinculada a una story activa del planning.
Sirve para preparar backlog antes de planificar.

/epic-enrich

Agrega nuevas stories a un container existente detectando gaps.

epic-enrich/SKILL.md

/epic-enrich <path/to/epic-dir/> | <path/to/stories.md>

Lee el contenido actual y el contexto de epic.
Identifica cobertura faltante, edge cases y dependencias no representadas.
Guía la adición de nuevas stories sin imponer una estructura fija.

/plan-from-epic

Genera un planning activo completo desde un container de stories.

plan-from-epic/SKILL.md

/plan-from-epic <NNN> <path/to/container> [--filter field=value]

Convierte cada story en una story ejecutable.
Hereda criterios de aceptación y Definition of Done como done criteria de la story.
Actúa como puente entre backlog de producto y ejecución técnica.

Expansión y preparación

Comandos para convertir una idea inicial en stories y tareas listas para ejecutar.

/plan-expand

Avanza un planning desde INITIAL a EXPANSION.

plan-expand/SKILL.md

/plan-expand <NNN-slug>

Completa 01-expansion.md con stories, dependencias y criterios de éxito.
Crea archivos de story en 02-deepening/.
Mueve el planning a active/ y actualiza índices.

/plan-atomize

Descompone una story en tareas atómicas.

plan-atomize/SKILL.md

/plan-atomize <NNN-slug> [story-NN]

Crea un archivo por tarea con diseño técnico, pasos de implementación, tests y done criteria.
Puede aplicarse a una story específica o a todo el planning.
Se usa después de expandir y antes de ejecutar cuando se necesita más granularidad.

/plan-task-validate

Audita tareas atómicas contra el checklist de atomicidad.

plan-task-validate/SKILL.md

/plan-task-validate <NNN-slug> [story-NN] [task-NN]

Es de solo lectura.
Valida una tarea, una story o todas las stories atomizadas.
Compara tareas con el índice de la story y criterios de atomicidad.

/plan-test-suite

Genera matrices determinísticas de set de pruebas.

plan-test-suite/SKILL.md

/plan-test-suite <NNN-slug> [story-NN] [task-NN] [--all]

Escribe artefactos TEST-SUITE a nivel de planning, story o task.
Detecta tooling del repositorio antes de usar guía generada por AI.
Cubre unitarias, coverage, integración, aceptación, análisis estático, estilo, arquitectura, smoke, seguridad y mutación.

Ejecución y cierre

Comandos centrales para ejecutar stories, cerrar tareas y archivar trabajo terminado.

/plan-task

Ejecuta una tarea atómica individual.

plan-task/SKILL.md

/plan-task <NNN-slug> <story-NN> <task-NN>

Sigue el diseño técnico de la tarea y aplica implementación y tests.
Crea una rama de task desde la rama de story, la pushea y abre PR de vuelta a la rama de story.
Después de mergear el PR de task, elimina la rama local de task con git branch -d.
Marca la tarea como DONE solo después de verificación y revisión humana.

/plan-story

Ejecuta todas las tareas dentro de una story.

plan-story/SKILL.md

/plan-story <NNN-slug> <story-NN>

Crea y pushea una rama de story desde la rama base configurada.
Ejecuta tareas mediante ramas de task, espera que sus PRs estén mergeados y limpia ramas locales de task antes de cerrar la story.
Al finalizar: rebase, push y apertura de PR de story hacia la rama base; tras el merge final se limpia la rama local de story.
Es el comando principal de ejecución por stories.

/plan-done

Marca una tarea o toda una story como terminada.

plan-done/SKILL.md

/plan-done <NNN-slug> <story-NN> [task-N]

Verifica criterios de completitud antes de avanzar.
Al cerrar una story completa: verifica PRs de task mergeados, limpia ramas locales de task y abre el PR de story hacia la rama base.
Avanza el planning cuando todas las stories están completas.

/plan-validate

Valida la integridad estructural de uno o todos los plannings.

plan-validate/SKILL.md

/plan-validate [NNN-slug]

Revisa ubicación de archivos, consistencia de stories, workflows, dependencias y done criteria.
Incluye validaciones sobre archivos de tareas atomizadas.
Es una auditoría previa útil antes de cerrar o archivar.

/plan-retrospective

Genera la retrospectiva final del planning.

plan-retrospective/SKILL.md

/plan-retrospective <NNN-slug>

Lee RETROSPECTIVE-RAW.md, contexto del planning, stories y notas de trazabilidad.
Reemplaza o crea README.md# Retrospective con un resumen profesional.
Útil justo antes de plan-archive.

/plan-archive

Audita un planning completado y lo mueve a finished/.

plan-archive/SKILL.md

/plan-archive <NNN-slug>

Ejecuta AUDIT-PLANNING antes de mover archivos.
Preserva la trazabilidad del trabajo terminado.
Cierra el ciclo de vida del planning.

Ajustes durante ejecución

Operaciones para adaptar un planning activo cuando cambia el alcance o aparece ambigüedad.

/plan-enrich-epic

Agrega nuevas stories a un planning activo.

plan-enrich-epic/SKILL.md

/plan-enrich-epic <NNN-slug>

Se usa cuando aparece cobertura faltante después de la expansión inicial.
Funciona sobre plannings en EXPANSION o DEEPENING.
Mantiene la coherencia de índices y archivos de story.

/plan-enrich-story

Profundiza una story underspecified, ambigua o incompleta.

plan-enrich-story/SKILL.md

/plan-enrich-story <NNN-slug> <story-NN>

No cambia el estado de la story.
Agrega detalle suficiente para poder ejecutar con menor incertidumbre.
Sirve cuando la story existe pero no tiene criterios o contexto suficiente.

/plan-split-story

Divide una story demasiado grande en stories más pequeñas.

plan-split-story/SKILL.md

/plan-split-story <NNN-slug> <story-NN>

Reemplaza la story original por dos o más stories enfocadas.
Actualiza 01-expansion.md y los archivos bajo 02-deepening/.
Es útil cuando una story mezcla responsabilidades o excede un tamaño ejecutable.

/plan-merge

Mueve una story desde un planning activo a otro.

plan-merge/SKILL.md

/plan-merge <NNN-source> <story-NN> <NNN-target>

Actualiza ambos archivos 01-expansion.md.
Relocaliza el archivo de story.
Preserva carpetas de tareas atomizadas cuando existen.

/plan-story-skip

Marca una story como SKIPPED sin ejecutarla.

plan-story-skip/SKILL.md

/plan-story-skip <NNN-slug> <story-NN> [-- reason]

Sirve cuando la story ya no aplica por cambios de requerimiento.
Permite cerrar un planning sin forzar trabajo obsoleto.
Registra una razón cuando se entrega.

/plan-edge-case

Registra un evento inesperado para la retrospectiva final.

plan-edge-case/SKILL.md

/plan-edge-case [NNN-slug] [story-NN] -- <nota>

Agrega una entrada raw a RETROSPECTIVE-RAW.md.
Puede inferir el planning cuando existe exactamente un planning activo.
Úsalo para correcciones manuales, bloqueos, decisiones inusuales o sorpresas fuera de comandos del plugin.

/plan-decision

Crea o actualiza un Project Decision Record.

plan-decision/SKILL.md

/plan-decision <NNN-slug> -- <título decisión> | <NNN-slug> pdr-NNN-título

Escribe PDRs solo para decisiones aceptadas o propuestas que afectan varias stories, áreas, terminología o workflows futuros.
Usa PDR-TEMPLATE.md y preserva nombres de PDR existentes cuando actualiza.
Mantiene decisiones rutinarias de tarea en las notas de diseño en vez de crear registros placeholder.

/plan-rollback

Revierte una story de DONE a TODO.

plan-rollback/SKILL.md

/plan-rollback <NNN-slug> <story-NN>

Se usa cuando una ejecución dejó el código en mal estado y debe repetirse.
Puede remover carpeta de tareas atomizadas asociada.
Prepara la story para re-ejecución controlada.

/plan-retry

Reintenta todas las stories BLOCKED de un planning.

plan-retry/SKILL.md

/plan-retry <NNN-slug>

Resetea stories bloqueadas a TODO.
Re-ejecuta plan-story para retomarlos.
Debe usarse después de resolver el bloqueo externo o técnico.

Estado, reportes y reutilización

Consultas, reportes ejecutivos, historiales, exportación y diagnósticos globales.

/plan-status

Muestra el estado actual de todos los plannings.

plan-status/SKILL.md

/plan-status

Lista plannings activos y sus stories.
Ayuda a decidir el siguiente comando a ejecutar.
Opera sobre el sistema .planning/.

/plan-health

Escanea todo .planning/ buscando anomalías estructurales.

plan-health/SKILL.md

/plan-health

Detecta IDs duplicados, archivos huérfanos, plannings stale e índices inconsistentes.
Es más amplio que plan-validate porque revisa el sistema completo.
Produce un reporte global de salud.

/plan-history

Muestra la línea de tiempo de cambios de estado de un planning.

plan-history/SKILL.md

/plan-history <NNN-slug>

Extrae transiciones desde git history.
Ayuda a reconstruir avance, bloqueos y cierres.
Produce una vista temporal por planning.

/plan-report

Genera un resumen ejecutivo del planning.

plan-report/SKILL.md

/plan-report <NNN-slug> [--metrics]

Incluye objetivo, avance de stories, riesgos, métricas, decisiones técnicas, duración y siguientes pasos.
Sirve para comunicar estado fuera del equipo técnico.
Con --metrics, incluye tasa de completitud, bloqueos, promedio de tareas, distribución de riesgos y cobertura de issues.

/plan-standup

Genera texto de standup para un planning.

plan-standup/SKILL.md

/plan-standup <NNN-slug>

Resume que se completó desde ayer.
Indica que está en progreso hoy.
Expone bloqueantes actuales.

/plan-export

Exporta un planning como documento formateado.

plan-export/SKILL.md

Puede generar descripción de PR, lista de tickets, borrador de issue externo o markdown standalone.
Soporta formatos de borrador para GitHub issue, Jira y Linear.
Es de solo lectura sobre el planning.

/plan-clone

Clona un planning con un nuevo ID.

plan-clone/SKILL.md

/plan-clone <NNN-source-slug> <NNN-target-slug>

Copia la estructura de stories.
Resetea todos los estados a TODO.
Sirve para repetir un patrón probado en otro contexto.

/plan-doctor

Audita un checkout del plugin o una plantilla instalada.

plan-doctor/SKILL.md

/plan-doctor [--plugin-root <path>]

Revisa archivos requeridos, metadata de skills, inventario de comandos, grupos de workflows y markers de templates.
Puede ejecutar scripts/verify-plugin.sh cuando existe.
Pensado para mantenedores del plugin y chequeos de compatibilidad.

/plan-update-version

Aplica una migración versionada a un workspace .planning antiguo.

plan-update-version/SKILL.md

/plan-update-version <from> <to> [--dry-run] [--allow-dirty]

Busca update-version/<from>-<to>.md en el workspace y luego en el template del plugin.
Permite dry-run para descubrir cambios antes de escribir o renombrar archivos de planning.
Parte con la migración 1.4.0 -> 2.0.0 desde terminología legacy scope hacia story.

Documentación generada

Comandos para producir documentación desde artefactos de planning completados.

/doc-generate

Genera documentación desde artefactos de planning.

doc-generate/SKILL.md

/doc-generate <NNN-slug> [<story-NN> [<task-NN>]]

Puede trabajar a nivel tarea, story o planning.
Produce inline docs, ADRs, changelogs o guías de usuario según área y nivel.
Detecta el área afectada antes de decidir el tipo de documentación.

/doc-task

Genera documentación para una tarea atómica completada.

doc-task/SKILL.md

/doc-task <NNN-slug> <story-NN> <task-NN>

Wrapper delgado sobre doc-generate.
Se invoca automáticamente desde plan-task cuando corresponde.
Produce documentación inline o ADR según el área de la story.

/doc-story

Genera documentación para una story completada.

doc-story/SKILL.md

/doc-story <NNN-slug> <story-NN>

Wrapper delgado sobre doc-generate.
Puede generar changelog, guía de usuario o ADR consolidado.
Se integra al cierre de story.

/plan-audit-docs

Audita documentación generada o modificada por un planning.

plan-audit-docs/SKILL.md

/plan-audit-docs <NNN-slug> [--docs-dir <path>]

Revisa docs esperados, links locales, trazabilidad, frescura y referencias a issues externos.
Lee outputs esperados desde stories, tareas y done criteria.
Es de solo lectura y sirve antes de handoff o archivo.

Planificación de releases

Comandos para gestionar releases: agrupa plannings bajo versiones semánticas y controla su ciclo de vida.

/release-init

Inicializa .releases/ para gestión de releases. Se ejecuta una vez, independiente de /plan-init.

release-init/SKILL.md

/release-init

Crea el directorio .releases/ y su README índice.
Opt-in: no todos los proyectos necesitan gestión de releases.
Prerequisito para usar el resto de comandos release-*.

/release-new

Crea una nueva release en estado DRAFT con versión semántica.

release-new/SKILL.md

/release-new <vX.Y.Z> -- <purpose>

Genera un archivo de release con versión, período objetivo y descripción.
Estado inicial: DRAFT — sin plannings asignados todavía.
Requiere /release-init previo.

/release-add

Agrega uno o más plannings a una release existente.

release-add/SKILL.md

/release-add <vX.Y.Z> <NNN-slug> [<NNN-slug> ...]

Lee resúmenes y estados actuales desde .planning/ automáticamente.
Actualiza la tabla de plannings incluidos en el archivo de release.
Admite múltiples plannings en un solo comando.

/release-remove

Elimina un planning de una release.

release-remove/SKILL.md

/release-remove <vX.Y.Z> <NNN-slug>

Requiere confirmación explícita si la release ya fue publicada.
Reajusta numeración de filas y actualiza el README índice.
No elimina el planning del sistema, solo lo desvincula de la release.

/release-status

Muestra el estado en vivo de todas las releases o de una en detalle.

release-status/SKILL.md

/release-status [<vX.Y.Z>] [--mark-planned | --mark-in-progress | --mark-blocked | --mark-released | --mark-cancelled]

Lee el estado actual de los plannings desde .planning/ — no de valores cacheados.
Sin argumentos: tabla resumen de todas las releases.
Con flag --mark-*: transiciona la release a PLANNED, IN PROGRESS, BLOCKED, RELEASED o CANCELLED.

Pipeline autónomo

Comandos de mayor nivel para delegar el flujo completo a agentes especializados.

/plan-run

Ejecuta un planning de punta a punta desde su estado actual.

plan-run/SKILL.md

/plan-run [NNN-slug | "description"]

Detecta automáticamente en qué fase está el planning.
Muestra un plan de ejecución y pide una única confirmación.
Luego delega a agentes de fase para planificar, ejecutar y validar.

/plan-agent-plan

Agente de planificación autónoma.

plan-agent-plan/SKILL.md

/plan-agent-plan <NNN-slug | "description">

Crea un planning si hace falta.
Avanza desde INITIAL a EXPANSION sin confirmaciones intermedias.
Prepara la base que luego ejecutan otros agentes.

/plan-agent-execute

Agente de ejecución de stories pendientes.

plan-agent-execute/SKILL.md

/plan-agent-execute <NNN-slug>

Atomiza y ejecuta stories independientes en paralelo usando subagentes.
Respeta orden de dependencias.
Se enfoca en avanzar el trabajo pendiente de un planning.

/plan-agent-validate

Agente de validación y cierre.

plan-agent-validate/SKILL.md

/plan-agent-validate <NNN-slug>

Ejecuta plan-validate.
Marca done y archiva si todas las stories pasan.
Se detiene sin archivar si encuentra problemas.