# GeneXus IA x10

**El centro abierto de ingeniería GeneXus para la comunidad: todo el conocimiento oficial catalogado, las skills de creación autónoma y patrones (`WorkWithPlus`, `K2BTools`, `Work-With`), el servidor MCP gobernado (`x10 Guard`) y las reglas canónicas universales para que cualquier desarrollador (Trainee, Junior o Senior) y cualquier modelo LLM trabajen sobre una KB GeneXus sin ponerla en riesgo.**

> Proyecto independiente de la comunidad. GeneXus es una marca de GeneXus S.A.; este repositorio no está afiliado ni respaldado por ella. "x10" es la meta que guía el diseño, no una medición certificada: todo lo que aquí se afirma como verificado tiene evidencia local reproducible, y lo que falta se dice sin rodeos.

```mermaid
flowchart LR
    DEV["Desarrollador<br/>(Trainee · Junior · Senior)"] --> IA["Cualquier LLM / Agente<br/>(Claude · Gemini · Codex · Cursor)"]:::ia
    IA --> RULES["Reglas Canónicas + Skills<br/>AGENTS.md · .agents/skills/"]:::rules
    IA --> GX["x10 Guard (MCP + CLI)<br/>21 herramientas gobernadas"]:::core
    RULES & GX --> CON["Conocimiento GeneXus<br/>9 guías · 44 fuentes · Radar"]:::doc
    RULES & GX --> KB["Tu Proyecto GeneXus<br/>Projects/&lt;Proyecto&gt;/KB"]:::kb
    classDef ia fill:#1f3b73,stroke:#9fb8e8,color:#fff
    classDef rules fill:#4a3560,stroke:#d3b8f0,color:#fff
    classDef core fill:#7a2e0e,stroke:#f2b48a,color:#fff
    classDef kb fill:#5a3d7a,stroke:#cdb3ea,color:#fff
    classDef doc fill:#2f5d3a,stroke:#a8d5b0,color:#fff
```

---

## Los 4 pilares del repositorio

| Pilar | Dónde vive | Qué resuelve |
|---|---|---|
| **1. Conocimiento GeneXus estructurado** | [`Knowledge/`](Knowledge/README.md) (`01` a `09` + [`catalogo-fuentes.json`](Knowledge/catalogo-fuentes.json) + [`radar-complementos.json`](Knowledge/radar-complementos.json)) | Explica transacciones, reglas, Business Components, navegación `For Each`, LUW/Commit, GAM, MSBuild, `GeneXus for Agents` y patrones con citas verificables |
| **2. Suite de 5 Skills autónomas reutilizables** | [`.agents/skills/`](.agents/skills/) ([`gx-autonomous-kb`](.agents/skills/gx-autonomous-kb/SKILL.md), [`gx-modeling-textual`](.agents/skills/gx-modeling-textual/SKILL.md), [`gx-gam-security`](.agents/skills/gx-gam-security/SKILL.md), [`gx-kb-git-mirror`](.agents/skills/gx-kb-git-mirror/SKILL.md), [`gx-patterns-wwp-k2b`](.agents/skills/gx-patterns-wwp-k2b/SKILL.md)) | Enseñan a cualquier IA a crear una KB desde cero, modelar en `.gx` (`GeneXus for Agents`) o `.xpz` KMW 4.0, configurar e inicializar GAM, gobernar ramas Git del espejo textual, aplicar **WorkWithPlus**, **K2BTools** o **Work-With**, compilar en `.NET` / `Java` (Tomcat) y validar con Playwright |
| **3. Mecanismo de construcción y protección (`x10 Guard`)** | [`x10guard/`](x10guard/README.md) | Servidor MCP y CLI local con 21 herramientas gobernadas: lectura de `.xpz`, búsqueda, grafo de llamadas, análisis de impacto, planes con rollback y tareas MSBuild seguras |
| **4. Reglas canónicas universales para cualquier LLM** | [`AGENTS.md`](AGENTS.md), [`CLAUDE.md`](CLAUDE.md), [`GEMINI.md`](GEMINI.md) y [`docs/MASTER_PROMPT_CANONICO_ENTERPRISE_AI.md`](docs/MASTER_PROMPT_CANONICO_ENTERPRISE_AI.md) | Garantizan que cualquier modelo cuestione antes de escribir, respalde la KB, separe proyectos bajo `Projects/<Proyecto>` y sincronice contexto, memoria e índice |

---

## Inicio rápido en 3 minutos

```powershell
git clone https://github.com/eudavalos/genexus-ia-x10.git IA_Generacion
Set-Location .\IA_Generacion\x10guard
npm ci; npm run build; npm test
node dist/cli.js checkup
```

Si `checkup` responde `"ok": true`, ya tienes el motor funcionando. Para el recorrido completo paso a paso, abre **[docs/GUIA_PASO_A_PASO.md](docs/GUIA_PASO_A_PASO.md)**.

---

## Cómo usar este proyecto según tu nivel (Trainee · Junior · Senior)

