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.

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

Related MCP server: mendix-mcp-server

Inicio rápido en 3 minutos

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.

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 y descubre las skills de .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, 01 — Plataforma y versiones y 02 — Modelado y semántica.

• 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, Skill gx-autonomous-kb y Skill gx-patterns-wwp-k2b.

• 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, Organización de dos niveles, Sincronización canónica, Arquitectura de x10 Guard y ADRs.

• 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

Qué hay dentro del repositorio

Lo que está verificado y los principios innegociables

• Verificado en el entorno de referencia (PRUEBA_NATIVA_2026-10-31.md, PRUEBA_E2E_2026-11-01.md, 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).

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); respeta la organización de dos niveles.

License and commercial use. This project is released under the Community License with Commercial Participation (CLCP) 1.0. 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.