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

/dixi.architecture

Propósito

Proponer diseño y decisiones de arquitectura como ADR.

Proponer el diseño para el objetivo de $ARGUMENTS con alternativas, consecuencias y ADRs.

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

Invocación

Argumento: <ID de dominio, módulo o feature>. 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. Ejecuta dixi workflow prepare architecture --target <ID> --request "<decisión a tomar>" y sigue sus pasos.
  2. Lee las specs del objetivo y los ADRs existentes en 09-architecture/adr/; no contradigas uno aceptado sin señalarlo.
  3. Para cada decisión estructural escribe 09-architecture/adr/ADR-NNN-<slug>.md con contexto, al menos dos alternativas, decisión propuesta y consecuencias. Estado: «Propuesto».
  4. Ningún ADR pasa a «Aceptado» sin validación explícita de la persona; registra quién y cuándo lo valida.
  5. Enlaza el ADR desde las specs afectadas.
  6. Sugiere /dixi.contract, /dixi.threat-model o /dixi.plan.

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, comprobaciones (ejecutadas, fallidas, no ejecutadas), pendientes y el siguiente comando sugerido.

Siguiente paso

Relacionado