dec-0044

Vista generada de dec-0044: Governance reconciliation

ImplementadoSin versión del tren todavía· generada desde docs/decisions/dec-0044-governance-reconciliation.md
track/docsdec-0124track/docs:DC10

Vista generada desde docs/decisions/dec-0044-governance-reconciliation.md. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere. El estado aquí es el del model: si discrepa con otra página, manda el model.

CampoValor
EstadoLOCKED (migrado de un rNN por gate-3: el fichero no declara estado)
Referencia legadaD5
Ficherodocs/decisions/dec-0044-governance-reconciliation.md

Enmendado o sustituido por: r32, r47

Por qué importa (del frontmatter del ADR):

scripts/roadmap-consistency.ts (fileoverview cita 'TKT-010, r31' + 'Prohibido el contador 6/8... (r31 D1)' + checks de divergencia spec/ROADMAP líneas 1005 'Gana el spec (r31 D5)') + docs/governance/roadmap-ssot.md:3 ('Regla lockeada TKT-010, 2026-06-23, r31 D5') + TKT-010-governance-reconciliation.md (ref: 'r31 D5') + CLAUDE.md raíz (tabla 'Fuentes de verdad': roadmap.spec.yml = SSOT, 'gana el spec')

Nodos del roadmap que lo citan en refs: ninguno.

Páginas de la documentación que lo citan: ninguna todavía.

Texto del ADR

Leído de docs/decisions/dec-0044-governance-reconciliation.md, el fichero canónico.

Governance reconciliation

Governance reconciliation: roadmap.spec.yml = SSOT machine-readable canónico; ROADMAP.md = vista derivada validada contra él; guard CI que falla si divergen (incluye ban '6/8' extendido a ADRs); fix inmediato de instrucción obsoleta en TKT-004.

Por qué pasa gate-3

  • Hard-to-reverse: Establece una jerarquia de fuentes de verdad con guard CI; revertir significaria volver al status quo ante (divergencia spec/ROADMAP permitida)
  • Surprising sin contexto: Un ingeniero no inferiria que roadmap.spec.yml es SSOT sobre ROADMAP.md (usualmente el MD es canon) sin este ADR; la obligacion de test CI que falla es counter-intuitive
  • Trade-off real: La alternativa era mantener dos fuentes de verdad con drift (coste sincronizacion) o ROADMAP.md como unico canon (no machine-readable); se eligio spec YAML como SSOT + MD derivado

Procedencia

Split de docs/decisions/r31-foundation-closure-v2-reference-harvest-2026-06-23.md (lock D5) durante PASO 7 (2026-07-16). Ver el fichero padre para el contexto completo del pack original.