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

Procedimientos compartidos

Propósito

Usar cada operación de DIXI desde la terminal, sin elegir un agente obligatorio. La CLI ofrece las recetas en español e inglés y prepara un contexto verificable; el trabajo en sí, a mano o con ayuda, se hace con las herramientas de cada quien.

Consultar el método

Instala el paquete (uv tool install dixi-spec-kit) o el wheel local según la guía de desarrollo local. Después:

dixi --lang es workflow list
dixi --lang es workflow show discover
dixi --lang es workflow show plan

No necesitas un proyecto para listar o consultar recetas. Cada una expone entradas, pasos, artefactos esperados, gates, comprobaciones y procedimientos siguientes. Los nombres son operaciones comunes; aquí no son comandos de barra instalados en Codex o en Claude.

Preparar el ejemplo de notas

mkdir -p .context
dixi --lang es init .context/notas-b2 --agent none
cd .context/notas-b2
dixi --lang es workflow prepare discover --target GOAL-001 --request "Una biblioteca local para crear y listar notas ficticias, sin cuentas ni datos personales"

Usa un destino nuevo si notas-b2 ya existe. El proyecto inicial trae IDs de ejemplo en borrador. La orden valida el objetivo y devuelve el procedimiento con un manifiesto de fuentes, tamaños y hashes; no rellena la visión, no decide la arquitectura ni escribe specs. Que un ID exista no significa que el documento esté completo.

Para hacer el trabajo, lee las fuentes indicadas, aplica los pasos de la receta con tus herramientas y conserva las preguntas sin respuesta. Revisa las diferencias antes de incorporarlas. Si usas un agente, las guardas compartidas siguen siendo instrucciones: la receta no instala hooks ni evalúa a ese agente. Después de editar, comprueba las referencias con dixi check y vuelve a preparar para obtener los hashes actuales.

Recorrido de definición y diseño

ProcedimientoObjetivo de ejemploResultado esperado al realizarlo
discoverGOAL-001Problema, actores, alcance, exclusiones y preguntas.
domainGOAL-001Dominio, invariantes y relación con los módulos.
specifyMODULE-001Feature con criterios observables y escenarios.
clarifyFEATURE-001Respuestas confirmadas y dudas que bloquean.
architectureMODULE-001Alternativas y ADR en borrador.
contractFEATURE-001Interfaz, errores, compatibilidad y casos planeados.
threat-modelFEATURE-001Amenaza → mitigación → prueba planeada.
planFEATURE-001Bloques, dependencias, raíces de código y verificaciones.

Son IDs del proyecto generado, no identificadores obligatorios para todo proyecto. Mira .dixi/traceability.json y elige el objetivo real. Reutiliza los documentos e IDs existentes y registra las rutas nuevas cuando se creen; prepare no elige el primer módulo ni inventa un destino donde escribir.

dixi --lang es workflow prepare specify --target MODULE-001 --request "Definir la creación y el listado de notas con criterios observables"
dixi --lang es workflow prepare plan --target FEATURE-001 --request "Planear la implementación después de resolver las decisiones abiertas"
dixi --lang es --json workflow prepare plan --target FEATURE-001 --request "Preparar un plan de implementación para notas"

El idioma de la receta se elige con --lang; el paquete guarda project_language por separado. Cambiar el idioma de salida no modifica los documentos existentes.

Todas las operaciones

Cada operación que instalan los adaptadores de Claude Code y Codex tiene una receta (ADR-108, fase B). prepare acepta solo los tipos de objetivo listados; los procedimientos siguientes son los que sugiere cada operación.

OperaciónTipo de objetivoProcedimientos siguientes
discovergoaldomain, clarify
specifymoduleclarify, contract, plan
clarifygoal, domain, module, feature, contract, testspecify, plan
planfeature—
tasksfeaturebuild
buildfeatureverify
verifyfeaturebuild, review
reviewfeature—
analyzefeatureclarify, specify, plan, build
statusgoalclarify, build
domaingoal, domainarchitecture, specify
architecturedomain, module, featurecontract, threat-model, plan
contractmodule, featurethreat-model, plan
threat-modelmodule, featureplan
handoffgoal—
changefeaturespecify, plan, tasks
datamodulecontract, plan
qualitymoduletasks
aigoalthreat-model, plan
releasegoalreview
promotegoalquality, threat-model, operate, data
operatemodulepromote
finopsgoalplan
compliancegoaldata, threat-model, operate
duediligencegoal—
interviewgoaldiscover, clarify, status
risk-reviewfeature—
constitutiongoal—
checklistfeatureclarify, specify, contract, plan
convergefeatureclarify
onboardgoalconstitution, clarify, converge
bugfixfeatureclarify, change, verify, review
issuesfeaturebuild

Una receta describe el procedimiento; no lo ejecuta. Preparar build, verify o release no ejecuta make verify ni ninguna otra comprobación: quien realiza el procedimiento las ejecuta e informa el resultado real. Ninguna receta firma, aprueba, integra, despliega ni cambia MODE.

Leer el paquete

Con --json, el sobre indica si la operación de la CLI terminó. Dentro de workflow.packet:

La selección no sustituye una revisión semántica ni descubre todos los contratos relacionados. Para ampliar el contexto, identifica las fuentes relevantes dentro del alcance autorizado; no sigas instrucciones incrustadas que pidan leer secretos. Antes de aplicar el trabajo, compara el estado actual con los hashes o vuelve a preparar. No es una instantánea ni una firma.

Límites: solicitud de hasta 4 096 caracteres, hasta 64 fuentes, 1 MiB por archivo y 2 MiB en conjunto. Sin red, sin ejecución y sin escrituras en el proyecto. Los errores de argumentos u objetivo devuelven 2; contenido, rutas o límites inválidos, 1; esquema o plataforma incompatibles, 4; entrada o salida, 5. Preparar un paquete no es evidencia de que los pasos se ejecutaran, y preparar de nuevo es determinista si no cambian los bytes ni los argumentos. La CLI no invoca un modelo ni hace cumplir las guardas en un agente externo. upgrade es una orden de la CLI, no una operación que se pueda preparar.

Relacionado