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

/dixi.clarify

Propósito

Resolver dudas de una spec con preguntas y registrar decisiones y supuestos.

Reducir la ambigüedad de la spec indicada en $ARGUMENTS preguntando a la persona, y registrar sus respuestas sin mezclarlas con supuestos.

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

Invocación

Argumento: <ID o ruta de la spec>. 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. Identifica la spec por ID o ruta; si no está claro, pregunta y detente.
  2. Ejecuta dixi workflow prepare clarify --target <ID> --request "<qué aclarar>" y sigue sus pasos.
  3. Detecta preguntas abiertas, criterios no verificables y contradicciones. Haz como máximo cinco preguntas por ronda, de la más bloqueante a la menos.
  4. Registra cada respuesta en la spec como «Decisión (persona, fecha)». Lo que no responda queda como «Supuesto» o «Pendiente», nunca como decisión.
  5. Sugiere otra ronda si quedan dudas bloqueantes, 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