Cualquier asistente de IA que abras en la carpeta del clon lee automáticamente [`AGENTS.md`](AGENTS.md) y descubre las skills de [`.agents/skills/`](.agents/skills/). Solo tienes que hablarle según tu objetivo:

### 1. Nivel Trainee (Aprendiz / Primeros pasos en GeneXus)
- **Objetivo:** Entender cómo funciona GeneXus y explorar una KB existente sin riesgo de romper nada (`writeEnabled: false`).
- **Qué leer primero:** [Guía paso a paso](docs/GUIA_PASO_A_PASO.md), [01 — Plataforma y versiones](Knowledge/01-PLATAFORMA-Y-VERSIONES.md) y [02 — Modelado y semántica](Knowledge/02-MODELADO-Y-SEMANTICA.md).
- **Prompts listos para usar con tu IA:**
  - *"Explícame como Trainee la diferencia entre una Transaction, un Business Component y un WebPanel usando las guías de `Knowledge/`."*
  - *"Usa `x10guard_catalog` y `x10guard_callgraph` en el workspace `demo` para explicarme qué objetos existen y cómo se llaman entre sí."*

### 2. Nivel Junior (Construcción guiada de proyectos y pantallas)
- **Objetivo:** Crear una KB nueva en `Projects/<MiProyecto>`, modelar tablas, aplicar patrones (`WorkWithPlus`, `K2BTools` o `Work-With`) y compilar paso a paso con respaldo previo.
- **Qué leer primero:** [09 — Creación autónoma y patrones](Knowledge/09-CREACION-AUTONOMA-Y-PATRONES.md), [Skill `gx-autonomous-kb`](.agents/skills/gx-autonomous-kb/SKILL.md) y [Skill `gx-patterns-wwp-k2b`](.agents/skills/gx-patterns-wwp-k2b/SKILL.md).
- **Prompts listos para usar con tu IA:**
  - *"Quiero crear el proyecto `Projects/Inventario` desde cero. Usa la skill `gx-autonomous-kb`, hazme primero la crítica técnica de requisitos y guíame paso a paso."*
  - *"Aplica el patrón WorkWithPlus (o K2BTools) sobre la transacción `Producto` siguiendo la skill `gx-patterns-wwp-k2b`, probando primero en una copia en `Projects/Labs/`."*

### 3. Nivel Senior / Arquitecto Enterprise (Automatización desatendida, auditoría y gobierno)
- **Objetivo:** Operar pipelines autónomos (`MSBuild + XPZ + GAM + .NET/Java/Tomcat + Playwright` o `GeneXus for Agents` MCP), auditar impacto y seguridad RBAC/GAM, y mantener la sincronización canónica (`.ai/`).
- **Qué leer primero:** [Canon Enterprise](docs/MASTER_PROMPT_CANONICO_ENTERPRISE_AI.md), [Organización de dos niveles](docs/ORGANIZACION_CANONICA.md), [Sincronización canónica](docs/SINCRONIZACION_CANONICA.md), [Arquitectura de `x10 Guard`](x10guard/docs/ARCHITECTURE.md) y [ADRs](docs/decisions/).
- **Prompts listos para usar con tu IA:**
  - *"Audita el impacto de modificar la transacción X en el workspace `mi-kb`, verifica reglas LUW/Commit y seguridad GAM según `Knowledge/03` y `04`, y genera un plan versionado sin aplicarlo."*
  - *"Ejecuta el ciclo autónomo completo de la skill `gx-autonomous-kb` para compilar `Projects/<Proyecto>` en `.NET` y `Java`/Tomcat y valida E2E con Playwright."*

---

## Las 4 rutas de conexión con GeneXus

| Ruta | ¿Requiere GeneXus 18? | Qué permite hacer | Cómo se activa |
|---|---|---|---|
| **Ruta A — Lectura `.xpz`** | No | Importar una exportación `.xpz` a texto, buscar código, armar el grafo de llamadas y preparar planes versionados con rollback | `x10guard` (`npm run import:xpz`) |
| **Ruta B — Laboratorio `x10 Guard`** | Sí + LocalDB | Crear y exportar KB descartables en `Projects/Labs/` mediante planes MSBuild gobernados (`native_plan` -> `native_run`) | `x10guard` con `native.enabled: true` |
| **Ruta B+ — Construcción Autónoma (`MSBuild + XPZ`)** | Sí + SQL Server/LocalDB | Crear KB completa, importar objetos/tablas vía `.xpz` KMW 4.0, aplicar patrones (`WorkWithPlus`/`K2BTools`), inicializar GAM (`connection.gam`), compilar en `.NET` y `Java`/Tomcat y probar con Playwright **sin requerir sesión en GeneXus Platform** | Skills [`gx-autonomous-kb`](.agents/skills/gx-autonomous-kb/SKILL.md) y [`gx-patterns-wwp-k2b`](.agents/skills/gx-patterns-wwp-k2b/SKILL.md) |
| **Ruta C — Oficial (`GeneXus for Agents` MCP)** | Sí + Cuenta con Organización | Trabajar sobre el espejo textual `.gx` oficial con `gx` CLI, el servidor MCP en `127.0.0.1:1989` y las extensiones MCP de `WorkWithPlus for Agents` / `K2BTools in GeneXus4Agents` | Skills oficiales `nexa`/`gam` + guía [`Knowledge/07`](Knowledge/07-GENEXUS-FOR-AGENTS.md) y [`Knowledge/09`](Knowledge/09-CREACION-AUTONOMA-Y-PATRONES.md) |

