Vista generada de dec-0099: Pausa de Styx para la fundación de Axon
docs/decisions/dec-0099-pausa-styx-axon-foundation.mdVista generada desde
docs/decisions/dec-0099-pausa-styx-axon-foundation.md. No se edita a mano:bun run docs:genla regenera ybun run docs:checkfalla si difiere. El estado aquí es el del model: si discrepa con otra página, manda el model.
| Campo | Valor |
|---|---|
| Estado | SUPERSEDED |
| Fecha | 2026-07-17 |
| Fichero | docs/decisions/dec-0099-pausa-styx-axon-foundation.md |
Enmendado o sustituido por: dec-0102
Por qué importa (del frontmatter del ADR):
Pausa la ejecución de TODO el roadmap de producto de Styx. Mientras esté LOCKED y sin cumplir su criterio de salida, ningún nodo de Styx avanza:
styx.model.ymldescribe un roadmap que nadie está ejecutando. Cualquier sesión que lea el modelo y asuma que el trabajo está en curso está leyendo mal — este ADR es el único sitio donde consta que no.
Nodos del roadmap que lo citan en refs: ninguno.
Páginas de la documentación que lo citan: ninguna todavía.
Leído de docs/decisions/dec-0099-pausa-styx-axon-foundation.md, el fichero canónico.
⚠️ SUPERSEDED por
dec-0102(2026-08-27). El freezescope=allde este ADR queda levantado — waxin: "lo pusimos muy literal ese freeze cuando es algo visual, podemos dejarlo abierto eso". La parte visual del criterio de salida (cockpit) pasa a no-bloqueante en vez de condición de salida. Detalle endec-0102.
dec-0102)docs/governance/axon-cli/PLAN.mddocs/reviews/agentics-axon-workspaces/respuestas-consolidacion-2026-07-17.mdStyx se pausa —producto entero, no una fase— hasta que Axon exista como herramienta usable. El parón tiene criterio de salida explícito y verificable (abajo). Cuando se cumple, Styx vuelve a prioridad absoluta.
Es eliminar un cuello de botella de la infraestructura de desarrollo del ecosistema. La distinción es load-bearing: si fuera un cambio de prioridad, competiría con Styx y habría que justificar por qué Axon vale más que el producto. No compite: Axon es cómo se construye Styx.
Tres hechos lo sostienen:
decision → track → ticket → plan → exec → commits → sessions— existe repartida entre 8
formatos: markdown, yaml, git, jsonl, taskwarrior, handoffs, commits, roadmap. Eso no se sostiene
en memoria humana, y hoy se compensa a base de grep y de sesiones de arqueología.La review externa argumentó que "ya tienes task-sync, parser, governance, ids, DAG, guards, modelo v2, commit wizard — falta unirlos". Verificado 2026-07-17: es falso. No es integración, es construcción:
| Pieza que se daba por hecha | Realidad verificada |
|---|---|
| parser JSONL | No existe. 0 hits en task-sync. docs/governance/axon-cli/ARCHITECTURE.md:70 lo marca ← NUEVO |
| guards | Son styx/scripts/*.ts, acoplados a paths de Styx. Hacerlos portables es el trabajo, no un activo |
| DAG / modelo v2 / ids | styx.model.yml es la instancia de Styx, no una librería. Existe el esquema realizado en un repo, no el modelo extraíble |
| commit wizard | Paquete npm (gemini-commit-wizard@1.3.0), desactivado a mano el 2026-07-16 |
| task-sync | 9206 LOC · 0 consumidores · 0 hooks registrados · nunca ha corrido en producción |
Esto no invalida la decisión — invalida la tranquilidad. El parón se sigue defendiendo por los 3 hechos de arriba. Pero como el coste es mayor de lo que parecía, el criterio de salida no es opcional: es la única cosa que impide que este parón se coma el producto.
Cuando pueda abrir
axon statusy saber qué hice ayer, qué toca hoy, qué agentes trabajaron, qué tickets siguen abiertos, y navegar visualmente el roadmap sin abrir Markdown — el parón termina y Styx vuelve a ser prioridad absoluta.
El benchmark que lo hace concreto: «si cierro el portátil un mes, al volver entiendo Styx en diez minutos.»
Este criterio incluye la UI a propósito (navegar visualmente el roadmap) — es coherente con que
el cockpit entre en el alcance (abajo). Sin esa cláusula el criterio se cumpliría con una CLI y el
problema de representación seguiría intacto.
Entra (detalle y orden en el PLAN):
| # | Milestone | Qué |
|---|---|---|
| M0 | axon-core | Modelo · índices · parser JSONL · git · integración tw. Repo nuevo propio. Nada de UI |
| M1 | CLI axon | status · show · now · add · done · roadmap · graph · tw sync. Aquí mueren los greps manuales |
| M2 | Cognitive Cockpit | Dentro de gateway-web de mks-agentics. Roadmap DAG + sessions + git + tasks + evidence + agents + timeline + commits + estado |
| — | A2A | F2 (invocation model) + loop-guard + parity. Paso 5, antes de volver a Styx |
NO entra — explícitamente:
gateway-web, que ya existe.mks-git-client), pese a estar LOCKED desde 2026-04-27 y parado
en el umbral de su gate 4.mapPriorityToQueue muerto,
inbox con evicción silenciosa, /admin/* legacy, better-auth zombi…). Ninguna entra. Se
arreglan solo si M0/M1/M2 tropiezan con ellas.Los tres se lockearon el mismo día y viven en docs/governance/axon-cli/ARCHITECTURE.md:
axon-core va a un repo nuevo, no a mks-agentics/core/packages/. El
argumento de L1 («ahí están las piezas y los consumidores») era falso: task-sync tiene 0
consumidores y 0 imports de agentics (su @mks-agentics/gateway-protocol es dep fantasma).task-sync se queda en agentics, se publica y se importa. Ya no es
cantera: es dependencia. Razón: su consumidor real es el cockpit (gateway-web), que vive ahí.Positivas
gateway-web y justifica que task-sync se quede.Negativas / costes asumidos
styx.model.yml describirá un roadmap que nadie ejecuta mientras dure el parón. Es la razón de
ser de este ADR: sin él, el modelo miente por omisión — exactamente el fallo que
mks-agentics/docs/jarvis/adr/unified-governance/0023-call-sites-como-unica-evidencia.md documenta
en mks-workspaces (spec y ROADMAP coincidiendo, 53 días fuera de la realidad).gateway-web son 50697 LOC con
3 tests, y arrastra fixtures que importan @mks-agentics/harness-core, un paquete inexistente
desde el rename. Más barato que una app nueva —por eso se elige— pero no es greenfield.task-sync (el process.exit top-level que cuelga la suite, y propagateTwStatus
metiendo status como UDA) ya no se arreglan «de paso»: L2 los arreglaba al extraer, y no hay
extracción. Necesitan arreglo propio.Riesgo principal, nombrado
Que Axon se coma indefinidamente el tiempo del producto. El único mecanismo de control es el criterio de salida, y su cláusula más débil es la de la UI: «navegar visualmente el roadmap» admite interpretaciones de una tarde y de dos meses. El PLAN acota qué cuenta como suficiente — si esa acotación se relaja, este ADR pierde su guard rail y hay que revisarlo, no estirarlo en silencio.