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) - -[![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 -
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) - -[![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 - -
+> **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.