Add faithful Spanish translation for organization profile

profile/README.es.md

@@ -1,172 +1,155 @@
-# BeyondNet Code
+<div align="center">
+  <img src="https://capsule-render.vercel.app/api?type=rect&color=0d0d0d&fontColor=D4AF37&text=BEYONDNET%20TECH&fontSize=60&desc=Open%20source%20architecture%20for%20systems%20that%20have%20to%20last&descSize=16&height=250&fontAlignY=40&descAlignY=65&animation=fadeIn" alt="BeyondNet Tech" />
 
-> Read this in [English](README.md)
+  <p><b>Arquitectura empresarial, en abierto.</b><br/>
+  Corpus de referencia, estándares de gobernanza y librerías .NET/TypeScript que puedes leer, hacer fork y distribuir.</p>
 
-> Open Source. Arquitectura Moderna. Innovación sin límites.
+  <a href="https://github.com/orgs/beyondnetcode/repositories"><img src="https://img.shields.io/badge/Repositories-13-D4AF37?style=for-the-badge&logo=github&logoColor=white" alt="Repositorios"/></a>
+  <a href="https://github.com/orgs/beyondnetcode/discussions"><img src="https://img.shields.io/badge/Discussions-Open-D4AF37?style=for-the-badge&logo=github&logoColor=white" alt="Discusiones"/></a>
+  <a href="https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-Welcome-2ea44f?style=for-the-badge" alt="PRs bienvenidos"/></a>
+  <a href="#good-first-issues"><img src="https://img.shields.io/badge/Good%20first%20issues-Start%20here-2ea44f?style=for-the-badge" alt="Buenos primeros issues"/></a>
+</div>
 
----
+> 🌐 [English](README.md)
 
-## Sobre Nosotros
+---
 
-**BeyondNet Code** es una organización tecnológica abierta dedicada a la creación colaborativa de código, documentación arquitectónica, referencias de ingeniería y activos de desarrollo de software bajo licencias abiertas.
+## Qué construimos realmente
 
-Nuestro objetivo es ayudar a la comunidad técnica a diseñar, documentar y evolucionar sistemas de software modernos con criterio arquitectónico profesional.
+No es un manifiesto: tres cosas concretas.
 
-Trabajamos especialmente en:
+1. **Un corpus de arquitectura progresiva** (`Evolith / Arc32`): ADRs, patrones canónicos y reglas de gobernanza que llevan un sistema de monólito modular a microservicios *sin reescribirlo*. Documentado, versionado y aplicado por CI.
+2. **Herramientas SDLC que aplican el corpus** (`Evolith Tracker`): requisitos → código → quality gates → deploy, con trazabilidad auditable.
+3. **Librerías .NET y TypeScript reutilizables** (`Shell.*`, `UMS`): AOP, bootstrap de DI, fábricas, bloques de construcción DDD e identidad. Pequeñas, enfocadas y con licencias permisivas.
 
-- Arquitectura de software moderna
-- Monolitos modulares y microservicios sostenibles
-- Clean Architecture y Hexagonal Architecture
-- DDD pragmático
-- DevOps, observabilidad y automatización
-- Ingeniería asistida por IA
-- Documentación técnica abierta
+Todo está aumentado por agentes por diseño: las instrucciones (`AGENTS.md`) viven *dentro* de los repositorios, de modo que un agente de código hereda los mismos estándares que una persona colaboradora.
 
 ---
 
