docs: implement high-level minimalist Executive Portal READMEs

Author: beyondnetPeru

AGENTS.md

@@ -24,11 +24,12 @@ Commands for Backend (run from within `./src/apps/app-api-dotnet/` or root solut
 - Pattern: Clean Architecture (Hexagonal), SOLID, Explicit Bounded Contexts.
 
 ## Conventions
-- Adhere to the **spec-driven AI strategy BMAD-METHOD** for numerical sequential documentation (Phases 00 to 05).
-- Strictly isolate Domain rules from external frameworks.
+- **Engineering Patterns**: Adhere to **Clean Architecture** (Hexagonal), **SOLID** principles, and strict **DDD** bounded contexts.
+- **AI-Driven Strategy**: Utilize the **BMAD-METHOD** for spec-driven development and numerical sequential documentation (Phases 00 to 05).
+- **Domain Purity**: Strictly isolate Domain rules from external frameworks.
   - JS/TS: Hexagonal boundaries and strict linting.
   - C#: `{BoundedContext}.Domain` project must be pure POCOs with zero NuGet references.
-- Utilize the **Result Pattern** instead of throwing application exceptions for domain flow control.
+- **Flow Control**: Utilize the **Result Pattern** instead of throwing application exceptions for domain flow control.
 - Enforce strict TypeScript and C# types with static analysis gates (SonarJS).
 
 ## Agent Rules

MASTER_INDEX.md

@@ -2,7 +2,7 @@
 
 > **Language:** [English](./MASTER_INDEX.md) | [Espanol](./MASTER_INDEX.es.md)
 
-Phase-based navigation for the User Management System (UMS) documentation.
+Product Lifecycle and Engineering Specifications for the User Management System (UMS).
 
 ---
 

README.es.md

@@ -1,32 +1,40 @@
-# Workspace del Monorepo UMS
+# UMS — Sistema de Gestión de Usuarios Empresarial
 
-> **Idioma:** [English](./README.md) | [Espanol](./README.es.md)
+> **Monolito Modular de alta escala para Identidad y Autorización Unificada.**
+>
+> ![Estado](https://img.shields.io/badge/Estado-Activo-success) ![Arch](https://img.shields.io/badge/Arquitectura-Monolito_Modular-blue) ![Engine](https://img.shields.io/badge/Motor-.NET_8_/_React-informational)
 
-Workspace Nx para el Sistema de Gestion de Usuarios -- backend .NET 8 y frontend React.
+---
 
-## Stack Tecnologico
+### 🚀 Hub de Navegación
+Explora las capas del repositorio:
 
-- **Frontend:** React 18 / Vite / Zustand / TanStack Query
-- **Backend:** .NET 8 LTS / ASP.NET Core / MediatR / FluentValidation
-- **Datos:** PostgreSQL 16 / EF Core (Npgsql)
-- **Herramientas:** Nx / npm Workspaces / CSharpier / ESLint / CodeQL
+- [⚖️ **Gobernanza**](./governance/) — Visión, Roadmap y Requisitos.
+- [🏗️ **Arquitectura**](./architecture/) — ADRs, Planos y Modelos C4.
+- [🛠️ **Infraestructura**](./infrastructure/) — Docker, K8s y Gateway.
+- [🚀 **Operaciones**](./operations/) — Observabilidad y Monitoreo.
+- [🎓 **Conocimiento**](./knowledge/) — Onboarding y POCs.
+- [💻 **Código Fuente**](./src/) — El "Engine Room" (Apps y Libs).
 
-## Inicio Rapido
+---
 
-### Frontend
-```bash
-npm install
-npx nx run apps-web:dev
-```
+### 🏛️ ADN Técnico
+- **Patrones**: Monolito Modular, DDD, Clean Architecture, Hexagonal.
+- **Backend**: .NET 8 LTS (Pattern Result, MediatR).
+- **Frontend**: React 18 + Vite (Zustand para estado).
+- **Seguridad**: Seguridad a Nivel de Fila (RLS) + OAuth2/OIDC.
 
-### Backend (desde apps/api-dotnet/)
-```bash
-dotnet build
-dotnet test
-dotnet run --project Ums.Presentation
-```
+### 🚦 Inicio Rápido
+```powershell
+# 1. Entrar al Engine Room
+cd src
 
-## Documentacion
+# 2. Instalar e Iniciar Frontend
+npm install; npx nx run app-web:dev
+
+# 3. Compilar Backend
+dotnet build ./apps/app-api-dotnet/Ums.sln
+```
 
-- [Base de Conocimiento en Ingles](./docs/en/index.md)
-- [Base de Conocimientos en Espanol](./docs/es/index.md)
+### ⚖️ Gobernanza de Ingeniería
+La navegación técnica detallada está disponible en el [**Indice Maestro**](./MASTER_INDEX.es.md). Este proyecto utiliza **BMAD-METHOD** para la trazabilidad documental asistida por IA.

README.md

@@ -1,32 +1,40 @@
-# UMS Monorepo Workspace
+# UMS — Enterprise User Management System
 
-> **Language:** [English](./README.md) | [Espanol](./README.es.md)
+> **High-scale Modular Monolith for Unified Identity & Authorization.**
+>
+> ![Status](https://img.shields.io/badge/Status-Active-success) ![Arch](https://img.shields.io/badge/Architecture-Modular_Monolith-blue) ![Engine](https://img.shields.io/badge/Engine-.NET_8_/_React-informational)
 
-Nx workspace for the User Management System -- .NET 8 backend and React frontend.
+---
 
-## Tech Stack
+### 🚀 Navigation Hub
+Explore the repository layers:
 
-- **Frontend:** React 18 / Vite / Zustand / TanStack Query
-- **Backend:** .NET 8 LTS / ASP.NET Core / MediatR / FluentValidation
-- **Data:** PostgreSQL 16 / EF Core (Npgsql)
-- **Tooling:** Nx / npm Workspaces / CSharpier / ESLint / CodeQL
+- [⚖️ **Governance**](./governance/) — Vision, Roadmap & Requirements.
+- [🏗️ **Architecture**](./architecture/) — ADRs, Blueprints & C4 Models.
+- [🛠️ **Infrastructure**](./infrastructure/) — Docker, K8s & Gateway.
+- [🚀 **Operations**](./operations/) — Observability & Monitoring.
+- [🎓 **Knowledge**](./knowledge/) — Onboarding & POCs.
+- [💻 **Source Code**](./src/) — The Engine Room (Apps & Libs).
 
-## Quick Start
+---
 
-### Frontend
-```bash
-npm install
-npx nx run apps-web:dev
-```
+### 🏛️ Technical DNA
+- **Patterns**: Modular Monolith, DDD, Clean Architecture, Hexagonal.
+- **Backend**: .NET 8 LTS (Result Pattern, MediatR).
+- **Frontend**: React 18 + Vite (State Management with Zustand).
+- **Security**: Row-Level Security (RLS) + OAuth2/OIDC.
 
-### Backend (from apps/api-dotnet/)
-```bash
-dotnet build
-dotnet test
-dotnet run --project Ums.Presentation
-```
+### 🚦 Quick Start
+```powershell
+# 1. Enter the Engine Room
+cd src
 
-## Documentation
+# 2. Install & Start Frontend
+npm install; npx nx run app-web:dev
+
+# 3. Build Backend
+dotnet build ./apps/app-api-dotnet/Ums.sln
+```
 
-- [English Knowledge Base](./docs/en/index.md)
-- [Base de Conocimientos en Espanol](./docs/es/index.md)
+### ⚖️ Engineering Governance
+Detailed technical navigation is available in the [**Master Index**](./MASTER_INDEX.md). This project follows the **BMAD-METHOD** for AI-augmented documentation traceability.

src/.nx/workspace-data/d/daemon.log

@@ -634,3 +634,4 @@ Time taken for 'build typescript dependencies' 8.784099999815226ms
 [NX v22.7.1 Daemon Server] - 2026-05-13T21:24:37.253Z - Done responding to the client project-graph
 [NX v22.7.1 Daemon Server] - 2026-05-13T21:24:37.253Z - Handled json message REQUEST_PROJECT_GRAPH. Handling time: 0. Response time: 1.
 [NX v22.7.1 Daemon Client] - 2026-05-13T21:24:37.251Z - [Messenger] Received message, length: 239650
+[NX v22.7.1 Daemon Server] - 2026-05-13T21:24:37.644Z - Closed a connection. Number of open connections: 0