DIXI Spec Kit frente a GitHub Spec Kit: por qué el nuestro es más completo, y dónde todavía no

En el artículo anterior contamos cómo construimos nuestro marco de desarrollo guiado por especificaciones y cerramos con diez pasos para que otra organización construyera el suyo. Este artículo es la continuación práctica: ya no hace falta construirlo desde cero. Publicamos el método como software libre, con licencia MIT, bajo el nombre DIXI Spec Kit.
La pregunta obvia es por qué otro kit, si ya existe GitHub Spec Kit, que es un proyecto maduro, con cerca de 150 mil estrellas y soporte para 41 agentes. La respuesta corta: porque Spec Kit resuelve muy bien el tramo que va de la especificación al código, y nuestro método empieza antes y termina después. La respuesta larga es este artículo, con fechas, fuentes y también con lo que a nosotros nos falta.
Actualizado el 13 de noviembre de 2026 con la versión 1.11.1 del kit: referencia de comandos y
de la CLI, guía de migración en español, dixi mode y un /dixi.status que retoma la sesión.
Qué entendemos por «más completo»
Decir que un kit es más completo que otro no significa nada si no se dice en qué. Nosotros lo afirmamos en tres sentidos concretos, y solo en esos:
- Alcance del ciclo. Cubre lo que pasa antes de especificar (descubrimiento, dominios) y lo que pasa después de implementar (verificación, revisión, entrega, operación, cumplimiento).
- Trazabilidad que comprueba una máquina. La cadena del objetivo de negocio a la prueba no es una convención: un comando falla si se rompe.
- Reglas que fallan solas. Las reglas que protegen el proceso se pueden instalar como mecanismos que bloquean al agente, no solo como instrucciones que el agente puede ignorar.
En otros sentidos, Spec Kit es más completo que el nuestro: más agentes, más extensiones, más comunidad. Lo detallamos más abajo, porque una comparación que solo cuenta lo favorable no sirve para decidir.
De dónde sale cada kit
Los dos kits responden preguntas distintas, y eso explica casi todas las diferencias.
GitHub Spec Kit nace para empezar con SDD en cualquier agente: instala comandos que llevan de una idea a una especificación, un plan, una lista de tareas y una implementación. Su fuerza es la amplitud: funciona con casi todo y tiene un ecosistema de extensiones alrededor.
DIXI Spec Kit nace de un marco que ya estaba en producción. Es la versión pública y portable de EIS-IA, el ecosistema que describimos en el artículo anterior y con el que construimos todos nuestros sistemas. Su premisa es la misma: con IA, el cuello de botella no es generar código sino validarlo. Por eso el kit dedica tanto a verificar, revisar y trazar como a especificar.
Primero, la paridad: todo lo de Spec Kit tiene su equivalente
Quien conoce Spec Kit no pierde nada al cambiar. Cada comando tiene su contraparte, con el mismo propósito:
| GitHub Spec Kit | DIXI Spec Kit | Qué cambia |
|---|---|---|
/speckit.constitution |
/dixi.constitution |
Los principios quedan versionados, con registro de cambios, y todas las operaciones los leen. Quitar o redefinir uno exige una decisión de arquitectura escrita |
/speckit.specify |
/dixi.specify |
Cada feature se ubica bajo un módulo y un dominio, y dixi check lo comprueba |
/speckit.clarify |
/dixi.clarify |
Las respuestas se quedan en la especificación |
/speckit.plan |
/dixi.plan |
Según el riesgo, incorpora dominio, arquitectura, contratos y modelo de amenazas |
/speckit.checklist |
/dixi.checklist |
La construcción se detiene mientras haya puntos sin marcar; los marca una persona |
/speckit.tasks |
/dixi.tasks |
Cada tarea lleva nivel de riesgo y enlace al criterio que cubre |
/speckit.analyze |
/dixi.analyze |
Los dos solo leen y reportan |
/speckit.implement |
/dixi.build |
Una tarea a la vez, con la prueba en rojo commiteada antes del código |
/speckit.converge |
/dixi.converge |
Los dos agregan tareas de convergencia sin editar especificaciones ni código |
/speckit.github.taskstoissues (extensión) |
/dixi.issues |
Usa gh, y no crea nada hasta que la persona confirma una vista previa |
Hay una guía para quien viene de Spec Kit, desde la versión 1.10.0 también en español, con el mapa de comandos, dónde vive cada documento y los pasos para mover un proyecto existente.
Después, lo que agrega: 23 operaciones sin equivalente
DIXI Spec Kit instala 33 operaciones. Diez son las de la tabla anterior. Las otras 23 cubren lo que queda fuera del tramo especificar → implementar:
| Etapa | Operaciones | Qué producen |
|---|---|---|
| Antes de especificar | discover, interview, domain |
Visión del producto, actores y alcance; límites de dominio y lenguaje común |
| Diseño | architecture, contract, data, threat-model, ai, quality |
Decisiones de arquitectura, contratos enlazados a sus consumidores, clasificación de datos, amenazas con una prueba planeada por cada una, estrategia de pruebas |
| Verificar y revisar | verify, review, risk-review |
Qué comprobaciones corrieron, cuáles fallaron y cuáles no se corrieron; hallazgos por riesgo para la revisión humana |
| Continuidad y cambio | status, handoff, change, onboard, bugfix |
El siguiente paso justificado y dónde quedó la sesión anterior, un traspaso entre sesiones, el impacto de un cambio, borradores de especificación a partir de código existente y correcciones con prueba en rojo primero |
| Entrega y operación | release, promote, operate, finops |
Evidencia de que una versión está lista, SLOs y runbooks, estimaciones de costo con sus supuestos |
| Cumplimiento | compliance, duediligence |
Mapa de obligaciones y evidencia pendiente; informe respaldado por artefactos |
Un límite importante: las operaciones de entrega, operación y cumplimiento solo escriben
documentos. Nunca ejecutan migraciones, despliegan ni declaran una certificación. Preparan la
evidencia; decide una persona. Lo mismo vale para el modo del proyecto: dixi mode (desde la
versión 1.11.0) muestra si está en mvp o en prod y, en mvp, cuáles de los seis puntos que
revisa /dixi.promote (pruebas y presupuestos, modelo de amenazas, retención de datos, runbooks
y SLOs, entrega y reversión, responsables) todavía no tienen evidencia. Es de solo lectura: no
tiene opción para cambiar el modo.
Y una advertencia que el propio kit trae escrita en su catálogo: el número de comandos, por sí solo, no acredita utilidad ni calidad. Treinta y tres operaciones que nadie verifica valen menos que nueve que funcionan. Lo que importa es lo que viene en las tres secciones siguientes.
Trazabilidad: la diferencia que no se ve en la lista de comandos
En el artículo anterior dijimos que la trazabilidad es uno de los dos ejes que sostienen el marco: cada línea en producción se puede seguir hasta su porqué. En el kit, esa cadena es explícita y la comprueba un comando:
objetivo → dominio → módulo → feature → contrato → prueba
dixi check recorre el proyecto y falla si una feature no cita su módulo, si un módulo no cita
su dominio, si un enlace apunta a un documento que no existe o si la cadena se corta. No ejecuta
código, no usa IA y no necesita red: es una comprobación mecánica, la misma en la laptop y en CI.
En Spec Kit, specify check comprueba otra cosa: que las herramientas del agente estén
instaladas. La coherencia entre artefactos la revisa /speckit.analyze, que es un comando del
agente. La diferencia es de naturaleza, no de grado: un reporte del agente es una opinión; un
validador que sale con código 1 es un control. El kit tiene los dos, y dice cuál es cuál:
analyze interpreta la coherencia semántica y dixi check comprueba las reglas mecánicas.
De ahí sale también una diferencia de estructura. Spec Kit organiza el trabajo por feature
(specs/NNN-nombre/). DIXI lo organiza en carpetas numeradas que persisten: dominios, módulos,
features, contratos, datos, decisiones. Las especificaciones a nivel de módulo que sobreviven a
la feature son una petición abierta en Spec Kit (issue #1100); en DIXI son 04-modules/.
Reglas que fallan solas
La lección más cara que contamos en el artículo anterior fue esta: una regla que depende de que alguien se acuerde no es un control. El kit lleva esa lección a quien lo instala.
Por defecto, igual que en Spec Kit, las reglas son instrucciones para el agente. Con --controls
se instalan cinco hooks que revisan cada acción antes de que ocurra:
| Regla | Sin --controls |
Con --controls |
|---|---|---|
| No editar una prueba ya commiteada | Instrucción | La bloquea un hook |
| No leer secretos | Parcial | La bloquea un hook |
| No firmar, aprobar ni integrar a nombre de la persona | Instrucción | La bloquea un hook |
| No correr comandos destructivos en modo producción | Instrucción | La bloquea un hook |
| No declarar «terminado» con la verificación en rojo | Instrucción | La bloquea un hook (una vez; después decide la persona) |
Son los mismos cinco hooks que usamos nosotros, y funcionan en Claude Code y en Codex.
Dos precisiones para no prometer de más. Los hooks son una segunda capa, no la última: un
agente puede llegar a un archivo por un camino que el hook no inspecciona, y la protección
efectiva sigue siendo la revisión humana y la protección de rama. Y son opcionales: quien no
agrega --controls tiene las mismas garantías que con cualquier kit basado en instrucciones.
Pruebas primero, y una persona que responde
Dos reglas del kit no tienen equivalente en Spec Kit, y son las que más cambian el trabajo diario.
La prueba se congela antes del código. /dixi.build toma una tarea a la vez: escribe las
pruebas, muestra que fallan por la razón esperada y propone guardarlas en su propio commit. A
partir de ahí son pruebas congeladas: el agente escribe código hasta ponerlas en verde y no las
toca. Si una prueba parece incorrecta, se detiene y lo explica. Sin esto, el camino más corto a
«verde» es ajustar la prueba.
El agente no firma, no aprueba, no integra y no despliega. Prepara el cambio y la evidencia; una persona con nombre lo revisa y lo integra. El kit tampoco impone una estrategia de ramas ni crea ramas por su cuenta (en Spec Kit, poder configurarla sin hacer un fork de los comandos es la petición del issue #2047).
El proceso además es proporcional, como en el marco de origen: cada tarea lleva un nivel de 0
(corrección) a 3 (estructural), y una tarea de nivel 3 necesita la validación de una persona antes
de construirse. Antes de empezar una tarea, build revisa el límite de trabajo en curso (tres
PRs abiertos por omisión) y sugiere terminar uno antes de abrir otro. Y dixi pr-size mide la
rama contra un máximo de 1 500 líneas, sin contar pruebas ni documentación.
Perfiles: lo que nace con el proyecto
Spec Kit instala comandos y plantillas para sus artefactos. DIXI instala, además, la base documental del proyecto según su tamaño:
| Perfil | Para qué | Plantillas |
|---|---|---|
minimal (por omisión) |
Probar el método | La base de 16 archivos |
site |
Landing o sitio de contenido sin backend propio | 77 |
app |
Sitio, panel, API y una base de datos | 190 |
platform |
Varios servicios, eventos o equipos | 241 |
--regulated |
Se suma a cualquiera: pagos, salud, datos sensibles | Hasta 273, con GDPR, SOC 2, ISO 27001, HIPAA y PCI DSS |
Las plantillas son guías con huecos marcados, no decisiones tomadas: las que no aplican se
borran, y dixi placeholders lista lo que queda por llenar. Todo viene en español y en inglés,
incluidos los comandos y los mensajes de la CLI.
Proyectos que ya existen y proyectos que envejecen
Un kit se prueba menos el día que se instala que seis meses después. Aquí hay cuatro diferencias:
- Adoptar un repositorio existente.
dixi init --existingagrega el kit a una carpeta con archivos sin sobrescribir ninguno, y/dixi.onboardredacta borradores de módulos y features a partir del código, con evidencia de archivo y línea, para que una persona los valide. - Actualizar un proyecto ya iniciado.
dixi upgrade --dry-runmuestra qué cambiaría la versión nueva del kit;dixi upgrade --applyescribe solo los archivos del kit que usted no editó, uno por uno y de forma atómica. En Spec Kit,specify self upgradeactualiza la herramienta; el procedimiento para proyectos ya iniciados es una petición abierta (issue #1210). - Corregir sin perder el rastro.
/dixi.bugfixexige una prueba que reproduzca el error, commiteada antes del arreglo, y deja un registro enlazado a la feature. - Retomar donde se quedó. Desde la versión 1.11.0,
/dixi.statusno solo propone el siguiente paso: reporta qué hizo y qué dejó abierto la última sesión (si hay un traspaso escrito), los cambios recientes en los contratos según el historial de Git y las tareas abiertas por ID. Solo lee: no escribe, no hace commits ni push.
Menos superficie
Una decisión de diseño que parece menor: la CLI no tiene dependencias (solo la biblioteca estándar de Python), no usa red, no consume IA y no pide credenciales. Cada escritura rechaza enlaces simbólicos, y en Windows nativo el comando sale con un código de error en lugar de escribir con garantías más débiles (Windows funciona a través de WSL 2, verificado en CI).
Para una herramienta que se instala en la máquina donde viven el código y los secretos, menos piezas es menos que auditar.
Los diez pasos del artículo anterior, ya resueltos
Cerramos el artículo anterior con diez pasos para construir un SDD propio. Esto es lo que el kit le entrega de cada uno, y lo que no:
| Paso | Qué trae el kit |
|---|---|
| 1. Empezar por la premisa | /dixi.discover y /dixi.constitution: visión y principios versionados |
| 2. Un modelo con dueños | Plantillas de gobierno en los perfiles. El dueño lo pone usted |
| 3. La lista corta de lo no negociable | Los límites que repite cada operación y la matriz de soporte, que dice qué es automático y qué es instrucción |
| 4. Reglas convertidas en mecanismos | --controls: cinco hooks para Claude Code y Codex |
| 5. Trazabilidad verificable | dixi check y .dixi/traceability.json |
| 6. Norma separada del proyecto, y versionada | dixi upgrade distingue los archivos del kit de sus ediciones; dixi preset sustituye textos del kit por los de su equipo |
| 7. Una persona detrás de cada cambio | El agente no firma ni integra. La segunda revisión la impone la protección de rama de su repositorio, no el kit |
| 8. Proceso proporcional | Niveles de riesgo 0 a 3 en cada tarea |
| 9. Límite de trabajo en curso | build lo revisa antes de empezar (tres por omisión) |
| 10. Medir | Solo el tamaño del PR, con dixi pr-size. Tiempo de entrega y retrabajo quedan fuera |
Lo que el kit no trae de nuestro marco es la cadena de despliegue: los gates de la pipeline que comprueban firma y atestación después del merge dependen de la nube de cada quien. El kit entrega las plantillas para documentarla, no la infraestructura.
Dónde GitHub Spec Kit va por delante
| Área | GitHub Spec Kit | DIXI Spec Kit |
|---|---|---|
| Agentes | 41 integraciones, más generic y none |
Claude Code y Codex verificados; un adaptador de Agent Skills verificado en OpenCode y con formato compatible, sin verificar, para Cursor, VS Code/Copilot, Gemini CLI y otros |
| Extensibilidad | Extensiones, presets, workflows, bundles y catálogos; el proyecto lista 186 extensiones y 42 presets de la comunidad | Extensiones y presets locales, solo de datos. Sin catálogos |
| Workflows | Ejecutables y reanudables, con puntos de revisión humana | dixi workflow prepara el contexto de cada operación; la ejecuta el agente |
| MCP | Servidor experimental de solo lectura | Ninguno |
| Sistemas | Windows, macOS y Linux | macOS y Linux; Windows solo con WSL 2 |
| Idiomas del README | Inglés, chino, japonés y coreano | Inglés y español |
| Comunidad y madurez | Cerca de 150 mil estrellas; versión 1.4.0 | Primera versión pública el 8 de noviembre de 2026; versión 1.11.1 cinco días después |
Este último renglón es el que más pesa. Un proyecto con una semana de vida pública no tiene el desgaste de uno que han usado miles de equipos, por muchas pruebas que traiga.
Cuál elegir
- Elija GitHub Spec Kit si su agente no es Claude Code ni Codex, si trabaja en Windows nativo, si quiere apoyarse en un catálogo de extensiones de la comunidad o si necesita workflows ejecutables.
- Elija DIXI Spec Kit si necesita que las especificaciones sobrevivan a la feature, que la trazabilidad la compruebe una máquina, que las reglas bloqueen al agente en lugar de pedirle que se porte bien, o si su proyecto tiene que documentar seguridad, operación y cumplimiento además de código. También si su equipo trabaja en español.
- Puede usar los dos. Viven en carpetas distintas (
.specify/yspecs/frente a las carpetas numeradas y.dixi/). Mover un proyecto de uno a otro es un mapeo manual, que revisa una persona en cada paso.
Cómo empezar
Requiere Python 3.11 o superior, en macOS o Linux:
uv tool install dixi-spec-kit # o: pipx install dixi-spec-kit
dixi --lang es init mi-proyecto --agent claude --profile app --controls
cd mi-proyecto
dixi doctor && dixi check
Y después, en el agente:
/dixi.discover <su idea>
/dixi.specify <funcionalidad>
/dixi.plan <ID de la feature>
/dixi.tasks <ID de la feature>
/dixi.build <ID de la tarea>
/dixi.verify
/dixi.review main
El repositorio trae dos ejemplos completos, de la idea a las pruebas: una biblioteca de notas y un sitio Next.js en dos idiomas. La documentación está en español y en inglés.
Desde la versión 1.10.0 la documentación dejó de ser solo el README. Trae una guía de comandos con el mapa del recorrido y una tabla de qué comando usar en cada momento; una referencia con una página por operación (para qué sirve, cuándo usarla, qué lee y qué escribe, dónde se detiene y un ejemplo para Claude Code, Codex y Agent Skills); y una referencia de la CLI con cada comando, opción y código de salida. Las dos referencias se generan a partir de los textos de los comandos y del analizador de argumentos reales, y una prueba falla si una página falta o quedó desactualizada: es la misma idea del resto del kit, aplicada a su propia documentación.
Lo que este artículo no afirma
- No afirma que GitHub Spec Kit sea un mal proyecto. Es el que abrió el camino, y en agentes, extensiones y comunidad va muy por delante.
- No afirma que más operaciones sea mejor. Afirma que el método cubre más etapas del ciclo y que comprueba más cosas con mecanismos. Si su proyecto solo necesita ir de la especificación al código, la diferencia le importará poco.
- No afirma que los hooks sean infalibles. Son una segunda capa. La primera sigue siendo una persona que revisa.
- No afirma que las cifras de Spec Kit sigan vigentes. Son de un proyecto que cambia rápido. Están fechadas; verifíquelas antes de reutilizarlas.
Fuentes
- DIXI Spec Kit, versión 1.11.1 (13 de noviembre de 2026): repositorio, comparación con Spec Kit, matriz de soporte, registro de cambios (versiones 1.9.0 a 1.11.1), hoja de ruta y la decisión de arquitectura ADR-108 sobre la paridad con Spec Kit.
- GitHub Spec Kit, versión 1.4.0 (10 de noviembre de 2026): repositorio, sus plantillas de comandos, su documentación de integraciones y los issues #1100, #1210 y #2047, abiertos al 13 de noviembre de 2026. Las cifras de extensiones y presets son las que el proyecto publicaba el 11 de noviembre de 2026.
- Dixi-Project: Cómo construimos nuestro marco de desarrollo guiado por especificaciones (2026).