-## Proyectos Destacados
-
-| Proyecto | Descripción | Enlace |
-|---|---|---|
-| **Evolith** | Plataforma de arquitectura progresiva empresarial — la referencia autoritativa para evolucionar productos desde Monolitos Modulares a sistemas distribuidos, gobernada y asistida por IA por diseño. | https://github.com/beyondnetcode/evolith_arch32 |
-| **UMS** | Sistema de referencia para gestión de usuarios, identidad, autorización y gobierno multi-tenant. | https://github.com/beyondnetcode/ums |
+## Empieza aquí: elige tu camino
+
+<table>
+  <tr>
+    <td width="33%" valign="top">
+      <h3>Úsalo</h3>
+      <p>15 paquetes en NuGet. A un comando de distancia.</p>
+      <ul>
+        <li><a href="https://www.nuget.org/packages/BeyondNetCode.Shell.Ddd">Shell.DDD</a> — entidades, agregados, value objects</li>
+        <li><a href="https://www.nuget.org/packages/BeyondNetCode.Shell.Aop">Shell.Aop</a> — AOP basado en DispatchProxy</li>
+        <li><a href="https://www.nuget.org/profiles/beyondnet">Todos los paquetes</a> — la familia completa <code>BeyondNetCode.Shell.*</code></li>
+      </ul>
+    </td>
+    <td width="33%" valign="top">
+      <h3>Apréndelo</h3>
+      <p>Lee el razonamiento antes que el código.</p>
+      <ul>
+        <li><a href="https://github.com/beyondnetcode/why-architecture">Why-Architecture</a> — el motivo de cada decisión</li>
+        <li><a href="https://github.com/beyondnetcode/evolith_arch32/tree/main/reference">ADRs y patrones</a></li>
+        <li><a href="https://github.com/orgs/beyondnetcode/discussions">Debátelo con nosotros</a></li>
+      </ul>
+    </td>
+    <td width="33%" valign="top">
+      <h3>Constrúyelo</h3>
+      <p>Envía tu primer PR esta semana.</p>
+      <ul>
+        <li><a href="#good-first-issues">Buenos primeros issues</a></li>
+        <li><a href="https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md">Guía de contribución</a></li>
+        <li><a href="https://github.com/beyondnetcode/evolith_arch32/blob/main/AGENTS.md">AGENTS.md</a> — contribuir con agentes de código</li>
+      </ul>
+    </td>
+  </tr>
+</table>
 
 ---
 
-## Visión Arquitectónica
-
-Creemos que los productos modernos deben poder empezar simples, crecer con orden y evolucionar sin reescrituras traumáticas.
-
-Nuestra idea central:
-
-> Separar conceptualmente antes de separar físicamente.
+## Instalación
 
-No todo producto necesita microservicios desde el día uno.
+```bash
+dotnet add package BeyondNetCode.Shell.Aop      # AOP via DispatchProxy
+dotnet add package BeyondNetCode.Shell.Ddd      # bloques de construcción DDD
+dotnet add package BeyondNetCode.Shell.Factory  # fábricas guiadas por configuración
+```
 
