Documentación de DIXI Spec Kit English · Código en GitHub

/dixi.constitution

Propósito

Crear o modificar los principios del proyecto (su constitución), versionados.

Crear o modificar 00-governance/principles.md, la constitución del proyecto: los pocos principios que cualquier otra operación lee antes de actuar, con el cambio descrito en $ARGUMENTS. Solo gobernanza; aquí no cambia código, specs ni pruebas.

Generada por scripts/build-command-reference.py a partir del texto empaquetado del comando; no la edites a mano.

Invocación

Argumento: [principios que añadir o cambiar, o vacío para revisar]. Los signos de menor y mayor marcan un valor obligatorio y los corchetes uno opcional. En los pasos, $ARGUMENTS es el texto escrito después del comando.

Ejemplo

El texto después del comando es la petición; cámbialo para que corresponda a tu proyecto.

Cuándo usarlo

Pasos

  1. Lee 00-governance/principles.md si existe, 00-master-spec.md, 01-business/vision.md y los ADR que citan algún principio. Si el archivo no existe, créalo con: propósito, una línea Versión: X.Y.Z y una línea Última modificación: AAAA-MM-DD, las tablas de principios (visión P-NN, arquitectura A-NN, ingeniería E-NN, cada uno con «qué significa en la práctica»), el orden de precedencia cuando chocan, cómo se cambia un principio y una sección ## Registro de cambios.
  2. Aplica solo el cambio pedido. Conserva los IDs existentes; un principio retirado conserva su ID marcado como retirado y nunca se reutiliza. Usa {{pending: …}} para cualquier valor que la persona no haya decidido; no inventes principios.
  3. Versiona el documento: MAJOR cuando se elimina un principio o se redefine de forma incompatible, MINOR cuando se añade uno o se amplía de forma sustancial, PATCH para redacción que no cambia el significado. Añade una línea fechada a ## Registro de cambios con la versión, el cambio y su motivo.
  4. Enumera el impacto: specs, planes, tareas, ADR, plantillas e instrucciones de agente que citan o contradicen un principio cambiado. No los edites aquí; propón la operación que actualiza cada uno.
  5. Eliminar o redefinir un principio es una decisión estructural: redacta el ADR en 09-architecture/adr/ como «Propuesto» y detente hasta que la persona lo apruebe.
  6. Sugiere /dixi.analyze para encontrar documentos que ahora choquen con los principios.

Archivos que lee y escribe

Rutas que nombra el texto del comando:

Paradas y controles humanos

Cierre

Ejecuta dixi check antes de terminar e informa: archivos tocados, la nueva versión, la lista de impacto, comprobaciones (ejecutadas, fallidas, no ejecutadas), pendientes y el siguiente comando sugerido.

Siguiente paso

Sin operación siguiente fija; /dixi.status sugiere una.

Relacionado