docs: perform comprehensive localization and synchronization of architecture, governance, and operational documentation

Author: beyondnetPeru

.bmad-core/rules/structuring-standard.md

@@ -256,7 +256,7 @@ libs/
 |-- shared-utils/           # Pure functions, validators, formatters
 |-- domain-types/           # TypeScript types mirroring C# DTOs
 |-- api-client/             # Axios/HTTP client wrappers
-|-- test-utils/             # Testá helpers, mocks, fixtures
+|-- test-utils/             # Test helpers, mocks, fixtures
 +-- config/                 # Runtime config readers, feature flags
 ```
 
@@ -344,11 +344,11 @@ docs/
 
 | Type | Location | Prefix | Status Tracking |
 |---|---|---|---|
-| Product/Requirements | `docs/*/00-product/`, `docs/*/01-requirements/` | `fs-NN-` | Phase-based |
-| Architecture Specs | `docs/*/02-architecture/` | `te-NN-` | Phase-based |
-| ADRs | `docs/*/03-adrs/` | `NNNN-` | Index with status table |
-| Artifacts | `docs/*/04-artifacts/` | (none) | Versioned |
-| Roadmap | `docs/*/05-roadmap/` | (none) | Versioned | ### 5.3 ADR Format
+| Product/Requirements | `docs/*/product/`, `docs/*/requirements/` | `fs-NN-` | Phase-based |
+| Architecture Specs | `docs/*/architecture/` | `te-NN-` | Phase-based |
+| ADRs | `docs/*/adrs/` | `NNNN-` | Index with status table |
+| Artifacts | `docs/*/artifacts/` | (none) | Versioned |
+| Roadmap | `docs/*/roadmap/` | (none) | Versioned | ### 5.3 ADR Format
 
 Every ADR MUST follow this template:
 
@@ -413,7 +413,7 @@ POCs must NOT be referenced by any production code. POCs must NOT be deployed.
 | `<repo-root>/` | `MASTER_INDEX.md` | Cross-reference of all major directories, docs phases, apps |
 | `docs/en/`, `docs/es/` | `index.md` | Phase overview with links to each subdirectory |
 | `docs/*/NN-<phase>/` | `index.md` | List of documents in phase with descriptions |
-| `docs/*/03-adrs/` | `index.md` | ADR log with status table (number, title, status, date) |
+| `docs/*/adrs/` | `index.md` | ADR log with status table (number, title, status, date) |
 | `docs/*/NN-<phase>/<subcategory>/` | `index.md` | List of items (e.g., functional stories index) |
 | `src/<workspace>/` | `README.md` | Workspace overview, build commands, architecture diagram |
 | `src/<workspace>/apps/<app>/` | `README.md` | App-specific description, run instructions |
@@ -430,7 +430,7 @@ Every README MUST contain:
 
 - All links MUST be relative (never absolute `/`) to support fork/mirror portability
 - Links to `docs/` from code MUST go through `docs/en/` or `docs/es/`
-- ADRs MUST be referenced by number: `[ADR-0041](docs/en/03-adrs/0041-bounded-context-split.md)`
+- ADRs MUST be referenced by number: `[ADR-0041](docs/en/adrs/0041-bounded-context-split.md)`
 - Functional stories MUST be referenced by ID: `FS-01`
 
 ---
@@ -526,7 +526,7 @@ Every template MUST:
 | Default branch | `main` |
 | Branch protection | Require PR, require status checks, require up-to-date |
 | PR merge strategy | Squash merge (linear history) |
-| Issue templates | Bug report, Feature requestá, Technical spike |
+| Issue templates | Bug report, Feature request, Technical spike |
 | PR templates | Summary, Changes, Testing, ADR references |
 | CODEOWNERS | Per directory ownership (.github/CODEOWNERS) |
 | Labels | `area/*`, `type/*`, `priority/*`, `status/*` taxonomy | ### 11.2 Branch Naming
@@ -604,7 +604,7 @@ Types enforced by commitlint: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
 | No `CONTRIBUTING.md` | `<repo-root>/CONTRIBUTING.md` | Create from template |
 | No `GOVERNANCE.md` | `<repo-root>/GOVERNANCE.md` | Create from template |
 | `.bmad-core/` inside workspace | Merge into root `.bmad/` or `bmad-core/` | Consolidate BMAD config |
-| `docs/rules-summary.md` | `docs/en/04-artifacts/rules-summary.md` | Move under phase structure | ### 13.2 Migration Phases
+| `docs/rules-summary.md` | `docs/en/artifacts/rules-summary.md` | Move under phase structure | ### 13.2 Migration Phases
 
 ```
 Phase 1 — Foundation (Week 1)
@@ -620,7 +620,7 @@ Phase 2 — Source Restáructuring (Week 2-3)
    Create initial libs/ with one shared library to validate pattern
 
 Phase 3 — Documentation Alignment (Week 3-4)
-   Move docs/rules-summary.md to docs/en/04-artifacts/
+   Move docs/rules-summary.md to docs/en/artifacts/
    Add index.md to every docs/ subdirectory
    Update MASTER_INDEX.md with new structure
    Audit all cross-references for correctness
@@ -649,7 +649,7 @@ Phase 4 — Automation (Week 4)
 
 - **Directory lint:** CI pipeline validates canonical tree structure on every PR
 - **Naming lint:** Shell script or custom ESLint rule checks naming conventions
-- **ADR index check:** Verifies every ADR file is listed in `docs/*/03-adrs/index.md`
+- **ADR index check:** Verifies every ADR file is listed in `docs/*/adrs/index.md`
 - **No orphaned docs:** Every `.md` file must be referenced in at least one index or README
 - **Bilingual sync check:** Every file in `docs/en/` must have a corresponding file in `docs/es/` (R-01)
 

AGENTS.md

@@ -13,7 +13,7 @@ Commands for Frontend (run from `src/`):
 
 Commands for Backend (run from within `./src/apps/app-api-dotnet/` or root solution directory):
 - Backend Build: `dotnet build`
-- Backend Testá: `dotnet test`
+- Backend Test: `dotnet test`
 - Backend Run: `dotnet run`
 
 ## Architecture

CHANGELOG.md

@@ -6,7 +6,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.8 (2026-05-10)
 
@@ -16,7 +16,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.7 (2026-05-10)
 
@@ -26,7 +26,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.6 (2026-05-10)
 
@@ -36,7 +36,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.5 (2026-05-10)
 
@@ -46,7 +46,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.4 (2026-05-10)
 
@@ -56,7 +56,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.3 (2026-05-10)
 
@@ -84,7 +84,7 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam
 
 ## 0.0.2 (2026-05-08)
 
@@ -98,4 +98,4 @@
 
 ### Thank You
 
-- Alberto Arroyo Raygada @nestájslatam
+- Alberto Arroyo Raygada @nestjslatam

README.es.md

@@ -20,7 +20,7 @@ Empieza aquí si eres nuevo en UMS. Este índice le da a cada lector una ruta r
 | Ver Épicas y Prioridades | [Backlog de Producto MVP](./governance/project-es/mvp-product-backlog.md) | [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) |
 | Revisar requisitos funcionales | [Índice de Requisitos](./governance/requirements-es/index.md) | [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Glosario](./governance/requirements-es/glossary.md) |
 | Validar datos y modelo de dominio | [Modelo de Datos Conceptual](./governance/requirements-es/conceptual-data-model.md) | [Formatos de Exportación ER](./architecture/blueprints-es/er-export-formats.md) → [Diseño ER de Base de Datos](./architecture/blueprints-es/database-design-er.md) |
-| Entender la arquitectura | [Portal de Arquitectura](./architecture/index.es.md) | [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) |
+| Entender la arquitectura | [Portal de Arquitectura](./architecture/index.md) | [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) |
 | Construir u operar el sistema | [Engine Room](./src/) | [Habilitadores Técnicos](./architecture/blueprints-es/technical-enablers/index.md) → [Portal de Operaciones](./operations/index.md) |
 | Navegar todo | [Índice Maestro](./MASTER_INDEX.es.md) | Árbol completo de documentación por fase de ciclo de vida.
 ## Inicio Rápido (Motor Técnico)
@@ -34,22 +34,22 @@ npm install; npx nx run app-web:dev
 ## Hub de Conocimiento
 | Dominio | Índice del Portal | Contenidos |
 | :--- | :--- | :--- |
-| **Gobernanza** | [Portal de Gobernanza](./governance/index.es.md) | Dirección de producto, estándares, roadmap, backlog de proyecto y auditorías. |
+| **Gobernanza** | [Portal de Gobernanza](./governance/index.md) | Dirección de producto, estándares, roadmap, backlog de proyecto y auditorías. |
 | **Entrega de Proyecto** | [Backlog de Proyecto](./governance/project-es/index.md) | Épicas MVP, historias de usuario, orden de prioridad, fases y línea de corte. |
 | **Requisitos** | [Índice de Requisitos](./governance/requirements-es/index.md) | Historias funcionales, glosario de negocio, modelo de permisos y modelo conceptual. |
-| **Arquitectura** | [Portal de Arquitectura](./architecture/index.es.md) | Stack, registro ADR, especificación C4, contextos delimitados y habilitadores técnicos. |
-| **Infraestructura** | [Infraestructura](./infrastructure/index.es.md) | Docker, Kong, Kubernetes y configuración de ambientes. |
-| **Operaciones** | [Portal de Operaciones](./operations/index.es.md) | Runbooks, observabilidad, operación SQL y prácticas SRE. |
-| **Conocimiento** | [Base de Conocimiento](./knowledge/index.es.md) | Rutas de lectura recomendadas, POCs, investigación y onboarding.
+| **Arquitectura** | [Portal de Arquitectura](./architecture/index.md) | Stack, registro ADR, especificación C4, contextos delimitados y habilitadores técnicos. |
+| **Infraestructura** | [Infraestructura](./infrastructure/index.md) | Docker, Kong, Kubernetes y configuración de ambientes. |
+| **Operaciones** | [Portal de Operaciones](./operations/index.md) | Runbooks, observabilidad, operación SQL y prácticas SRE. |
+| **Conocimiento** | [Base de Conocimiento](./knowledge/index.md) | Rutas de lectura recomendadas, POCs, investigación y onboarding.
 ## Lectura Recomendada por Rol
 | Perfil | Objetivo de Lectura | Ruta de Aprendizaje (Links Directos) |
 | :--- | :--- | :--- |
 | **Director / Ejecutivo** | Valor de negocio, alcance MVP y confianza de entrega | [Visión de Producto](./governance/product-es/product-vision.md) → [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) → [Backlog de Producto MVP](./governance/project-es/mvp-product-backlog.md) |
 | **Product Owner** | Alcance funcional, secuencia y propiedad del backlog | [Visión de Producto](./governance/product-es/product-vision.md) → [Requisitos](./governance/requirements-es/index.md) → [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) → [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) |
 | **Analista de Negocio** | Narrativa de negocio, reglas y criterios de aceptación | [Requisitos](./governance/requirements-es/index.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Glosario](./governance/requirements-es/glossary.md) → [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) |
-| **Arquitecto de SW** | Diseño técnico, decisiones y límites de dominio | [Visión de Producto](./governance/product-es/product-vision.md) → [Portal de Arquitectura](./architecture/index.es.md) → [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) |
+| **Arquitecto de SW** | Diseño técnico, decisiones y límites de dominio | [Visión de Producto](./governance/product-es/product-vision.md) → [Portal de Arquitectura](./architecture/index.md) → [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) |
 | **Developer (BE/FE)** | Qué construir, por qué importa y cómo encaja | [Visión de Producto](./governance/product-es/product-vision.md) → [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Habilitadores Técnicos](./architecture/blueprints-es/technical-enablers/index.md) → [Engine Room](./src/) |
-| **DevOps / SRE** | Ambientes, confiabilidad y observabilidad | [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) → [Infraestructura](./infrastructure/index.es.md) → [Portal de Operaciones](./operations/index.es.md) → [Estrategia de Observabilidad](./architecture/artifacts-es/observability-strategy.md) |
+| **DevOps / SRE** | Ambientes, confiabilidad y observabilidad | [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) → [Infraestructura](./infrastructure/index.md) → [Portal de Operaciones](./operations/index.md) → [Estrategia de Observabilidad](./architecture/artifacts-es/observability-strategy.md) |
 | **QA / Seguridad** | Calidad, riesgos y estrategia de verificación | [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) → [Plan de Pruebas de Contrato](./architecture/artifacts-es/contract-testing-plan.md) → [Especificación IAM](./architecture/artifacts-es/enterprise-iam-ums-specification.md) → [Modelo de Madurez](./architecture/artifacts-es/architecture-maturity-model.md) |
 | **IA / Agentes** | BMAD-METHOD y reglas del repositorio | [Reglas de Agentes](./AGENTS.md) → [Auditoría BMAD](./architecture/artifacts-es/bmad-master-audit-alignment-report.md) → [Auditoría Taxonomía](./governance/audits/2026-05-13-taxonomy-normalization-audit.md) |
 

architecture/adrs-es/0001-monorepo-orchestration-nx.md

@@ -1,12 +1,12 @@
 # ADR 0001: Orquestáación de Monorepo con Nx y npm Workspaces
 
 * **Estado:** Aceptado (Incorporado por Referencia)
-* **Fuente Corporativa:** [arc32-1](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/core/0001-monorepo-orchestration-nx.md)
+* **Fuente Corporativa:** [arc32-1](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/0001-monorepo-orchestration-nx.md)
 
 ## Decisión
 
 Este proyecto adopta el estándar corporativo textualmente según lo definido en la fuente anterior. No se requiere adaptación específica del proyecto.
 
 ## Notas Específicas del Proyecto
 
-- Detalles de implementación: ver `docs/es/04-artifacts/corporate-standards-baseline.md`
+- Detalles de implementación: ver `docs/es/artifacts/corporate-standards-baseline.md`

architecture/adrs-es/0002-clean-architecture-nestjs.md

@@ -1,7 +1,7 @@
 # ADR 0002: Clean Architecture y Límites Hexagonales en NestJS
 
 * **Status:** Accepted
-* **Basado en:** [arc32-2](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/core/0002-clean-architecture-hexagonal.md)
+* **Basado en:** [arc32-2](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/0002-clean-architecture-hexagonal.md)
 * **Date:** 2026-05-08
 
 ## Resumen de Adaptación

architecture/adrs-es/0004-frontend-offline-resilience.md

@@ -9,4 +9,4 @@ Este proyecto adopta el estándar corporativo textualmente según lo definido en
 
 ## Notas Específicas del Proyecto
 
-- Detalles de implementación: ver `docs/es/04-artifacts/corporate-standards-baseline.md`
+- Detalles de implementación: ver `docs/es/artifacts/corporate-standards-baseline.md`

architecture/adrs-es/0005-ci-cd-quality-codeql.md

@@ -1,12 +1,12 @@
 # ADR 0005: Seguridad de Costo Cero y Pipeline CI con CodeQL
 
 * **Estado:** Aceptado (Incorporado por Referencia)
-* **Fuente Corporativa:** [arc32-5](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/core/0005-ci-cd-quality-codeql.md)
+* **Fuente Corporativa:** [arc32-5](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/0005-ci-cd-quality-codeql.md)
 
 ## Decisión
 
 Este proyecto adopta el estándar corporativo textualmente según lo definido en la fuente anterior. No se requiere adaptación específica del proyecto.
 
 ## Notas Específicas del Proyecto
 
-- Detalles de implementación: ver `docs/es/04-artifacts/corporate-standards-baseline.md`
+- Detalles de implementación: ver `docs/es/artifacts/corporate-standards-baseline.md`

architecture/adrs-es/0006-future-microservices-transition-dapr.md

@@ -1,12 +1,12 @@
 # ADR 0006: Transición Futura a Microservicios con Dapr Sidecars
 
 * **Estado:** Aceptado (Incorporado por Referencia)
-* **Fuente Corporativa:** [arc32-6](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/core/0006-future-microservices-transition-dapr.md)
+* **Fuente Corporativa:** [arc32-6](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/0006-future-microservices-transition-dapr.md)
 
 ## Decisión
 
 Este proyecto adopta el estándar corporativo textualmente según lo definido en la fuente anterior. No se requiere adaptación específica del proyecto.
 
 ## Notas Específicas del Proyecto
 
-- Detalles de implementación: ver `docs/es/04-artifacts/corporate-standards-baseline.md`
+- Detalles de implementación: ver `docs/es/artifacts/corporate-standards-baseline.md`

architecture/adrs-es/0009-strict-dependency-pinning-vulnerability-management.md

@@ -1,12 +1,12 @@
 # ADR 0009: Fijación Estricta de Dependencias y Gestión Automatizada de Vulnerabilidades
 
 * **Estado:** Aceptado (Incorporado por Referencia)
-* **Fuente Corporativa:** [arc32-9](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/core/0009-strict-dependency-pinning-vulnerability-management.md)
+* **Fuente Corporativa:** [arc32-9](https://github.com/beyondnetcode/arc32_progresive_monolith/blob/main/arc-corporate-ws/corporate-standards/02-adrs/0009-strict-dependency-pinning-vulnerability-management.md)
 
 ## Decisión
 
 Este proyecto adopta el estándar corporativo textualmente según lo definido en la fuente anterior. No se requiere adaptación específica del proyecto.
 
 ## Notas Específicas del Proyecto
 
-- Detalles de implementación: ver `docs/es/04-artifacts/corporate-standards-baseline.md`
+- Detalles de implementación: ver `docs/es/artifacts/corporate-standards-baseline.md`