-Pero todo producto serio necesita límites claros, decisiones explícitas, contratos técnicos, observabilidad y una ruta de evolución.
+Compatible con `net10.0`. La familia completa — aspectos, integración con Serilog, instaladores de DI, value objects, perfiles de AutoMapper, observabilidad — está en [nuget.org/profiles/beyondnet](https://www.nuget.org/profiles/beyondnet).
 
 ---
 
-## Licencias
+## Proyectos
 
-Nuestros proyectos priorizan licencias abiertas y colaboración comunitaria.
+| Proyecto | Qué es | Stack | Estado |
+|---|---|---|---|
+| **[Evolith / Arc32](https://github.com/beyondnetcode/evolith_arch32)** | Corpus de referencia de arquitectura progresiva: estándares, ADRs y reglas de gobernanza que heredan los productos satélite. | TypeScript · docs | Activo · MIT |
+| **[Evolith Tracker](https://github.com/beyondnetcode/evolith_tracker)** | Seguimiento SDLC de extremo a extremo: ideación → quality gates → deploy, totalmente trazable. | C# / .NET | Beta |
+| **[Why-Architecture](https://github.com/beyondnetcode/why-architecture)** | El *porqué* detrás de cada patrón que publicamos. Documentos y artefactos de ejemplo. | Docs · CC0 | Activo |
+| **[UMS](https://github.com/beyondnetcode/ums)** | Sistema de gestión de usuarios: identidades, autenticación y autorización. | C# / .NET | Prototipo |
+| **[Shell.*](https://github.com/orgs/beyondnetcode/repositories?q=Shell)** | `Shell.Aop` · `Shell.Bootstrapper` · `Shell.Factory` · `Shell.DDD` — bloques de construcción .NET enfocados. | C# / .NET | Activo |
 
-| Licencia | Uso |
-|---|---|
-| **MIT** | Código fuente abierto y reutilizable |
-| **Creative Commons** | Documentación, guías y contenido técnico |
-| **Open Source** | Transparencia, colaboración y aprendizaje compartido |
+<div align="center">
+  <a href="https://raw.githubusercontent.com/beyondnetcode/evolith_arch32/main/reference/governance/sdlc/assets/master-view.png" title="Haz clic para ampliar">
+    <img src="https://raw.githubusercontent.com/beyondnetcode/evolith_arch32/main/reference/governance/sdlc/assets/master-view-annotated.png" alt="Visión de producto Evolith de extremo a extremo" width="780" />
+  </a>
+  <br/><sub>Visión de producto Evolith de extremo a extremo · <i>haz clic para ampliar</i></sub>
+</div>
 
 ---
 
-## Áreas Técnicas
-
-### Backend
-
-- .NET / ASP.NET Core
-- Node.js / NestJS
-- TypeScript
-- Arquitectura Hexagonal
-- Clean Architecture
-- DDD pragmático
+## Buenos primeros issues
 
-### Frontend
+Mantenemos una lista curada de entradas. Cada issue etiquetado como `good first issue` indica su alcance, los archivos exactos a tocar y los criterios de aceptación que tu PR debe cumplir, sin necesidad de adivinar.
 
-- React
-- Next.js
-- Vue.js
-- Vite
-- Design Systems
+<div align="center">
+  <a href="https://github.com/search?q=org%3Abeyondnetcode+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=issues"><img src="https://img.shields.io/badge/Browse-good%20first%20issues-2ea44f?style=for-the-badge&logo=github&logoColor=white" alt="Explorar buenos primeros issues"/></a>
+  <a href="https://github.com/search?q=org%3Abeyondnetcode+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22&type=issues"><img src="https://img.shields.io/badge/Browse-help%20wanted-D4AF37?style=for-the-badge&logo=github&logoColor=white" alt="Explorar ayuda solicitada"/></a>
+</div>
 
-### DevOps y Plataforma
+**Qué necesitamos ahora mismo:**
 
-- Docker
-- Kubernetes
-- GitHub Actions
-- Observabilidad
-- CI/CD
-- Infraestructura como código
+- **Ingenieros .NET** — ampliar la cobertura de pruebas de `Shell.*`, publicar la siguiente versión de las librerías y endurecer los flujos de token de `UMS`.
+- **Ingenieros TypeScript / Node** — implementaciones de referencia de los patrones Arc32 en NestJS.
+- **Ingenieros de agentes** — mejorar los conjuntos de instrucciones de `AGENTS.md` y construir harnesses de evaluación para PRs generados por agentes.
+- **DevOps** — plantillas de CI, imágenes de contenedores y automatización de releases en toda la organización.
+- **Escritores técnicos** — paridad inglés/español en `Why-Architecture` y en el corpus de ADRs.
 
-### AI Engineering
-
-- OpenAI
-- Semantic Kernel
-- LangChain
-- MCP
-- AI-assisted SDLC
-- Agentic Engineering
+¿No encuentras un issue que encaje? [Abre uno](https://github.com/beyondnetcode/evolith_arch32/issues/new/choose) o [inicia una discusión](https://github.com/orgs/beyondnetcode/discussions); las propuestas son bienvenidas antes que el código.
 
 ---
 
-## Cómo Contribuir
-
-Puedes colaborar de varias formas:
-
-1. Revisando documentación técnica.
-2. Proponiendo mejoras arquitectónicas.
-3. Abriendo issues con gaps o inconsistencias.
-4. Enviando Pull Requests.
-5. Mejorando ejemplos de código.
-6. Agregando pruebas o fitness functions.
-7. Ayudando con traducciones en inglés y español.
+## Tu primera contribución, en 4 pasos
 
-Repositorios principales:
+```bash
+# 1. Fork y clone
+gh repo fork beyondnetcode/evolith_arch32 --clone
 
-- Evolith: https://github.com/beyondnetcode/evolith_arch32
-- UMS: https://github.com/beyondnetcode/ums
+# 2. Rama (commitlint exige nomenclatura convencional)
+git checkout -b feat/your-change
 
----
+# 3. Commit — Conventional Commits, validado por husky
+git commit -m "feat(reference): add ADR for outbox pattern"
 
-## Enlaces Útiles
+# 4. Push y abre el PR
+gh pr create --fill
+```
 
-| Recurso | Enlace |
-|---|---|
-| Organización GitHub | https://github.com/beyondnetcode |
-| Evolith | https://github.com/beyondnetcode/evolith_arch32 |
-| UMS | https://github.com/beyondnetcode/ums |
-| Perfil del fundador | https://github.com/beyondnetPeru |
-| C# Sandbox Code | https://github.com/csdevlib |
-| Discussions | Próximamente |
+Lee [CONTRIBUTING.md](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md) ([ES](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.es.md)) una vez; cubre las puertas de gobernanza, el proceso de ADRs y cómo proponer un cambio a un estándar.
 
 ---
 
-## Fundador
-
-**Alberto Arroyo Raygada**  
-Principal Software Architect
-
-Experiencia en:
-
-- Arquitectura empresarial
-- Modernización de sistemas
-- Monolitos modulares
-- Microservicios
-- DDD y Clean Architecture
-- DevOps y Cloud
-- Ingeniería asistida por IA
-
-Contacto:
+## Cómo decidimos
 
-- GitHub: https://github.com/beyondnetPeru
-- Email: beyondnet.peru@gmail.com
+Los cambios de arquitectura pasan por **ADRs**, no por opiniones. Cualquier persona puede proponer uno; los mantenedores lo revisan contra el corpus en [`reference/`](https://github.com/beyondnetcode/evolith_arch32/tree/main/reference). El desacuerdo es esperado y queda documentado: ese es el punto de escribir las decisiones.
 
----
-
-## Estado de la Comunidad
-
-```text
-Foco técnico: Arquitectura moderna y open source
-Proyectos: Referencias técnicas y laboratorios de arquitectura
-Alcance: Comunidad global en español e inglés
-Licencia: Open Source / MIT
-```
+- [Guía de contribución](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md) ([ES](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.es.md))
+- [Política de seguridad](https://github.com/beyondnetcode/evolith_arch32/blob/main/SECURITY.md)
+- Licencias: MIT y Apache-2.0 para librerías, CC0 para corpus de documentación.
 
 ---
 
-## Invitación
-
-BeyondNet Code está abierto a profesionales, arquitectos, tech leads, backend engineers, platform engineers, DevOps, QA engineers, security engineers y technical writers que quieran colaborar en referencias técnicas abiertas.
-
-La arquitectura de software mejora cuando se discute, se documenta, se prueba y se valida en comunidad.
+<div align="center">
+  <a href="https://github.com/beyondnetcode/evolith_arch32/graphs/contributors">
+    <img src="https://contrib.rocks/image?repo=beyondnetcode/evolith_arch32" alt="Contribuidores" />
+  </a>
 
-Bienvenido a BeyondNet Code.
+  <p><i>"El código va más allá de la sintaxis; es la arquitectura del futuro. Únete a nosotros para construirlo."</i></p>
+  <p>Mantenido por <a href="https://github.com/beyondnetPeru">Alberto Arroyo Raygada</a> y contribuidores ·
+  <a href="https://github.com/orgs/beyondnetcode/discussions">Discusiones</a></p>
+</div>

profile/README.md

@@ -10,6 +10,8 @@
   <a href="#good-first-issues"><img src="https://img.shields.io/badge/Good%20first%20issues-Start%20here-2ea44f?style=for-the-badge" alt="Good first issues"/></a>
 </div>
 
+> 🌐 [Español](README.es.md)
+
 ---
 
 ## What we actually build