diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3dc4282b..33b9ea09 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -25,7 +25,18 @@ jobs:
node-version: "20"
- name: Validate docs
- run: node .harness/scripts/validate-docs.mjs
+ shell: bash
+ run: |
+ set -o pipefail
+ node .harness/scripts/validate-docs.mjs 2>&1 | tee documentation-validation.log
+
+ - name: Upload validation diagnostics
+ uses: actions/upload-artifact@v4
+ if: always()
+ with:
+ name: documentation-validation-log
+ path: documentation-validation.log
+ retention-days: 30
- name: Check bilingual parity
run: node .harness/scripts/check-bilingual-parity.mjs
@@ -42,4 +53,4 @@ jobs:
retention-days: 30
- name: Report bilingual coverage
- run: node .harness/scripts/bilingual-coverage.mjs
\ No newline at end of file
+ run: node .harness/scripts/bilingual-coverage.mjs
diff --git a/.harness/scripts/validate-root-cleanliness.mjs b/.harness/scripts/validate-root-cleanliness.mjs
index 6e6bca10..4c072015 100755
--- a/.harness/scripts/validate-root-cleanliness.mjs
+++ b/.harness/scripts/validate-root-cleanliness.mjs
@@ -24,7 +24,8 @@ const allowedFiles = new Set([
"COVERAGE_REPORT.md",
"cli-core-parity-tracking.md",
"evolith-validated-tool-catalog.md",
- "package.json"
+ "package.json",
+ "package-lock.json"
]);
// Explicit whitelist of allowed directories in the root directory.
diff --git a/README.es.md b/README.es.md
index ccf8cdcf..f360c320 100644
--- a/README.es.md
+++ b/README.es.md
@@ -1,255 +1,158 @@
-
-
# Evolith: Base de Referencia de Arquitectura Progresiva
-> **Navegación Bilingüe:** [English](./README.md)
-
-[]()
-[]()
-[]()
-[](https://github.com/beyondnetcode/evolith_arch32/actions)
-[](./COVERAGE_REPORT.md)
-
-
-
-
-
-
-
-
↑ Visión General del Producto Evolith E2E · MD3 — clic para ampliar
-
-
-
-**Evolith es el upstream de arquitectura corporativa para repositorios de productos.**
-Define estándares de arquitectura reutilizables, reglas de gobernanza, ADRs, patrones
-y guía operativa que los productos satélite heredan y especializan.
-
-> *Separar conceptualmente antes de separar físicamente.*
-
-
-
----
-
-## Comienza Aqui
-
-
-Puntos de entrada principales
-
-- [Resumen Ejecutivo](./reference/governance/standards/communication/visuals/v01-executive-one-pager.es.md) - explicacion de cinco minutos sobre Evolith, UMS y la propuesta de valor.
-- [Primeros Pasos por Rol](./reference/getting-started/README.es.md) - rutas de lectura recomendadas para ejecutivos, arquitectos, ingenieros, QA, SRE, producto y contribuidores IA.
-- [Vision del Producto](./reference/governance/standards/vision/evolith-product-vision-master.es.md) - direccion estrategica, hoja de ruta y modelo de madurez.
-- [Centro de Gobernanza SDLC](./reference/governance/sdlc/README.es.md) - fases, gates, artefactos y modelo de trazabilidad autoritativos.
-- [Indice Maestro Global](./reference/navigation/MASTER_INDEX.es.md) - navegacion completa del repositorio cuando ya sabes que artefacto necesitas.
-
-
-
-## Navegacion SDLC
-
-Abre la fase en la que estas trabajando. Cada seccion agrupa los documentos, estandares y reglas machine-readable que soportan su gate.
-
-
-Fase 01 - Concepcion y Descubrimiento
-
-- Documentos y plantillas
- - [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.es.md)
- - [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.es.md)
- - [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.es.md)
- - [PRD - Documento de Requerimientos de Producto](./reference/governance/sdlc/04-artifact-templates/prd-template.es.md)
- - [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.es.md)
- - [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.es.md)
- - [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.es.md)
-- Estandares y guia
- - [Directivas Arquitectonicas](./reference/governance/standards/vision/architectural-directives.es.md)
- - [Taxonomia del Repositorio](./reference/governance/standards/repository-taxonomy.es.md)
- - [Baseline Agnostica](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.es.md)
- - [Manifiesto de Ingenieria](./reference/governance/standards/engineering/engineering-manifesto.es.md)
- - [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md)
-- Reglas y schemas
- - [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json)
- - [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json)
- - [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json)
- - [PRD Schema](./rulesets/schema/prd.schema.json)
- - [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json)
- - [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json)
- - [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json)
- - [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json)
-
-
-
-
-Fase 02 - Diseno y Arquitectura
-
-- Documentos y plantillas
- - [Plantilla ADR](./reference/governance/sdlc/04-artifact-templates/adr-template.es.md)
- - [Plantilla de Historia Funcional](./reference/governance/sdlc/04-artifact-templates/functional-story-template.es.md)
- - [Plantilla de Modelo DDD](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.es.md)
-- Estandares y guia
- - [Hub de Arquitectura](./reference/architecture/README.es.md)
- - [Blueprint de Referencia](./reference/architecture/blueprints/reference-blueprint.es.md)
- - [Tech Stack Autoritativo](./reference/architecture/blueprints/authoritative-tech-stack.es.md)
- - [Registro ADR](./reference/architecture/adrs/README.es.md)
- - [Matriz de Decision ADR](./reference/architecture/adrs/adr-matrix.es.md)
- - [Estandar de Escritura de Historias Funcionales](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.es.md)
- - [Buenas Practicas de Documentacion SDLC](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.es.md)
- - [Checklist de Simplicidad Fase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.es.md)
- - [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md)
-- Reglas y schemas
- - [ADR Schema](./rulesets/schema/adr.schema.json)
- - [Functional Story Schema](./rulesets/schema/functional-story.schema.json)
- - [Reglas de Arquitectura](./rulesets/architecture/README.md)
- - [Reglas ADR](./rulesets/adr/README.md)
-
-
-
-
-Fase 03 - Construccion
-
-- Documentos y plantillas
- - [Plantilla de Historia Tecnica](./reference/governance/sdlc/04-artifact-templates/technical-story-template.es.md)
- - [Hub de Plantillas de Artefactos](./reference/governance/sdlc/04-artifact-templates/README.es.md)
-- Estandares y guia
- - [Framework SDLC Enfocado en Construccion](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.es.md)
- - [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.es.md)
- - [Quality Gates SDLC](./reference/governance/sdlc/quality-gates.es.md)
- - [Patrones Canonicos](./reference/architecture/canonical-patterns/README.es.md)
- - [Guia de Contract Testing](./reference/governance/standards/engineering/contract-testing-guideline.es.md)
- - [Evaluacion de Riesgo de Proveedores](./reference/governance/standards/engineering/vendor-risk-assessment.es.md)
- - [Estandares de Ingenieria Augmentada por IA](./reference/governance/standards/ai-augmented/README.es.md)
- - [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md)
-- Reglas y schemas
- - [Technical Story Schema](./rulesets/schema/technical-story.schema.json)
- - [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json)
- - [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json)
- - [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json)
- - [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json)
-
-
-
-
-Fase 04 - Validacion y QA
-
-- Documentos y plantillas
- - [Plantilla de Test Summary Report](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.es.md)
-- Estandares y guia
- - [Quality Gates SDLC](./reference/governance/sdlc/quality-gates.es.md)
- - [Modelo de Trazabilidad SDLC](./reference/governance/sdlc/traceability-model.es.md)
- - [ADR de Testing Pyramid](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.es.md)
- - [ADR de Aislamiento de Unit Testing](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.es.md)
- - [ADR de Integration y E2E Testing](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.es.md)
- - [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md)
-- Reglas y schemas
- - [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json)
- - [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json)
- - [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json)
-
-
-
-
-Fase 05 - Entrega y Operaciones
-
-- Documentos y plantillas
- - [Plantilla de Release Notes](./reference/governance/sdlc/04-artifact-templates/release-notes-template.es.md)
-- Estandares y guia
- - [Hub de Operaciones](./reference/operations/README.es.md)
- - [Hub de Infraestructura](./reference/infrastructure/README.es.md)
- - [Playbook de Observabilidad](./reference/governance/standards/engineering/observability-playbook.es.md)
- - [Flujo de Arquitectura de Observabilidad](./reference/architecture/blueprints/observability-architecture-flow.es.md)
- - [Escenarios de Despliegue Multi-Cloud](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.es.md)
- - [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md)
-- Reglas y schemas
- - [Release Notes Schema](./rulesets/schema/release-notes.schema.json)
- - [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json)
- - [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json)
-
-
+> **Navegación bilingüe:** [English](./README.md)
+
+Evolith define estándares de arquitectura, gobernanza, ADRs, patrones y guías operativas que los productos satélite heredan y especializan.
+
+## Comienza Aquí
+
+- [Resumen Ejecutivo](./reference/governance/standards/communication/visuals/v01-executive-one-pager.es.md)
+- [Primeros Pasos por Rol](./reference/getting-started/README.es.md)
+- [Visión del Producto](./reference/governance/standards/vision/evolith-product-vision-master.es.md)
+- [Centro de Gobernanza SDLC](./reference/governance/sdlc/README.es.md)
+- [Índice Maestro Global](./reference/navigation/MASTER_INDEX.es.md)
+
+## Navegación SDLC
+
+Las seis tablas usan exclusivamente estos tipos y este orden: **Formato, Regla, Estándar, Guía, Decisión, Registro, Matriz, Manifiesto, Referencia, Índice, Lista de Verificación**.
+
+### Fase 01 - Concepción y Descubrimiento
+
+| Tipo | Documento |
+|---|---|
+| Formato | [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.es.md) |
+| Formato | [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.es.md) |
+| Formato | [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.es.md) |
+| Formato | [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.es.md) |
+| Formato | [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.es.md) |
+| Formato | [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.es.md) |
+| Formato | [PRD](./reference/governance/sdlc/04-artifact-templates/prd-template.es.md) |
+| Regla | [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json) |
+| Regla | [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json) |
+| Regla | [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json) |
+| Regla | [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json) |
+| Regla | [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json) |
+| Regla | [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json) |
+| Regla | [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json) |
+| Regla | [PRD Schema](./rulesets/schema/prd.schema.json) |
+| Estándar | [Directivas Arquitectónicas](./reference/governance/standards/vision/architectural-directives.es.md) |
+| Estándar | [Taxonomía del Repositorio](./reference/governance/standards/repository-taxonomy.es.md) |
+| Matriz | [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md) |
+| Manifiesto | [Manifiesto de Ingeniería](./reference/governance/standards/engineering/engineering-manifesto.es.md) |
+| Referencia | [Baseline Agnóstica](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.es.md) |
+
+### Fase 02 - Diseño y Arquitectura
+
+| Tipo | Documento |
+|---|---|
+| Formato | [Plantilla ADR](./reference/governance/sdlc/04-artifact-templates/adr-template.es.md) |
+| Formato | [Plantilla de Historia Funcional](./reference/governance/sdlc/04-artifact-templates/functional-story-template.es.md) |
+| Formato | [Plantilla de Modelo DDD](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.es.md) |
+| Regla | [ADR Schema](./rulesets/schema/adr.schema.json) |
+| Regla | [Functional Story Schema](./rulesets/schema/functional-story.schema.json) |
+| Regla | [Reglas ADR](./rulesets/adr/README.md) |
+| Regla | [Reglas de Arquitectura](./rulesets/architecture/README.md) |
+| Estándar | [Estándar de Historias Funcionales](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.es.md) |
+| Estándar | [Tech Stack Autoritativo](./reference/architecture/blueprints/authoritative-tech-stack.es.md) |
+| Guía | [Buenas Prácticas de Documentación SDLC](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.es.md) |
+| Registro | [Registro ADR](./reference/architecture/adrs/README.es.md) |
+| Matriz | [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md) |
+| Matriz | [Matriz de Decisión ADR](./reference/architecture/adrs/adr-matrix.es.md) |
+| Referencia | [Blueprint de Referencia](./reference/architecture/blueprints/reference-blueprint.es.md) |
+| Índice | [Hub de Arquitectura](./reference/architecture/README.es.md) |
+| Lista de Verificación | [Checklist de Simplicidad Fase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.es.md) |
+
+### Fase 03 - Construcción
+
+| Tipo | Documento |
+|---|---|
+| Formato | [Plantilla de Historia Técnica](./reference/governance/sdlc/04-artifact-templates/technical-story-template.es.md) |
+| Regla | [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json) |
+| Regla | [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json) |
+| Regla | [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json) |
+| Regla | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) |
+| Regla | [Technical Story Schema](./rulesets/schema/technical-story.schema.json) |
+| Estándar | [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.es.md) |
+| Estándar | [Estándares de Ingeniería Aumentada por IA](./reference/governance/standards/ai-augmented/README.es.md) |
+| Estándar | [Quality Gates SDLC](./reference/governance/sdlc/quality-gates.es.md) |
+| Guía | [Evaluación de Riesgo de Proveedores](./reference/governance/standards/engineering/vendor-risk-assessment.es.md) |
+| Guía | [Framework SDLC Enfocado en Construcción](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.es.md) |
+| Guía | [Guía de Contract Testing](./reference/governance/standards/engineering/contract-testing-guideline.es.md) |
+| Matriz | [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md) |
+| Referencia | [Patrones Canónicos](./reference/architecture/canonical-patterns/README.es.md) |
+| Índice | [Hub de Plantillas de Artefactos](./reference/governance/sdlc/04-artifact-templates/README.es.md) |
+
+### Fase 04 - Validación y QA
+
+| Tipo | Documento |
+|---|---|
+| Formato | [Plantilla de Test Summary Report](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.es.md) |
+| Regla | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) |
+| Regla | [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json) |
+| Regla | [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json) |
+| Estándar | [Quality Gates SDLC](./reference/governance/sdlc/quality-gates.es.md) |
+| Decisión | [ADR de Aislamiento de Unit Testing](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.es.md) |
+| Decisión | [ADR de Integration y E2E Testing](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.es.md) |
+| Decisión | [ADR de Testing Pyramid](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.es.md) |
+| Matriz | [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md) |
+| Referencia | [Modelo de Trazabilidad SDLC](./reference/governance/sdlc/traceability-model.es.md) |
+
+### Fase 05 - Entrega y Operaciones
+
+| Tipo | Documento |
+|---|---|
+| Formato | [Plantilla de Release Notes](./reference/governance/sdlc/04-artifact-templates/release-notes-template.es.md) |
+| Regla | [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json) |
+| Regla | [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json) |
+| Regla | [Release Notes Schema](./rulesets/schema/release-notes.schema.json) |
+| Guía | [Playbook de Observabilidad](./reference/governance/standards/engineering/observability-playbook.es.md) |
+| Matriz | [Mapeo de Artefactos SDLC](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.es.md) |
+| Referencia | [Escenarios de Despliegue Multi-Cloud](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.es.md) |
+| Referencia | [Flujo de Arquitectura de Observabilidad](./reference/architecture/blueprints/observability-architecture-flow.es.md) |
+| Índice | [Hub de Infraestructura](./reference/infrastructure/README.es.md) |
+| Índice | [Hub de Operaciones](./reference/operations/README.es.md) |
## Referencias Transversales
-
-Arquitectura, gobernanza y referencia aplicada
-
-- Baseline de arquitectura
- - [Hub de Arquitectura](./reference/architecture/README.es.md)
- - [Blueprints](./reference/architecture/blueprints/README.es.md)
- - [Baseline Agnostica](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.es.md)
- - [Blueprint de Referencia](./reference/architecture/blueprints/reference-blueprint.es.md)
- - [Spec de Topologia C4](./reference/architecture/blueprints/c4-topology-spec.es.md)
-- Decisiones de arquitectura
- - [Registro ADR](./reference/architecture/adrs/README.es.md)
- - [ADRs Core](./reference/architecture/adrs/core/README.es.md)
- - [ADRs Node.js](./reference/architecture/adrs/nodejs/README.es.md)
- - [ADRs .NET](./reference/architecture/adrs/dotnet/README.es.md)
- - [ADRs Android](./reference/architecture/adrs/android/README.es.md)
-- Gobernanza y navegacion
- - [Estandares de Gobernanza](./reference/governance/standards/README.es.md)
- - [Evaluacion de Madurez](./reference/governance/standards/vision/maturity-assessment.es.md) - scoring TOGAF ACMM/WAF, alineacion con la vision y enlaces a gaps abiertos
- - [Tablero de Seguimiento de Gaps](./reference/governance/standards/vision/gap-tracking.es.md) - tablero unico de gaps abiertos (criticidad, complejidad, estado)
- - [Indice Bilingue](./reference/navigation/BILINGUAL_INDEX.es.md)
- - [Hub de Navegacion](./reference/navigation/README.es.md)
- - [Hub de Rulesets](./rulesets/README.es.md)
-- Referencia aplicada
- - [Hub de Referencia UMS](./reference/knowledge/demo/README.es.md)
- - [Modelo de Referencia UMS](./reference/knowledge/demo/ums-reference-model.es.md)
- - [Referencia Canonica vs Modelo Aplicado UMS](./reference/knowledge/demo/demo-vs-reference.es.md)
- - [Portal de Arquitectura UMS](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md)
- - [Casos de Adopcion](./reference/knowledge/adoption-cases.es.md)
-
-
-
-## Herramientas y Automatizacion
-
-
-Smart CLI y hooks de validacion
-
-### Smart CLI (Oficial)
-
-```bash
-# Inicializar nuevo repositorio satélite
-npx @evolith/smart-cli init
-
-# Validar contra estándares Evolith
-smart-cli validate
-
-# Gestionar ADRs
-smart-cli adr create
-smart-cli adr list
-
-# Servidor MCP para asistentes IA
-smart-cli mcp serve
-```
-
-- [Documentacion CLI](./sdk/cli/README.es.md)
+| Tipo | Documento |
+|---|---|
+| Estándar | [Especificación de Topología C4](./reference/architecture/blueprints/c4-topology-spec.es.md) |
+| Estándar | [Estándares de Gobernanza](./reference/governance/standards/README.es.md) |
+| Registro | [Evaluación de Madurez](./reference/governance/standards/vision/maturity-assessment.es.md) |
+| Registro | [Registro ADR](./reference/architecture/adrs/README.es.md) |
+| Registro | [Tablero de Seguimiento de Gaps](./reference/governance/standards/vision/gap-tracking.es.md) |
+| Referencia | [Baseline Agnóstica](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.es.md) |
+| Referencia | [Casos de Adopción](./reference/knowledge/adoption-cases.es.md) |
+| Referencia | [Modelo de Referencia UMS](./reference/knowledge/demo/ums-reference-model.es.md) |
+| Referencia | [Referencia Canónica vs Modelo Aplicado UMS](./reference/knowledge/demo/demo-vs-reference.es.md) |
+| Referencia | [Blueprint de Referencia](./reference/architecture/blueprints/reference-blueprint.es.md) |
+| Índice | [ADRs .NET](./reference/architecture/adrs/dotnet/README.es.md) |
+| Índice | [ADRs Android](./reference/architecture/adrs/android/README.es.md) |
+| Índice | [ADRs Core](./reference/architecture/adrs/core/README.es.md) |
+| Índice | [ADRs Node.js](./reference/architecture/adrs/nodejs/README.es.md) |
+| Índice | [Blueprints](./reference/architecture/blueprints/README.es.md) |
+| Índice | [Hub de Arquitectura](./reference/architecture/README.es.md) |
+| Índice | [Hub de Navegación](./reference/navigation/README.es.md) |
+| Índice | [Hub de Referencia UMS](./reference/knowledge/demo/README.es.md) |
+| Índice | [Hub de Rulesets](./rulesets/README.es.md) |
+| Índice | [Índice Bilingüe](./reference/navigation/BILINGUAL_INDEX.es.md) |
+| Índice | [Portal de Arquitectura UMS](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md) |
+
+## Herramientas y Automatización
+
+- [Documentación CLI](./sdk/cli/README.es.md)
- [Arquitectura CLI](./sdk/cli/ARCHITECTURE.es.md)
-- [Vision del Producto CLI](./sdk/cli/docs/VISION.es.md)
-- [Analisis de Estado](./sdk/cli/docs/planning/sdk-cli-mcp-current-state-assessment.md)
-
-### Pre-commit Hooks
-
-- [validate-docs.mjs](./.harness/scripts/validate-docs.mjs) - validacion de links, anchors, encoding y Mermaid.
-- [check-bilingual-parity.mjs](./.harness/scripts/check-bilingual-parity.mjs) - validacion de paridad estructural EN/ES.
-- [impact-analysis-synchronizer.mjs](./.harness/scripts/impact-analysis-synchronizer.mjs) - sincronizacion de impacto cross-repo.
-
-
+- [Visión del Producto CLI](./sdk/cli/docs/VISION.es.md)
+- [Análisis de Estado](./sdk/cli/docs/planning/sdk-cli-mcp-current-state-assessment.md)
+- [Validador documental](./.harness/scripts/validate-docs.mjs)
+- [Validador de paridad bilingüe](./.harness/scripts/check-bilingual-parity.mjs)
----
+## Contribución
-## Contribucion
-
-Antes de contribuir, lee:
-
-- [AGENTS.md](./AGENTS.md) — Reglas y convenciones de agentes
-- [Taxonomia del Repositorio](./reference/governance/standards/repository-taxonomy.es.md) — Que va donde
-- [Guia de Herencia](./reference/governance/standards/onboarding/child-repository-inheritance-guide.es.md) — Como los productos heredan
+- [AGENTS.md](./AGENTS.md)
+- [Taxonomía del Repositorio](./reference/governance/standards/repository-taxonomy.es.md)
+- [Guía de Herencia](./reference/governance/standards/onboarding/child-repository-inheritance-guide.es.md)
## Licencia
Publicado bajo la [Licencia MIT](./LICENSE).
-
----
-
-
- Evolith - Plataforma de Arquitectura Empresarial | Corpus de Referencia Progresivo | Spec-driven AI-DD
-
diff --git a/README.md b/README.md
index 47708c87..ddf838d4 100644
--- a/README.md
+++ b/README.md
@@ -1,257 +1,158 @@
-
-
# Evolith: Progressive Architecture Reference Base
-> **Bilingual Navigation:** [Versión en Español](./README.es.md)
-
-[]()
-[]()
-[]()
-[](https://github.com/beyondnetcode/evolith_arch32/actions)
-[](./COVERAGE_REPORT.md)
-
-
-
-
-
-
-
-
↑ Evolith E2E Product Vision · MD3 — click to enlarge
-
-
+> **Bilingual navigation:** [Versión en Español](./README.es.md)
-**Evolith is the corporate architecture upstream for product repositories.**
-It defines reusable architecture standards, governance rules, ADRs, patterns,
-and operating guidance that satellite products inherit and specialize.
-
-> *Separate conceptually before separating physically.*
-
-
-
----
+Evolith defines architecture standards, governance, ADRs, patterns, and operational guidance that satellite products inherit and specialize.
## Start Here
-
-Primary entry points
-
-- [Executive One-Pager](./reference/governance/standards/communication/visuals/v01-executive-one-pager.md) - five-minute explanation of Evolith, UMS, and the value proposition.
-- [Getting Started by Role](./reference/getting-started/README.md) - recommended reading paths for executives, architects, engineers, QA, SRE, product, and AI contributors.
-- [Product Vision](./reference/governance/standards/vision/evolith-product-vision-master.md) - strategic direction, roadmap, and maturity model.
-- [SDLC Governance Center](./reference/governance/sdlc/README.md) - authoritative lifecycle phases, gates, artifacts, and traceability model.
-- [Global Master Index](./reference/navigation/MASTER_INDEX.md) - complete repository navigation when you already know what artifact you need.
-
-
+- [Executive One-Pager](./reference/governance/standards/communication/visuals/v01-executive-one-pager.md)
+- [Getting Started by Role](./reference/getting-started/README.md)
+- [Product Vision](./reference/governance/standards/vision/evolith-product-vision-master.md)
+- [SDLC Governance Center](./reference/governance/sdlc/README.md)
+- [Global Master Index](./reference/navigation/MASTER_INDEX.md)
## SDLC Navigation
-Open the phase you are working in. Each section groups the documents, standards, and machine-readable rules that support its gate.
-
-
-Phase 01 - Conception and Discovery
-
-- Documents and templates
- - [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.md)
- - [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.md)
- - [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.md)
- - [PRD - Product Requirements Document](./reference/governance/sdlc/04-artifact-templates/prd-template.md)
- - [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.md)
- - [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.md)
- - [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.md)
-- Standards and guidance
- - [Architectural Directives](./reference/governance/standards/vision/architectural-directives.md)
- - [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md)
- - [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md)
- - [Engineering Manifesto](./reference/governance/standards/engineering/engineering-manifesto.md)
- - [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md)
-- Rules and schemas
- - [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json)
- - [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json)
- - [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json)
- - [PRD Schema](./rulesets/schema/prd.schema.json)
- - [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json)
- - [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json)
- - [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json)
- - [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json)
-
-
-
-
-Phase 02 - Design and Architecture
-
-- Documents and templates
- - [ADR Template](./reference/governance/sdlc/04-artifact-templates/adr-template.md)
- - [Functional Story Template](./reference/governance/sdlc/04-artifact-templates/functional-story-template.md)
- - [DDD Model Template](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.md)
-- Standards and guidance
- - [Architecture Hub](./reference/architecture/README.md)
- - [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md)
- - [Authoritative Tech Stack](./reference/architecture/blueprints/authoritative-tech-stack.md)
- - [ADR Registry](./reference/architecture/adrs/README.md)
- - [ADR Decision Matrix](./reference/architecture/adrs/adr-matrix.md)
- - [Functional Story Writing Standard](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.md)
- - [SDLC Documentation Best Practices](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.md)
- - [Simplicity Checklist Phase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.md)
- - [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md)
-- Rules and schemas
- - [ADR Schema](./rulesets/schema/adr.schema.json)
- - [Functional Story Schema](./rulesets/schema/functional-story.schema.json)
- - [Architecture Rules](./rulesets/architecture/README.md)
- - [ADR Rules](./rulesets/adr/README.md)
-
-
-
-
-Phase 03 - Construction
-
-- Documents and templates
- - [Technical Story Template](./reference/governance/sdlc/04-artifact-templates/technical-story-template.md)
- - [Artifact Templates Hub](./reference/governance/sdlc/04-artifact-templates/README.md)
-- Standards and guidance
- - [Construction-Focused SDLC Framework](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md)
- - [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md)
- - [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md)
- - [Canonical Patterns](./reference/architecture/canonical-patterns/README.md)
- - [Contract Testing Guideline](./reference/governance/standards/engineering/contract-testing-guideline.md)
- - [Vendor Risk Assessment](./reference/governance/standards/engineering/vendor-risk-assessment.md)
- - [AI-Augmented Standards](./reference/governance/standards/ai-augmented/README.md)
- - [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md)
-- Rules and schemas
- - [Technical Story Schema](./rulesets/schema/technical-story.schema.json)
- - [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json)
- - [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json)
- - [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json)
- - [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json)
-
-
-
-
-Phase 04 - Validation and QA
-
-- Documents and templates
- - [Test Summary Report Template](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.md)
-- Standards and guidance
- - [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md)
- - [SDLC Traceability Model](./reference/governance/sdlc/traceability-model.md)
- - [Testing Pyramid ADR](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.md)
- - [Unit Testing Isolation ADR](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.md)
- - [Integration and E2E Testing ADR](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.md)
- - [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md)
-- Rules and schemas
- - [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json)
- - [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json)
- - [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json)
-
-
-
-
-Phase 05 - Delivery and Operations
-
-- Documents and templates
- - [Release Notes Template](./reference/governance/sdlc/04-artifact-templates/release-notes-template.md)
-- Standards and guidance
- - [Operations Hub](./reference/operations/README.md)
- - [Infrastructure Hub](./reference/infrastructure/README.md)
- - [Observability Playbook](./reference/governance/standards/engineering/observability-playbook.md)
- - [Observability Architecture Flow](./reference/architecture/blueprints/observability-architecture-flow.md)
- - [Multi-Cloud Deployment Scenarios](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.md)
- - [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md)
-- Rules and schemas
- - [Release Notes Schema](./rulesets/schema/release-notes.schema.json)
- - [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json)
- - [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json)
-
-
+The six tables exclusively use these exact types and this order: **Formato, Regla, Estándar, Guía, Decisión, Registro, Matriz, Manifiesto, Referencia, Índice, Lista de Verificación**.
+
+### Phase 01 - Conception and Discovery
+
+| Tipo | Document |
+|---|---|
+| Formato | [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.md) |
+| Formato | [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.md) |
+| Formato | [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.md) |
+| Formato | [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.md) |
+| Formato | [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.md) |
+| Formato | [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.md) |
+| Formato | [PRD](./reference/governance/sdlc/04-artifact-templates/prd-template.md) |
+| Regla | [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json) |
+| Regla | [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json) |
+| Regla | [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json) |
+| Regla | [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json) |
+| Regla | [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json) |
+| Regla | [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json) |
+| Regla | [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json) |
+| Regla | [PRD Schema](./rulesets/schema/prd.schema.json) |
+| Estándar | [Architectural Directives](./reference/governance/standards/vision/architectural-directives.md) |
+| Estándar | [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md) |
+| Matriz | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) |
+| Manifiesto | [Engineering Manifesto](./reference/governance/standards/engineering/engineering-manifesto.md) |
+| Referencia | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) |
+
+### Phase 02 - Design and Architecture
+
+| Tipo | Document |
+|---|---|
+| Formato | [ADR Template](./reference/governance/sdlc/04-artifact-templates/adr-template.md) |
+| Formato | [DDD Model Template](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.md) |
+| Formato | [Functional Story Template](./reference/governance/sdlc/04-artifact-templates/functional-story-template.md) |
+| Regla | [ADR Rules](./rulesets/adr/README.md) |
+| Regla | [ADR Schema](./rulesets/schema/adr.schema.json) |
+| Regla | [Architecture Rules](./rulesets/architecture/README.md) |
+| Regla | [Functional Story Schema](./rulesets/schema/functional-story.schema.json) |
+| Estándar | [Authoritative Tech Stack](./reference/architecture/blueprints/authoritative-tech-stack.md) |
+| Estándar | [Functional Story Writing Standard](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.md) |
+| Guía | [SDLC Documentation Best Practices](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.md) |
+| Registro | [ADR Registry](./reference/architecture/adrs/README.md) |
+| Matriz | [ADR Decision Matrix](./reference/architecture/adrs/adr-matrix.md) |
+| Matriz | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) |
+| Referencia | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) |
+| Índice | [Architecture Hub](./reference/architecture/README.md) |
+| Lista de Verificación | [Simplicity Checklist Phase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.md) |
+
+### Phase 03 - Construction
+
+| Tipo | Document |
+|---|---|
+| Formato | [Technical Story Template](./reference/governance/sdlc/04-artifact-templates/technical-story-template.md) |
+| Regla | [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json) |
+| Regla | [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json) |
+| Regla | [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json) |
+| Regla | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) |
+| Regla | [Technical Story Schema](./rulesets/schema/technical-story.schema.json) |
+| Estándar | [AI-Augmented Standards](./reference/governance/standards/ai-augmented/README.md) |
+| Estándar | [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) |
+| Estándar | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) |
+| Guía | [Construction-Focused SDLC Framework](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) |
+| Guía | [Contract Testing Guideline](./reference/governance/standards/engineering/contract-testing-guideline.md) |
+| Guía | [Vendor Risk Assessment](./reference/governance/standards/engineering/vendor-risk-assessment.md) |
+| Matriz | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) |
+| Referencia | [Canonical Patterns](./reference/architecture/canonical-patterns/README.md) |
+| Índice | [Artifact Templates Hub](./reference/governance/sdlc/04-artifact-templates/README.md) |
+
+### Phase 04 - Validation and QA
+
+| Tipo | Document |
+|---|---|
+| Formato | [Test Summary Report Template](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.md) |
+| Regla | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) |
+| Regla | [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json) |
+| Regla | [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json) |
+| Estándar | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) |
+| Decisión | [Integration and E2E Testing ADR](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.md) |
+| Decisión | [Testing Pyramid ADR](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.md) |
+| Decisión | [Unit Testing Isolation ADR](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.md) |
+| Matriz | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) |
+| Referencia | [SDLC Traceability Model](./reference/governance/sdlc/traceability-model.md) |
+
+### Phase 05 - Delivery and Operations
+
+| Tipo | Document |
+|---|---|
+| Formato | [Release Notes Template](./reference/governance/sdlc/04-artifact-templates/release-notes-template.md) |
+| Regla | [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json) |
+| Regla | [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json) |
+| Regla | [Release Notes Schema](./rulesets/schema/release-notes.schema.json) |
+| Guía | [Observability Playbook](./reference/governance/standards/engineering/observability-playbook.md) |
+| Matriz | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) |
+| Referencia | [Multi-Cloud Deployment Scenarios](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.md) |
+| Referencia | [Observability Architecture Flow](./reference/architecture/blueprints/observability-architecture-flow.md) |
+| Índice | [Infrastructure Hub](./reference/infrastructure/README.md) |
+| Índice | [Operations Hub](./reference/operations/README.md) |
## Cross-Cutting References
-
-Architecture, governance, and applied reference
-
-- Architecture baseline
- - [Architecture Hub](./reference/architecture/README.md)
- - [Blueprints](./reference/architecture/blueprints/README.md)
- - [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md)
- - [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md)
- - [C4 Topology Spec](./reference/architecture/blueprints/c4-topology-spec.md)
-- Architecture decisions
- - [ADR Registry](./reference/architecture/adrs/README.md)
- - [Core ADRs](./reference/architecture/adrs/core/README.md)
- - [Node.js ADRs](./reference/architecture/adrs/nodejs/README.md)
- - [.NET ADRs](./reference/architecture/adrs/dotnet/README.md)
- - [Android ADRs](./reference/architecture/adrs/android/README.md)
-- Governance and navigation
- - [Governance Standards](./reference/governance/standards/README.md)
- - [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) - TOGAF ACMM/WAF scoring, vision alignment, and open-gap links
- - [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) - single board for every open gap (criticality, complexity, status)
- - [Bilingual Index](./reference/navigation/BILINGUAL_INDEX.md)
- - [Navigation Hub](./reference/navigation/README.md)
- - [Rulesets Hub](./rulesets/README.md)
-- Applied reference
- - [UMS Reference Hub](./reference/knowledge/demo/README.md)
- - [UMS Reference Model](./reference/knowledge/demo/ums-reference-model.md)
- - [Canonical Reference vs UMS Applied Model](./reference/knowledge/demo/demo-vs-reference.md)
- - [UMS Architecture Portal](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md)
- - [Adoption Cases](./reference/knowledge/adoption-cases.md)
-
-
+| Tipo | Document |
+|---|---|
+| Estándar | [C4 Topology Spec](./reference/architecture/blueprints/c4-topology-spec.md) |
+| Estándar | [Governance Standards](./reference/governance/standards/README.md) |
+| Registro | [ADR Registry](./reference/architecture/adrs/README.md) |
+| Registro | [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) |
+| Registro | [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) |
+| Referencia | [Adoption Cases](./reference/knowledge/adoption-cases.md) |
+| Referencia | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) |
+| Referencia | [Canonical Reference vs UMS Applied Model](./reference/knowledge/demo/demo-vs-reference.md) |
+| Referencia | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) |
+| Referencia | [UMS Reference Model](./reference/knowledge/demo/ums-reference-model.md) |
+| Índice | [.NET ADRs](./reference/architecture/adrs/dotnet/README.md) |
+| Índice | [Android ADRs](./reference/architecture/adrs/android/README.md) |
+| Índice | [Architecture Hub](./reference/architecture/README.md) |
+| Índice | [Bilingual Index](./reference/navigation/BILINGUAL_INDEX.md) |
+| Índice | [Blueprints](./reference/architecture/blueprints/README.md) |
+| Índice | [Core ADRs](./reference/architecture/adrs/core/README.md) |
+| Índice | [Navigation Hub](./reference/navigation/README.md) |
+| Índice | [Node.js ADRs](./reference/architecture/adrs/nodejs/README.md) |
+| Índice | [Rulesets Hub](./rulesets/README.md) |
+| Índice | [UMS Architecture Portal](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md) |
+| Índice | [UMS Reference Hub](./reference/knowledge/demo/README.md) |
## Tools and Automation
-
-Smart CLI and validation hooks
-
-### Smart CLI (Official)
-
-```bash
-# Initialize new satellite repository
-npx @evolith/smart-cli init
-
-# Validate against Evolith standards
-smart-cli validate
-
-# Manage ADRs
-smart-cli adr create
-smart-cli adr list
-
-# MCP server for AI assistants
-smart-cli mcp serve
-```
-
- [CLI Documentation](./sdk/cli/README.md)
- [CLI Architecture](./sdk/cli/ARCHITECTURE.md)
- [CLI Product Vision](./sdk/cli/docs/VISION.md)
-- [Gap Analysis](./sdk/cli/docs/planning/sdk-cli-mcp-current-state-assessment.md)
-
-### Pre-commit Hooks
-
-- [validate-docs.mjs](./.harness/scripts/validate-docs.mjs) - link, anchor, encoding, and Mermaid validation.
-- [check-bilingual-parity.mjs](./.harness/scripts/check-bilingual-parity.mjs) - EN/ES structure parity validation.
-- [impact-analysis-synchronizer.mjs](./.harness/scripts/impact-analysis-synchronizer.mjs) - cross-repository impact synchronization.
-
-
-
----
+- [Current-State Assessment](./sdk/cli/docs/planning/sdk-cli-mcp-current-state-assessment.md)
+- [Documentation Validator](./.harness/scripts/validate-docs.mjs)
+- [Bilingual Parity Validator](./.harness/scripts/check-bilingual-parity.mjs)
## Contribution
-Before contributing, read:
-
-- [AGENTS.md](./AGENTS.md) — Agent rules and conventions
-- [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md) — What goes where
-- [Child Repository Inheritance Guide](./reference/governance/standards/onboarding/child-repository-inheritance-guide.md) — How products inherit
-
----
+- [AGENTS.md](./AGENTS.md)
+- [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md)
+- [Child Repository Inheritance Guide](./reference/governance/standards/onboarding/child-repository-inheritance-guide.md)
## License
Published under the [MIT License](./LICENSE).
-
----
-
-
- Evolith - Enterprise Architecture Platform | Progressive Reference Corpus | Spec-driven AI-DD
-
diff --git a/reference/product-suite/architecture/README.es.md b/reference/product-suite/architecture/README.es.md
index be584410..9a96fcec 100644
--- a/reference/product-suite/architecture/README.es.md
+++ b/reference/product-suite/architecture/README.es.md
@@ -10,9 +10,9 @@ No debe contener principios universales que pertenecen a Evolith Core ni detalle
## Documentos Actuales
-- [Diseño Objetivo de Composición Gobernada](../../../governance/standards/vision/evolith-governed-composition-target-design.es.md)
-- [Modelo de Abstracción de Proveedores y Plugins](../../../governance/standards/vision/evolith-provider-abstraction-plugin-model.es.md) — destino: Core Architecture Principle
-- [Interfaces Técnicas de Tracker](../../../governance/standards/vision/sdlc-tracker-technical-interfaces.es.md) — destino: Tracker Product Design
+- [Diseño Objetivo de Composición Gobernada](../../governance/standards/vision/evolith-governed-composition-target-design.es.md)
+- [Modelo de Abstracción de Proveedores y Plugins](../../governance/standards/vision/evolith-provider-abstraction-plugin-model.es.md) — destino: Core Architecture Principle
+- [Interfaces Técnicas de Tracker](../../governance/standards/vision/sdlc-tracker-technical-interfaces.es.md) — destino: Tracker Product Design
Durante la migración, este índice separa arquitectura de Suite, principios Core e implementación de productos.
diff --git a/reference/product-suite/architecture/README.md b/reference/product-suite/architecture/README.md
index 0d1375ea..7013cae4 100644
--- a/reference/product-suite/architecture/README.md
+++ b/reference/product-suite/architecture/README.md
@@ -10,9 +10,9 @@ It must not contain universal architecture principles that belong in Evolith Cor
## Current Documents
-- [Governed Composition Target Design](../../../governance/standards/vision/evolith-governed-composition-target-design.md)
-- [Provider Abstraction and Plugin Model](../../../governance/standards/vision/evolith-provider-abstraction-plugin-model.md) — migration target: Core Architecture Principle
-- [Tracker Technical Interfaces](../../../governance/standards/vision/sdlc-tracker-technical-interfaces.md) — migration target: Tracker Product Design
+- [Governed Composition Target Design](../../governance/standards/vision/evolith-governed-composition-target-design.md)
+- [Provider Abstraction and Plugin Model](../../governance/standards/vision/evolith-provider-abstraction-plugin-model.md) — migration target: Core Architecture Principle
+- [Tracker Technical Interfaces](../../governance/standards/vision/sdlc-tracker-technical-interfaces.md) — migration target: Tracker Product Design
During migration, this index separates Suite architecture from Core and product implementation.
diff --git a/reference/product-suite/methods/README.es.md b/reference/product-suite/methods/README.es.md
index 11d37fe6..6366b41d 100644
--- a/reference/product-suite/methods/README.es.md
+++ b/reference/product-suite/methods/README.es.md
@@ -8,7 +8,7 @@ Esta área contiene métodos de discovery, validación, investigación, experime
## Documentos Actuales
-- [Workflow de Validación de Producto Asistido por IA](../../../governance/standards/vision/evolith-ai-assisted-validation-workflow.es.md)
+- [Workflow de Validación de Producto Asistido por IA](../../governance/standards/vision/evolith-ai-assisted-validation-workflow.es.md)
Los métodos pueden usar herramientas nombradas como ayudas opcionales, pero deben conservar responsabilidad humana y neutralidad respecto de proveedores.
diff --git a/reference/product-suite/methods/README.md b/reference/product-suite/methods/README.md
index 4ba6a53b..33f7af04 100644
--- a/reference/product-suite/methods/README.md
+++ b/reference/product-suite/methods/README.md
@@ -8,7 +8,7 @@ This area contains portfolio-level discovery, validation, research, experimentat
## Current Documents
-- [AI-Assisted Product Validation Workflow](../../../governance/standards/vision/evolith-ai-assisted-validation-workflow.md)
+- [AI-Assisted Product Validation Workflow](../../governance/standards/vision/evolith-ai-assisted-validation-workflow.md)
Methods may use named tools as optional execution aids, but they must preserve human accountability and provider neutrality.
diff --git a/reference/product-suite/positioning/README.es.md b/reference/product-suite/positioning/README.es.md
index dc403363..0ff97147 100644
--- a/reference/product-suite/positioning/README.es.md
+++ b/reference/product-suite/positioning/README.es.md
@@ -8,7 +8,7 @@ Esta área contiene análisis de mercado, comparaciones competitivas, definició
## Documentos Actuales
-- [Posicionamiento Estratégico y Panorama Comparativo](../../../governance/standards/vision/evolith-strategic-positioning-comparative-landscape.es.md)
+- [Posicionamiento Estratégico y Panorama Comparativo](../../governance/standards/vision/evolith-strategic-positioning-comparative-landscape.es.md)
Durante la migración, el documento fuente permanece en su ruta heredada, pero queda clasificado como posicionamiento de Product Suite.
diff --git a/reference/product-suite/positioning/README.md b/reference/product-suite/positioning/README.md
index fac6809d..467ad48e 100644
--- a/reference/product-suite/positioning/README.md
+++ b/reference/product-suite/positioning/README.md
@@ -8,7 +8,7 @@ This area contains market analysis, competitive comparisons, category definition
## Current Documents
-- [Strategic Positioning and Comparative Landscape](../../../governance/standards/vision/evolith-strategic-positioning-comparative-landscape.md)
+- [Strategic Positioning and Comparative Landscape](../../governance/standards/vision/evolith-strategic-positioning-comparative-landscape.md)
During migration, the source document remains in its legacy path but is classified as Product Suite positioning.
diff --git a/reference/product-suite/strategy/README.es.md b/reference/product-suite/strategy/README.es.md
index 6353c5e1..85ce0208 100644
--- a/reference/product-suite/strategy/README.es.md
+++ b/reference/product-suite/strategy/README.es.md
@@ -8,9 +8,9 @@ Esta área contiene estrategia de portafolio, modelo de negocio, dirección Open
## Documentos Actuales
-- [Framework Estratégico de Validación y Composición](../../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.es.md)
-- [Workflow de Validación de Producto Asistido por IA](../../../governance/standards/vision/evolith-ai-assisted-validation-workflow.es.md)
-- [Roadmap de Estrategia Evolutiva](../../../governance/standards/vision/evolutionary-strategy-roadmap.es.md)
+- [Framework Estratégico de Validación y Composición](../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.es.md)
+- [Workflow de Validación de Producto Asistido por IA](../../governance/standards/vision/evolith-ai-assisted-validation-workflow.es.md)
+- [Roadmap de Estrategia Evolutiva](../../governance/standards/vision/evolutionary-strategy-roadmap.es.md)
Durante la migración, los archivos permanecen en rutas heredadas, pero quedan clasificados como estrategia de Product Suite.
diff --git a/reference/product-suite/strategy/README.md b/reference/product-suite/strategy/README.md
index baad788d..ca00c1ab 100644
--- a/reference/product-suite/strategy/README.md
+++ b/reference/product-suite/strategy/README.md
@@ -8,9 +8,9 @@ This area contains portfolio strategy, business model, Open-Core direction, comp
## Current Documents
-- [Strategic Validation and Composition Framework](../../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.md)
-- [AI-Assisted Product Validation Workflow](../../../governance/standards/vision/evolith-ai-assisted-validation-workflow.md)
-- [Evolutionary Strategy Roadmap](../../../governance/standards/vision/evolutionary-strategy-roadmap.md)
+- [Strategic Validation and Composition Framework](../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.md)
+- [AI-Assisted Product Validation Workflow](../../governance/standards/vision/evolith-ai-assisted-validation-workflow.md)
+- [Evolutionary Strategy Roadmap](../../governance/standards/vision/evolutionary-strategy-roadmap.md)
The files remain at legacy locations during migration but are classified as Product Suite strategy.
diff --git a/reference/product-suite/vision/README.es.md b/reference/product-suite/vision/README.es.md
index 6c8689d5..7e926e93 100644
--- a/reference/product-suite/vision/README.es.md
+++ b/reference/product-suite/vision/README.es.md
@@ -9,9 +9,9 @@ Esta área contiene la visión de portafolio de Evolith Product Suite. Explica q
## Documentos Canónicos Actuales
-- [Visión Maestra del Producto Evolith](../../../governance/standards/vision/evolith-product-vision-master.es.md)
-- [Framework Estratégico de Validación y Composición](../../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.es.md)
-- [Diseño Objetivo de Composición Gobernada](../../../governance/standards/vision/evolith-governed-composition-target-design.es.md)
+- [Visión Maestra del Producto Evolith](../../governance/standards/vision/evolith-product-vision-master.es.md)
+- [Framework Estratégico de Validación y Composición](../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.es.md)
+- [Diseño Objetivo de Composición Gobernada](../../governance/standards/vision/evolith-governed-composition-target-design.es.md)
> Durante la migración de compatibilidad, los archivos enlazados permanecen en sus ubicaciones heredadas. Su clasificación actual es Product Suite, no Evolith Core.
diff --git a/reference/product-suite/vision/README.md b/reference/product-suite/vision/README.md
index fbe92bf2..c6a92384 100644
--- a/reference/product-suite/vision/README.md
+++ b/reference/product-suite/vision/README.md
@@ -9,9 +9,9 @@ This area contains the portfolio-level vision of the Evolith Product Suite. It e
## Current Canonical Documents
-- [Evolith Product Vision Master](../../../governance/standards/vision/evolith-product-vision-master.md)
-- [Strategic Validation and Composition Framework](../../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.md)
-- [Governed Composition Target Design](../../../governance/standards/vision/evolith-governed-composition-target-design.md)
+- [Evolith Product Vision Master](../../governance/standards/vision/evolith-product-vision-master.md)
+- [Strategic Validation and Composition Framework](../../governance/standards/vision/evolith-strategic-validation-and-composition-framework.md)
+- [Governed Composition Target Design](../../governance/standards/vision/evolith-governed-composition-target-design.md)
> The linked files remain in legacy locations during the compatibility migration. Their classification is now Product Suite, not Evolith Core.