| name | new-spec |
| description | Genera una nueva especificación de cambio ligera copiando el directorio de plantilla de especificación en una carpeta de especificación con nombre. Úsalo cuando la persona quiera iniciar una especificación, planificar un cambio/funcionalidad o crear un documento de diseño antes de implementar (p. ej. "especifica el rediseño del checkout", "crea una especificación para el nuevo flujo de autenticación"). |
| argument-hint | [nombre del cambio] |
Crea una nueva especificación de cambio cuyo nombre está en $ARGUMENTS.
- Lee
specs/README.md para conocer el flujo de trabajo de las especificaciones, la convención de nombres de carpeta y qué espera cada sección de la plantilla. Sigue ese documento si difiere de los pasos siguientes.
- Convierte
$ARGUMENTS en <change-name> con formato slug (minúsculas, separado por guiones).
- Calcula
NNNN: el mayor prefijo numérico de 4 dígitos existente en specs/ y
specs/archive/ (si existe), más uno; si no hay ninguna, 0001.
- Copia todo el directorio
specs/_template/ a specs/NNNN-<change-name>/ (conserva cada archivo de la plantilla).
- En los archivos copiados, completa los metadatos obvios:
- El título del cambio (la forma legible de
$ARGUMENTS)
- Estado:
Draft
- Fecha: la fecha de hoy (
YYYY-MM-DD)
- Deja problem, goals, non-goals y approach como indicaciones para la persona autora.
- Si
specs/README.md mantiene un índice de especificaciones, añade una entrada para la nueva especificación.
- Informa la ruta del directorio creado y enumera los archivos que la persona autora aún debe completar.
Ejemplo: /new-spec rediseño del checkout → specs/0007-checkout-redesign/ (si la
última especificación era la 0006).
NO empieces a implementar el cambio, y NO elimines ni sobrescribas una carpeta de especificación existente — si specs/<change-name>/ ya existe, detente y pregunta.