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

/dixi.converge

Propósito

Comparar el código con las specs de la feature y añadir tareas de convergencia trazadas.

Comparar lo que hace hoy el código con la spec, los contratos, el plan, las tareas y los principios de la feature indicada en $ARGUMENTS, y convertir cada hueco en una tarea trazada. Repite con /dixi.build hasta que no falte nada.

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

Invocación

Argumento: [slug de la 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. Lee la spec de la feature y sus criterios de aceptación, sus contratos, el plan, 05-features/<slug>/tasks.md, las pruebas relacionadas y 00-governance/principles.md. Ejecuta las pruebas reales del proyecto con make verify si existen e informa del resultado; nunca afirmes que se ejecutó una comprobación que no se ejecutó.
  2. Lee el código en las raíces autorizadas que indica el plan. Para cada criterio, cláusula de contrato y principio, decide si el código lo cumple, citando archivo y línea.
  3. Clasifica cada hueco con un tipo: missing (requerido y no implementado), partial (implementado sin todos sus criterios), contradicts (el código hace algo que la spec o un principio prohíbe) o unrequested (código sin spec detrás, que una persona debe especificar o retirar). Un choque con un principio es siempre la máxima gravedad.
  4. Añade una sección ## Convergence AAAA-MM-DD a 05-features/<slug>/tasks.md con una tarea por hueco, continuando la numeración (T-NNN): tipo, origen al que se traza (criterio, cláusula de contrato o ID de principio), evidencia (archivo y línea), la prueba que se escribe primero y un nivel de riesgo.
  5. Si no hay huecos, deja tasks.md sin cambios y responde que la feature ha convergido, con la evidencia.
  6. Sugiere /dixi.build para la primera tarea de convergencia, o /dixi.clarify cuando un hueco venga de una spec ambigua.

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

Siguiente paso

Relacionado