From e617331b38001d800604dc39f6bb5b4b0fca03c4 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:15:45 -0500 Subject: [PATCH 01/16] docs(readme): classify and group document tables by type --- README.md | 217 ++++++++++++++++++++++++++---------------------------- 1 file changed, 105 insertions(+), 112 deletions(-) diff --git a/README.md b/README.md index 47708c87..392d5b44 100644 --- a/README.md +++ b/README.md @@ -48,121 +48,116 @@ and operating guidance that satellite products inherit and specialize. ## SDLC Navigation -Open the phase you are working in. Each section groups the documents, standards, and machine-readable rules that support its gate. +Open the phase you are working in. Each table is grouped in the following strict type order: **Format, Rule, Standard, Guide, Decision, Record, Matrix, Manifest, Reference, Index, Checklist**.
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) +| Type | Document | +|---|---| +| Format | [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.md) | +| Format | [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.md) | +| Format | [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.md) | +| Format | [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.md) | +| Format | [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.md) | +| Format | [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.md) | +| Format | [PRD - Product Requirements Document](./reference/governance/sdlc/04-artifact-templates/prd-template.md) | +| Rule | [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json) | +| Rule | [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json) | +| Rule | [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json) | +| Rule | [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json) | +| Rule | [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json) | +| Rule | [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json) | +| Rule | [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json) | +| Rule | [PRD Schema](./rulesets/schema/prd.schema.json) | +| Standard | [Architectural Directives](./reference/governance/standards/vision/architectural-directives.md) | +| Standard | [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md) | +| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | +| Manifest | [Engineering Manifesto](./reference/governance/standards/engineering/engineering-manifesto.md) | +| Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) |
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) +| Type | Document | +|---|---| +| Format | [ADR Template](./reference/governance/sdlc/04-artifact-templates/adr-template.md) | +| Format | [DDD Model Template](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.md) | +| Format | [Functional Story Template](./reference/governance/sdlc/04-artifact-templates/functional-story-template.md) | +| Rule | [ADR Rules](./rulesets/adr/README.md) | +| Rule | [ADR Schema](./rulesets/schema/adr.schema.json) | +| Rule | [Architecture Rules](./rulesets/architecture/README.md) | +| Rule | [Functional Story Schema](./rulesets/schema/functional-story.schema.json) | +| Standard | [Authoritative Tech Stack](./reference/architecture/blueprints/authoritative-tech-stack.md) | +| Standard | [Functional Story Writing Standard](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.md) | +| Guide | [SDLC Documentation Best Practices](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.md) | +| Record | [ADR Registry](./reference/architecture/adrs/README.md) | +| Matrix | [ADR Decision Matrix](./reference/architecture/adrs/adr-matrix.md) | +| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | +| Reference | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) | +| Index | [Architecture Hub](./reference/architecture/README.md) | +| Checklist | [Simplicity Checklist Phase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.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) +| Type | Document | +|---|---| +| Format | [Technical Story Template](./reference/governance/sdlc/04-artifact-templates/technical-story-template.md) | +| Rule | [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json) | +| Rule | [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json) | +| Rule | [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json) | +| Rule | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) | +| Rule | [Technical Story Schema](./rulesets/schema/technical-story.schema.json) | +| Standard | [AI-Augmented Standards](./reference/governance/standards/ai-augmented/README.md) | +| Standard | [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) | +| Standard | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) | +| Guide | [Construction-Focused SDLC Framework](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) | +| Guide | [Contract Testing Guideline](./reference/governance/standards/engineering/contract-testing-guideline.md) | +| Guide | [Vendor Risk Assessment](./reference/governance/standards/engineering/vendor-risk-assessment.md) | +| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | +| Reference | [Canonical Patterns](./reference/architecture/canonical-patterns/README.md) | +| Index | [Artifact Templates Hub](./reference/governance/sdlc/04-artifact-templates/README.md) |
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) +| Type | Document | +|---|---| +| Format | [Test Summary Report Template](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.md) | +| Rule | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) | +| Rule | [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json) | +| Rule | [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json) | +| Standard | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) | +| Decision | [Integration and E2E Testing ADR](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.md) | +| Decision | [Testing Pyramid ADR](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.md) | +| Decision | [Unit Testing Isolation ADR](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.md) | +| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | +| Reference | [SDLC Traceability Model](./reference/governance/sdlc/traceability-model.md) |
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) +| Type | Document | +|---|---| +| Format | [Release Notes Template](./reference/governance/sdlc/04-artifact-templates/release-notes-template.md) | +| Rule | [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json) | +| Rule | [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json) | +| Rule | [Release Notes Schema](./rulesets/schema/release-notes.schema.json) | +| Guide | [Observability Playbook](./reference/governance/standards/engineering/observability-playbook.md) | +| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | +| Reference | [Multi-Cloud Deployment Scenarios](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.md) | +| Reference | [Observability Architecture Flow](./reference/architecture/blueprints/observability-architecture-flow.md) | +| Index | [Infrastructure Hub](./reference/infrastructure/README.md) | +| Index | [Operations Hub](./reference/operations/README.md) |
@@ -171,31 +166,29 @@ Open the phase you are working in. Each section groups the documents, standards,
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) +| Type | Document | +|---|---| +| Standard | [C4 Topology Spec](./reference/architecture/blueprints/c4-topology-spec.md) | +| Standard | [Governance Standards](./reference/governance/standards/README.md) | +| Record | [ADR Registry](./reference/architecture/adrs/README.md) | +| Record | [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) — single board for every open gap | +| Record | [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) — TOGAF ACMM/WAF scoring and vision alignment | +| Reference | [Adoption Cases](./reference/knowledge/adoption-cases.md) | +| Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) | +| Reference | [Canonical Reference vs UMS Applied Model](./reference/knowledge/demo/demo-vs-reference.md) | +| Reference | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) | +| Reference | [UMS Reference Model](./reference/knowledge/demo/ums-reference-model.md) | +| Index | [.NET ADRs](./reference/architecture/adrs/dotnet/README.md) | +| Index | [Android ADRs](./reference/architecture/adrs/android/README.md) | +| Index | [Architecture Hub](./reference/architecture/README.md) | +| Index | [Bilingual Index](./reference/navigation/BILINGUAL_INDEX.md) | +| Index | [Blueprints](./reference/architecture/blueprints/README.md) | +| Index | [Core ADRs](./reference/architecture/adrs/core/README.md) | +| Index | [Navigation Hub](./reference/navigation/README.md) | +| Index | [Node.js ADRs](./reference/architecture/adrs/nodejs/README.md) | +| Index | [Rulesets Hub](./rulesets/README.md) | +| Index | [UMS Architecture Portal](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md) | +| Index | [UMS Reference Hub](./reference/knowledge/demo/README.md) |
From d66597038b6cd7fd555833bc39bc6fc1bb24e1c1 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:17:53 -0500 Subject: [PATCH 02/16] docs(readme): clasificar tablas documentales por tipo --- README.es.md | 389 +++++++++++++++++++-------------------------------- 1 file changed, 146 insertions(+), 243 deletions(-) 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) - -[![Status](https://img.shields.io/badge/Status-Activo-brightgreen?style=for-the-badge)]() -[![Method](https://img.shields.io/badge/Method-Spec--driven_AI--DD-blueviolet?style=for-the-badge)]() -[![License](https://img.shields.io/badge/License-MIT-informational?style=for-the-badge)]() -[![CI](https://img.shields.io/github/actions/workflow/status/beyondnetcode/evolith_arch32/docs.yml?style=for-the-badge&label=CI)](https://github.com/beyondnetcode/evolith_arch32/actions) -[![Coverage](https://img.shields.io/badge/Docs-100%25-brightgreen?style=for-the-badge)](./COVERAGE_REPORT.md) - -
- - - Visión General del Producto Evolith E2E - - -↑ 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 -
From bdd4166d6ff086282a629ad878f05afc92efe5e6 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:20:43 -0500 Subject: [PATCH 03/16] docs(readme): align bilingual typed document tables --- README.md | 136 +++++++++--------------------------------------------- 1 file changed, 22 insertions(+), 114 deletions(-) diff --git a/README.md b/README.md index 392d5b44..00282e8d 100644 --- a/README.md +++ b/README.md @@ -1,57 +1,22 @@ -
- # Evolith: Progressive Architecture Reference Base -> **Bilingual Navigation:** [Versión en Español](./README.es.md) - -[![Status](https://img.shields.io/badge/Status-Active-brightgreen?style=for-the-badge)]() -[![Method](https://img.shields.io/badge/Method-Spec--driven_AI--DD-blueviolet?style=for-the-badge)]() -[![License](https://img.shields.io/badge/License-MIT-informational?style=for-the-badge)]() -[![CI](https://img.shields.io/github/actions/workflow/status/beyondnetcode/evolith_arch32/docs.yml?style=for-the-badge&label=CI)](https://github.com/beyondnetcode/evolith_arch32/actions) -[![Coverage](https://img.shields.io/badge/Docs-100%25-brightgreen?style=for-the-badge)](./COVERAGE_REPORT.md) - -
- - - Evolith E2E Product Vision - - -↑ Evolith E2E Product Vision · MD3 — click to enlarge - -
- -**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.* +> **Bilingual navigation:** [Versión en Español](./README.es.md) -
- ---- +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 table is grouped in the following strict type order: **Format, Rule, Standard, Guide, Decision, Record, Matrix, Manifest, Reference, Index, Checklist**. +The six tables exclusively use these types and this order: **Format, Rule, Standard, Guide, Decision, Record, Matrix, Manifest, Reference, Index, Checklist**. -
-Phase 01 - Conception and Discovery +### Phase 01 - Conception and Discovery | Type | Document | |---|---| @@ -61,7 +26,7 @@ Open the phase you are working in. Each table is grouped in the following strict | Format | [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.md) | | Format | [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.md) | | Format | [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.md) | -| Format | [PRD - Product Requirements Document](./reference/governance/sdlc/04-artifact-templates/prd-template.md) | +| Format | [PRD](./reference/governance/sdlc/04-artifact-templates/prd-template.md) | | Rule | [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json) | | Rule | [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json) | | Rule | [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json) | @@ -76,10 +41,7 @@ Open the phase you are working in. Each table is grouped in the following strict | Manifest | [Engineering Manifesto](./reference/governance/standards/engineering/engineering-manifesto.md) | | Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) | -
- -
-Phase 02 - Design and Architecture +### Phase 02 - Design and Architecture | Type | Document | |---|---| @@ -100,10 +62,7 @@ Open the phase you are working in. Each table is grouped in the following strict | Index | [Architecture Hub](./reference/architecture/README.md) | | Checklist | [Simplicity Checklist Phase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.md) | -
- -
-Phase 03 - Construction +### Phase 03 - Construction | Type | Document | |---|---| @@ -123,10 +82,7 @@ Open the phase you are working in. Each table is grouped in the following strict | Reference | [Canonical Patterns](./reference/architecture/canonical-patterns/README.md) | | Index | [Artifact Templates Hub](./reference/governance/sdlc/04-artifact-templates/README.md) | -
- -
-Phase 04 - Validation and QA +### Phase 04 - Validation and QA | Type | Document | |---|---| @@ -141,10 +97,7 @@ Open the phase you are working in. Each table is grouped in the following strict | Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | | Reference | [SDLC Traceability Model](./reference/governance/sdlc/traceability-model.md) | -
- -
-Phase 05 - Delivery and Operations +### Phase 05 - Delivery and Operations | Type | Document | |---|---| @@ -159,20 +112,15 @@ Open the phase you are working in. Each table is grouped in the following strict | Index | [Infrastructure Hub](./reference/infrastructure/README.md) | | Index | [Operations Hub](./reference/operations/README.md) | -
- ## Cross-Cutting References -
-Architecture, governance, and applied reference - | Type | Document | |---|---| | Standard | [C4 Topology Spec](./reference/architecture/blueprints/c4-topology-spec.md) | | Standard | [Governance Standards](./reference/governance/standards/README.md) | | Record | [ADR Registry](./reference/architecture/adrs/README.md) | -| Record | [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) — single board for every open gap | -| Record | [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) — TOGAF ACMM/WAF scoring and vision alignment | +| Record | [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) | +| Record | [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) | | Reference | [Adoption Cases](./reference/knowledge/adoption-cases.md) | | Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) | | Reference | [Canonical Reference vs UMS Applied Model](./reference/knowledge/demo/demo-vs-reference.md) | @@ -190,61 +138,21 @@ Open the phase you are working in. Each table is grouped in the following strict | Index | [UMS Architecture Portal](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md) | | Index | [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 -
From e3d897118214a8167a000d36f0a40f852b2dcc07 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:24:19 -0500 Subject: [PATCH 04/16] docs(readme): enforce exact document type taxonomy --- README.md | 198 +++++++++++++++++++++++++++--------------------------- 1 file changed, 99 insertions(+), 99 deletions(-) diff --git a/README.md b/README.md index 00282e8d..ddf838d4 100644 --- a/README.md +++ b/README.md @@ -14,129 +14,129 @@ Evolith defines architecture standards, governance, ADRs, patterns, and operatio ## SDLC Navigation -The six tables exclusively use these types and this order: **Format, Rule, Standard, Guide, Decision, Record, Matrix, Manifest, Reference, Index, Checklist**. +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 -| Type | Document | +| Tipo | Document | |---|---| -| Format | [Agile Backlog](./reference/governance/sdlc/04-artifact-templates/agile-backlog-template.md) | -| Format | [Ballpark Estimation](./reference/governance/sdlc/04-artifact-templates/ballpark-estimation-template.md) | -| Format | [Business Case ROI](./reference/governance/sdlc/04-artifact-templates/business-case-roi-template.md) | -| Format | [CLI Impact Analysis](./reference/governance/sdlc/04-artifact-templates/cli-impact-analysis.md) | -| Format | [Discovery Canvas](./reference/governance/sdlc/04-artifact-templates/discovery-canvas-template.md) | -| Format | [Evolith User Story](./reference/governance/sdlc/04-artifact-templates/evolith-user-story-template.md) | -| Format | [PRD](./reference/governance/sdlc/04-artifact-templates/prd-template.md) | -| Rule | [Agile Backlog Schema](./rulesets/schema/agile-backlog.schema.json) | -| Rule | [Ballpark Estimation Schema](./rulesets/schema/ballpark-estimation.schema.json) | -| Rule | [Business Case ROI Schema](./rulesets/schema/business-case-roi.schema.json) | -| Rule | [CLI Impact Analysis Schema](./rulesets/schema/cli-impact-analysis.schema.json) | -| Rule | [Discovery Canvas Schema](./rulesets/schema/discovery-canvas.schema.json) | -| Rule | [Evolith User Story Schema](./rulesets/schema/evolith-user-story.schema.json) | -| Rule | [Phase Gates Rules](./rulesets/sdlc/phase-gates.rules.json) | -| Rule | [PRD Schema](./rulesets/schema/prd.schema.json) | -| Standard | [Architectural Directives](./reference/governance/standards/vision/architectural-directives.md) | -| Standard | [Repository Taxonomy](./reference/governance/standards/repository-taxonomy.md) | -| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | -| Manifest | [Engineering Manifesto](./reference/governance/standards/engineering/engineering-manifesto.md) | -| Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) | +| 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 -| Type | Document | +| Tipo | Document | |---|---| -| Format | [ADR Template](./reference/governance/sdlc/04-artifact-templates/adr-template.md) | -| Format | [DDD Model Template](./reference/governance/sdlc/04-artifact-templates/ddd-model-template.md) | -| Format | [Functional Story Template](./reference/governance/sdlc/04-artifact-templates/functional-story-template.md) | -| Rule | [ADR Rules](./rulesets/adr/README.md) | -| Rule | [ADR Schema](./rulesets/schema/adr.schema.json) | -| Rule | [Architecture Rules](./rulesets/architecture/README.md) | -| Rule | [Functional Story Schema](./rulesets/schema/functional-story.schema.json) | -| Standard | [Authoritative Tech Stack](./reference/architecture/blueprints/authoritative-tech-stack.md) | -| Standard | [Functional Story Writing Standard](./reference/governance/sdlc/03-documentation/functional-story-writing-standard.md) | -| Guide | [SDLC Documentation Best Practices](./reference/governance/sdlc/03-documentation/sdlc-documentation-best-practices.md) | -| Record | [ADR Registry](./reference/architecture/adrs/README.md) | -| Matrix | [ADR Decision Matrix](./reference/architecture/adrs/adr-matrix.md) | -| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | -| Reference | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) | -| Index | [Architecture Hub](./reference/architecture/README.md) | -| Checklist | [Simplicity Checklist Phase 1](./reference/architecture/blueprints/simplicity-checklist-phase-01.md) | +| 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 -| Type | Document | +| Tipo | Document | |---|---| -| Format | [Technical Story Template](./reference/governance/sdlc/04-artifact-templates/technical-story-template.md) | -| Rule | [Definition of Done Rules](./rulesets/cross-cutting/definition-of-done.rules.json) | -| Rule | [Dependency Pinning Rules](./rulesets/sdlc/dependency-pinning.rules.json) | -| Rule | [Engineering Manifesto Rules](./rulesets/cross-cutting/engineering-manifesto.rules.json) | -| Rule | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) | -| Rule | [Technical Story Schema](./rulesets/schema/technical-story.schema.json) | -| Standard | [AI-Augmented Standards](./reference/governance/standards/ai-augmented/README.md) | -| Standard | [Definition of Done](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) | -| Standard | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) | -| Guide | [Construction-Focused SDLC Framework](./reference/governance/sdlc/02-engineering/construction-focused-sdlc-framework.md) | -| Guide | [Contract Testing Guideline](./reference/governance/standards/engineering/contract-testing-guideline.md) | -| Guide | [Vendor Risk Assessment](./reference/governance/standards/engineering/vendor-risk-assessment.md) | -| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | -| Reference | [Canonical Patterns](./reference/architecture/canonical-patterns/README.md) | -| Index | [Artifact Templates Hub](./reference/governance/sdlc/04-artifact-templates/README.md) | +| 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 -| Type | Document | +| Tipo | Document | |---|---| -| Format | [Test Summary Report Template](./reference/governance/sdlc/04-artifact-templates/test-summary-report-template.md) | -| Rule | [Quality Thresholds Rules](./rulesets/sdlc/quality-thresholds.rules.json) | -| Rule | [Test Summary Report Schema](./rulesets/schema/test-summary-report.schema.json) | -| Rule | [Testing Pyramid Rules](./rulesets/adr/adr-0018-testing-pyramid.rules.json) | -| Standard | [SDLC Quality Gates](./reference/governance/sdlc/quality-gates.md) | -| Decision | [Integration and E2E Testing ADR](./reference/architecture/adrs/core/0053-integration-e2e-testing-strategy.md) | -| Decision | [Testing Pyramid ADR](./reference/architecture/adrs/core/0018-testing-pyramid-quality-gates.md) | -| Decision | [Unit Testing Isolation ADR](./reference/architecture/adrs/core/0052-unit-testing-isolation-strategy.md) | -| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | -| Reference | [SDLC Traceability Model](./reference/governance/sdlc/traceability-model.md) | +| 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 -| Type | Document | +| Tipo | Document | |---|---| -| Format | [Release Notes Template](./reference/governance/sdlc/04-artifact-templates/release-notes-template.md) | -| Rule | [CI/CD Quality Gates Rules](./rulesets/adr/adr-0005-cicd-quality-gates.rules.json) | -| Rule | [GitFlow Branching Rules](./rulesets/adr/adr-0050-gitflow-branching.rules.json) | -| Rule | [Release Notes Schema](./rulesets/schema/release-notes.schema.json) | -| Guide | [Observability Playbook](./reference/governance/standards/engineering/observability-playbook.md) | -| Matrix | [SDLC Artifact Mapping](./reference/governance/sdlc/sdlc-evolith-artifact-mapping.md) | -| Reference | [Multi-Cloud Deployment Scenarios](./reference/architecture/blueprints/multi-cloud-deployment-scenarios.md) | -| Reference | [Observability Architecture Flow](./reference/architecture/blueprints/observability-architecture-flow.md) | -| Index | [Infrastructure Hub](./reference/infrastructure/README.md) | -| Index | [Operations Hub](./reference/operations/README.md) | +| 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 -| Type | Document | +| Tipo | Document | |---|---| -| Standard | [C4 Topology Spec](./reference/architecture/blueprints/c4-topology-spec.md) | -| Standard | [Governance Standards](./reference/governance/standards/README.md) | -| Record | [ADR Registry](./reference/architecture/adrs/README.md) | -| Record | [Gap Tracking Board](./reference/governance/standards/vision/gap-tracking.md) | -| Record | [Maturity Assessment](./reference/governance/standards/vision/maturity-assessment.md) | -| Reference | [Adoption Cases](./reference/knowledge/adoption-cases.md) | -| Reference | [Agnostic Baseline](./reference/architecture/blueprints/authoritative-tech-stack-agnostic.md) | -| Reference | [Canonical Reference vs UMS Applied Model](./reference/knowledge/demo/demo-vs-reference.md) | -| Reference | [Reference Blueprint](./reference/architecture/blueprints/reference-blueprint.md) | -| Reference | [UMS Reference Model](./reference/knowledge/demo/ums-reference-model.md) | -| Index | [.NET ADRs](./reference/architecture/adrs/dotnet/README.md) | -| Index | [Android ADRs](./reference/architecture/adrs/android/README.md) | -| Index | [Architecture Hub](./reference/architecture/README.md) | -| Index | [Bilingual Index](./reference/navigation/BILINGUAL_INDEX.md) | -| Index | [Blueprints](./reference/architecture/blueprints/README.md) | -| Index | [Core ADRs](./reference/architecture/adrs/core/README.md) | -| Index | [Navigation Hub](./reference/navigation/README.md) | -| Index | [Node.js ADRs](./reference/architecture/adrs/nodejs/README.md) | -| Index | [Rulesets Hub](./rulesets/README.md) | -| Index | [UMS Architecture Portal](https://github.com/beyondnetcode/ums/blob/main/docs/architecture/index.md) | -| Index | [UMS Reference Hub](./reference/knowledge/demo/README.md) | +| 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 From b6672613e5e220527236d6a28482e827bb1f5338 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:43:23 -0500 Subject: [PATCH 05/16] fix(validation): allow tracked package lock in repository root --- .harness/scripts/validate-root-cleanliness.mjs | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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. From d8db25e182049097609d4464acaaea4649e23e56 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:45:59 -0500 Subject: [PATCH 06/16] ci(docs): upload validation diagnostics on failure --- .github/workflows/docs.yml | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) 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 From eb2a77eecc25f3b3d70a72f434bfd3869fef2c52 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:50:48 -0500 Subject: [PATCH 07/16] fix(docs): correct Product Suite architecture links --- reference/product-suite/architecture/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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. From ffcfe771c0e43ffde9891715134b08ffbe806c50 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:52:00 -0500 Subject: [PATCH 08/16] fix(docs): corregir enlaces de arquitectura de Product Suite --- reference/product-suite/architecture/README.es.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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. From 4b1b04b544394db7a58b500172f26fffd5f637ce Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:55:12 -0500 Subject: [PATCH 09/16] fix(docs): correct Product Suite methods links --- reference/product-suite/methods/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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. From 5c5728e6859b9edff224ca0a9be416dfff4f320d Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 18:56:24 -0500 Subject: [PATCH 10/16] =?UTF-8?q?fix(docs):=20corregir=20enlaces=20de=20m?= =?UTF-8?q?=C3=A9todos=20de=20Product=20Suite?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/product-suite/methods/README.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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. From 82706b59112cd02f58e80912eea013a2b0b46119 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 22:49:08 -0500 Subject: [PATCH 11/16] fix(docs): correct Product Suite positioning links --- reference/product-suite/positioning/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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. From 26d5914d52d29bbbce74664b9d06ba9465713452 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 22:52:24 -0500 Subject: [PATCH 12/16] fix(docs): corregir enlaces de posicionamiento de Product Suite --- reference/product-suite/positioning/README.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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. From 08bfed699516b29e1b09c31208b8d034581ad1a0 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 22:55:22 -0500 Subject: [PATCH 13/16] fix(docs): correct Product Suite strategy links --- reference/product-suite/strategy/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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. From 7a4f04b2c1dd67bf4e6265d485299e8fb320cbc9 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 23:00:19 -0500 Subject: [PATCH 14/16] fix(docs): corregir enlaces de estrategia de Product Suite --- reference/product-suite/strategy/README.es.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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. From 210cb61b490c43c2f4ac3b7291334ce6a0ae49a1 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 23:01:58 -0500 Subject: [PATCH 15/16] fix(docs): correct Product Suite vision links --- reference/product-suite/vision/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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. From 7a3fa3b8cf97dad571c5432351841ec5d0b6cac2 Mon Sep 17 00:00:00 2001 From: Alberto Arroyo Raygada Date: Wed, 10 Jun 2026 23:03:52 -0500 Subject: [PATCH 16/16] =?UTF-8?q?fix(docs):=20corregir=20enlaces=20de=20vi?= =?UTF-8?q?si=C3=B3n=20de=20Product=20Suite?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/product-suite/vision/README.es.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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.