---

## Qué hay dentro del repositorio

| Ubicación | Responsabilidad |
|---|---|
| `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` | Instrucciones canónicas universales que cualquier asistente de IA lee al abrir el repositorio |
| `.agents/skills/` | 5 skills propias y portables del centro (`gx-autonomous-kb`, `gx-modeling-textual`, `gx-gam-security`, `gx-kb-git-mirror`, `gx-patterns-wwp-k2b`) que cubren la creación autónoma de KB GeneXus 18, formato `.gx` (`Wiki 62101`), seguridad GAM, espejo Git y patrones (`WorkWithPlus`, `K2BTools`, `Work-With`) |
| `Knowledge/` | 9 guías técnicas, catálogo de 44 fuentes oficiales GeneXus (`catalogo-fuentes.json`), matriz de capacidades y radar de complementos (`radar-complementos.json`) |
| `x10guard/` | Servidor MCP + CLI en TypeScript (`v0.7.0`): 21 herramientas gobernadas para análisis, planes de edición y tareas MSBuild |
| `docs/` | Gobierno, decisiones de arquitectura ([ADRs](docs/decisions/)), [guía paso a paso](docs/GUIA_PASO_A_PASO.md), lecciones aprendidas y registros de evidencia |
| `.ai/` | Contexto, estado (`PROJECT_STATE.md`), ledger, memorias, enrutador léxico (`router.json`) e índice SHA-256 (`npm run context:sync`) |
| `scripts/` | Sincronización, verificación de portabilidad (`portabilityCheck`) y gate local (`npm run verify`) |
| `Projects/<Proyecto>/` | Carpeta donde viven tus proyectos y KB, cada uno aislado con su propio contexto `.ai/` ([ver plantilla](Projects/README.md)) |

---

## Lo que está verificado y los principios innegociables

- **Verificado en el entorno de referencia** ([PRUEBA_NATIVA_2026-10-31.md](docs/PRUEBA_NATIVA_2026-10-31.md), [PRUEBA_E2E_2026-11-01.md](docs/PRUEBA_E2E_2026-11-01.md), [LECCIONES_2026-11-01.md](docs/LECCIONES_2026-11-01.md)):
  - Servidor MCP `x10 Guard` con 21 herramientas, 48 entradas de conocimiento y 13 entradas en el radar de complementos.
  - Suite automatizada en verde: `17/17` pruebas de gobierno (`npm run test:governance`) y `88/88` pruebas del componente (`npm test`).
  - Ciclo autónomo **Ruta B+** probado nativamente sobre KB real en GeneXus 18 U16: empaquetado e importación `.xpz` KMW 4.0, aplicación de patrones `WorkWithPlus` vía `Genexus.Tasks.Patterns.targets`, inicialización de GAM (`connection.gam`), compilación y ejecución en `.NET` (Kestrel) y `Java` (Tomcat 10.1), y validación E2E con Playwright.
- **Principios que no se negocian:**
  1. Ninguna escritura sin cuestionamiento técnico previo, respaldo verificable y validación post-cambio.
  2. Todas las KB viven bajo `Projects/`; jamás se mezclan datos de negocio de un proyecto privado en el índice público general.
  3. Toda iteración que modifique el centro cierra sincronizando contexto, memoria e índice ([`docs/SINCRONIZACION_CANONICA.md`](docs/SINCRONIZACION_CANONICA.md)).

## Contribuir

Issues y pull requests son bienvenidos. Antes de proponer un cambio: ejecuta `npm test` en `x10guard/` y `npm run test:governance` y `npm run context:check` en la raíz (`npm run verify` y `context:validate` exigen evidencia local del propietario y fallan en un clon por diseño); no incluyas datos de KB, rutas ni nombres de tu equipo ([política de documentación](docs/POLITICA_DOCUMENTACION.md)); respeta la [organización de dos niveles](docs/ORGANIZACION_CANONICA.md).

---

<sub>**License and commercial use.** This project is released under the [Community License with Commercial Participation (CLCP) 1.0](LICENSE.md). Non-commercial use by individuals, learners, researchers and communities is free of charge. Commercial use in any for-profit project, product, service or internal operation requires a participation fee of 5% of the Total Invoiced Value of each covered engagement, to be agreed with the Licensor before production deployment. Provided "as is", without warranty. GeneXus is a trademark of GeneXus S.A.; this project is not affiliated with or endorsed by GeneXus S.A. All other trademarks belong to their respective owners.</sub>