Entrada del usuario
$ARGUMENTS
DEBES considerar la entrada del usuario antes de proceder (si no está vacía).
Guardia de alcance
El trabajo propio de este comando se limita a actualizar la constitución del proyecto. Las plantillas y comandos dependientes leen la constitución en tiempo de ejecución y no se modifican aquí.
- Clasifica cada parte de la entrada del usuario como contenido de la constitución o como una intención separada que no sea de gobernanza.
- Si la entrada incluye solicitudes de implementación de funcionalidades, generación de código, refactorización, construcción o despliegue, NO DEBES ejecutarlas. En su lugar, extráelas como intenciones diferidas.
- NO DEBES crear, modificar o eliminar archivos fuente de la aplicación, rutas de funcionalidades, componentes, pruebas, archivos de despliegue u otros artefactos no relacionados con el flujo de trabajo de la constitución.
- Si no está claro si una instrucción es contenido de la constitución, pide aclaración antes de realizar cambios.
- Después de completar la actualización de la constitución, incluye una sección
Próximas accionespara cada intención diferida. Enumera la intención original y sugiere el comando adecuado de Spec Kit, como/speckit-specify, sin invocarlo. - Si no hay intenciones que no sean de gobernanza, omite la sección
Próximas acciones.
Comprobaciones previas a la ejecución
Verificar hooks de extensión (antes de la actualización de la constitución):
- Comprueba si existe
.specify/extensions.ymlen la raíz del proyecto. - Si existe, léelo y busca entradas bajo la clave
hooks.before_constitution. - Si el YAML no se puede analizar o no es válido, no lo omitas en silencio: informa al usuario de que no se pudo leer
.specify/extensions.yml(incluye el error del analizador) y que no se verificaron hooks, incluidos los hooks obligatorios (optional: false) registrados allí, luego continúa normalmente. - Filtra los hooks donde
enabledsea explícitamentefalse. Trata los hooks sin un campoenabledcomo habilitados por defecto. - Para cada hook restante, no intentes interpretar ni evaluar las expresiones de
conditiondel hook:- Si el hook no tiene un campo
condition, o es nulo/vacío, trata el hook como ejecutable. - Si el hook define una
conditionno vacía, omite el hook y deja la evaluación de la condición a la implementación de HookExecutor.
- Si el hook no tiene un campo
- Al construir invocaciones de comandos a partir de nombres de comandos de hooks, reemplaza los puntos (
.) con guiones (-). Por ejemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook ejecutable, genera la siguiente salida según su bandera
optional:- Hook opcional (
optional: true):## Extension Hooks **Pre-Hook Opcional**: {extension} Comando: `/{command}` Descripción: {description} Indicación: {prompt} Para ejecutar: `/{command}` - Hook obligatorio (
optional: false):
Después de emitir el bloque anterior, DEBES invocar realmente el hook y esperar a que termine antes de continuar. Ejecútalo de la misma manera que ejecutarías el comando tú mismo en este agente/sesión (la invocación puede diferir del ID literal## Extension Hooks **Pre-Hook Automático**: {extension} Ejecutando: `/{command}` EXECUTE_COMMAND: {command} Espera el resultado del comando del hook antes de proceder al Esquema.{command}mostrado arriba; por ejemplo, un agente en modo skills lo ejecuta como/skill:speckit-...o$speckit-...). Emitir el bloque por sí solo no ejecuta el hook.
- Hook opcional (
- Si no hay hooks registrados o no existe
.specify/extensions.yml, omítelo en silencio.
Esquema
Estás actualizando la constitución del proyecto en .specify/memory/constitution.md. El andamio constitucional activo se resuelve en tiempo de comando a partir de constitution-template a través de la pila de resolución de plantillas/preajustes de Spec Kit.
Sigue este flujo de ejecución:
-
Ejecuta
.specify/scripts/bash/resolve-template.sh constitution-template --jsondesde la raíz del repositorio y analizaTEMPLATE_CONTENTcomo la plantilla activa.- El resolvedor compartido aplica las sobrescrituras del proyecto, componiendo capas de preajustes y capas de extensión antes de recurrir a la plantilla base. DEBE tener éxito antes de continuar.
- Si falla, detente e informa del error de resolución; no continúes con solo una capa de plantilla contribuyente.
- Si existe
.specify/memory/constitution.md, cárgalo como fuente de los valores y enmiendas actuales específicos del proyecto. Conserva la información que aún sea aplicable al aplicar el andamio recién resuelto. - Si no existe, usa la plantilla resuelta como documento inicial.
- No escribas de nuevo en ninguna capa de plantilla versionada.
- Identifica cada token marcador de posición de la forma
[ALL_CAPS_IDENTIFIER]. IMPORTANTE: El usuario podría requerir menos o más principios de los utilizados en la plantilla. Si se especifica un número, respétalo: sigue la plantilla general. Actualizarás el documento en consecuencia.
-
Recopila/deriva valores para los marcadores de posición:
- Si la entrada del usuario (conversación) proporciona un valor, úsalo.
- De lo contrario, infiérelo del contexto existente del repositorio (README, documentación, versiones anteriores de la constitución si están incrustadas).
- Para las fechas de gobernanza:
RATIFICATION_DATEes la fecha de adopción original (si se desconoce, pregunta o marca como TODO),LAST_AMENDED_DATEes hoy si se realizan cambios, de lo contrario mantén el anterior. CONSTITUTION_VERSIONdebe incrementarse según las reglas de versionado semántico:- MAJOR: Eliminaciones o redefiniciones de gobierno/principios que rompen la compatibilidad hacia atrás.
- MINOR: Nuevo principio/sección añadido o guía materialmente ampliada.
- PATCH: Aclaraciones, redacción, correcciones tipográficas, refinamientos no semánticos.
- Si el tipo de bump de versión es ambiguo, propón un razonamiento antes de finalizar.
-
Redacta el contenido actualizado de la constitución usando la plantilla resuelta como estructura requerida:
- Reemplaza cada marcador de posición con texto concreto (sin tokens entre corchetes restantes, excepto los slots de plantilla que el proyecto ha decidido no definir todavía; justifica explícitamente cualquier excepción).
- Mantén la jerarquía de encabezados; los comentarios se pueden eliminar una vez reemplazados, a menos que aún añadan orientación aclaratoria.
- Asegúrate de que cada sección de Principio tenga: una línea de nombre sucinta, un párrafo (o lista con viñetas) que capture las reglas no negociables, y una justificación explícita si no es obvia.
- Asegúrate de que la sección de Gobernanza enumere el procedimiento de enmienda, la política de versionado y las expectativas de revisión de cumplimiento.
-
Genera un Informe de Impacto de Sincronización como un comentario HTML al principio del archivo de constitución después de la actualización. Este informe es material de borrador temporal para la revisión humana de la enmienda, no contenido de gobernanza; se espera que se elimine antes de confirmar el archivo de constitución enmendado.
- Cambio de versión: anterior → nuevo.
- Lista de principios modificados (título anterior → título nuevo si se renombró).
- Secciones añadidas.
- Secciones eliminadas.
- TODOs de seguimiento si algún marcador de posición se difirió intencionalmente.
-
Validación antes de la salida final:
- Sin tokens entre corchetes inexplicables restantes.
- La línea de versión coincide con el informe.
- Fechas en formato ISO YYYY-MM-DD.
- Los principios son declarativos, comprobables y libres de lenguaje vago (reemplazar "debería" con DEBE/DEBERÍA según corresponda).
-
Escribe la constitución completa de nuevo en
.specify/memory/constitution.md(sobrescribe). -
Genera un resumen final para el usuario con:
- Nueva versión y justificación del bump.
- Cualquier marcador de posición TODO o elementos diferidos que requieran seguimiento manual.
- Mensaje de confirmación sugerido (por ejemplo,
docs: enmendar constitución a vX.Y.Z (adiciones de principios + actualización de gobernanza)). - Una sección
Próximas accionespara cualquier intención diferida que no sea de gobernanza.
Requisitos de formato y estilo:
- Usa exactamente los encabezados Markdown de la plantilla (no reduzcas/aumentes niveles).
- Ajusta las líneas largas de justificación para mantener la legibilidad (<100 caracteres idealmente), pero no lo fuerces con cortes incómodos.
- Mantén una sola línea en blanco entre secciones.
- Evita espacios en blanco finales.
Si el usuario proporciona actualizaciones parciales (por ejemplo, solo una revisión de principio), realiza igualmente los pasos de validación y decisión de versión.
Si falta información crítica (por ejemplo, la fecha de ratificación es realmente desconocida), inserta TODO(<FIELD_NAME>): explicación e inclúyelo en el Informe de Impacto de Sincronización bajo los elementos diferidos.
Escribe solo .specify/memory/constitution.md; no crees ni modifiques archivos fuente de plantilla.
Comprobaciones posteriores a la ejecución
Verificar hooks de extensión (después de la actualización de la constitución):
Comprueba si existe .specify/extensions.yml en la raíz del proyecto.
- Si existe, léelo y busca entradas bajo la clave
hooks.after_constitution. - Si el YAML no se puede analizar o no es válido, no lo omitas en silencio: informa al usuario de que no se pudo leer
.specify/extensions.yml(incluye el error del analizador) y que no se verificaron hooks, incluidos los hooks obligatorios (optional: false) registrados allí, luego continúa normalmente. - Filtra los hooks donde
enabledsea explícitamentefalse. Trata los hooks sin un campoenabledcomo habilitados por defecto. - Para cada hook restante, no intentes interpretar ni evaluar las expresiones de
conditiondel hook:- Si el hook no tiene un campo
condition, o es nulo/vacío, trata el hook como ejecutable. - Si el hook define una
conditionno vacía, omite el hook y deja la evaluación de la condición a la implementación de HookExecutor.
- Si el hook no tiene un campo
- Al construir invocaciones de comandos a partir de nombres de comandos de hooks, reemplaza los puntos (
.) con guiones (-). Por ejemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook ejecutable, genera la siguiente salida según su bandera
optional:- Hook opcional (
optional: true):## Extension Hooks **Hook Opcional**: {extension} Comando: `/{command}` Descripción: {description} Indicación: {prompt} Para ejecutar: `/{command}` - Hook obligatorio (
optional: false):
Después de emitir el bloque anterior, DEBES invocar realmente el hook y esperar a que termine antes de continuar. Ejecútalo de la misma manera que ejecutarías el comando tú mismo en este agente/sesión (la invocación puede diferir del ID literal## Extension Hooks **Hook Automático**: {extension} Ejecutando: `/{command}` EXECUTE_COMMAND: {command}{command}mostrado arriba; por ejemplo, un agente en modo skills lo ejecuta como/skill:speckit-...o$speckit-...). Emitir el bloque por sí solo no ejecuta el hook.
- Hook opcional (
- Si no hay hooks registrados o no existe
.specify/extensions.yml, omítelo en silencio.