Artículos en Docs/Blog/*.md (fuente) y *.html (para WordPress/Blogger, generado con
node build-article.mjs <fichero>.md). Guiones de vídeo en video/guion.video.{en,es}.json.
Enlaces fijos: Sitio https://peopleworks.github.io/XAFLogicExplainer/ · Repo https://github.com/peopleworks/XAFLogicExplainer · NuGet https://www.nuget.org/packages/XafLogicExplainer.Cli
Nota sobre el público. Esto no es un lanzamiento de consumo como SignsOfAI. El lector es un desarrollador .NET con licencia de DevExpress y una aplicación XAF en producción, probablemente heredada. Es un público pequeño, técnico y muy concreto: el gancho es el dolor (el agente inventa) y no la novedad (otra herramienta de IA). Nada de exageraciones — este público las detecta.
Generadas con python site/build-covers.py, que las escribe en docs/assets/. No se editan a
mano: el guion produce las cuatro variantes de una sola definición, así que la portada no puede
decir una cosa y el artículo otra.
| Fichero | Tamaño | Dónde |
|---|---|---|
cover-en-wide.png, cover-es-wide.png |
1000×420 | dev.to (ya puesto en cover_image) |
cover-en.png, cover-es.png |
1200×630 | LinkedIn, Open Graph, cabecera del blog propio |
cover-*.svg |
vector | blog propio, si sirve SVG |
Dos proporciones porque cada sitio recorta distinto: dev.to recorta a 1000×420 y se comería la línea de instalación de la versión alta. PNG para dev.to y LinkedIn, que no aceptan SVG.
La portada dice Invoice.TotalAmount frente a Invoice.Total — que es el ejemplo con el que abre
el artículo. Si se reescribe esa apertura, hay que cambiar COPY en el guion; el mismo fallo que
tendría un pie de figura desactualizado, solo que en la imagen que más gente ve.
El cover_image del frontmatter apunta a raw.githubusercontent.com, así que las imágenes
tienen que estar en main antes de publicar o dev.to mostrará el artículo sin portada.
1. ARTÍCULO — Inglés (xaflogic-hidden-behaviour-story.en.md)
Título: Your coding agent knows XAF. It has never seen your application.
Dónde publicar, por orden de valor:
- DevExpress Support Center / blogs de la comunidad XAF — es donde está el público exacto. Publicar como aporte de la comunidad, dejando claro desde la primera línea que el proyecto complementa el tooling oficial de DevExpress y no compite con él. La tabla de tres filas hace ese trabajo sola.
- dev.to con las etiquetas
dotnet,devexpress,ai,showdev. - LinkedIn (artículo completo, no enlace: LinkedIn penaliza los enlaces salientes).
- Blog propio, como
canonical_url. Poner el canónico en dev.to y LinkedIn para no competir consigo mismo en buscadores.
Resumen para redes (280 caracteres):
Your AI assistant can recite the XAF docs and still invent a property your class doesn't have.
It knows XAF. It's never seen YOUR XAF. So I built the missing piece — free, MIT, no DevExpress
licence needed to run it.
2. ARTÍCULO — Español (xaflogic-hidden-behaviour-story.es.md)
Título: Tu agente de código sabe XAF. Nunca ha visto tu aplicación.
Escrito en español, no traducido. Los dos artículos comparten estructura y argumentos, pero ninguna frase es una traducción de la otra — igual que el pack de español de SignsOfAI.
Dónde publicar: blog propio, LinkedIn en español, y los grupos hispanohablantes de DevExpress/XAF. En España y Latinoamérica hay muchísimo XAF en producción y prácticamente ningún contenido técnico sobre XAF en español: es la ventaja competitiva más barata que tenemos.
Resumen para redes (280 caracteres):
Tu asistente de IA te recita la documentación de XAF y aun así referencia una propiedad que tu
clase no tiene. Sabe XAF. No ha visto TU XAF. Construí la pieza que falta: gratis, MIT, y para
usarla no hace falta licencia de DevExpress.
python docs/Blog/video/build-scenes.py escribe las once escenas de cada idioma en
video/scenes/<lang>/, más un póster PNG de cada una en video/posters/ para poder juzgar
un cambio de texto sin renderizar. Con --video saca los mp4 (no se commitean: se rehacen).
Dos clases de escena, y la diferencia es el proyecto entero:
- Escenas de argumento (01, 02, 03, 09, 11) — dibujadas, porque no hay nada real que filmar.
- Escenas de evidencia (07, 10) — la salida real de
xaflogic explainsobre el fixturePharmacyDemo, capturada y recorrida. Maquetar el informe se vería mejor y valdría menos. - Escenas de código (04, 05, 06, 08) — el código se lee de los ficheros del fixture al construir, anclado por texto. Si el fixture cambia, o la escena sigue cuadrando o falla el build; nunca enseña líneas equivocadas en silencio.
Tres cosas fallan la construcción a propósito, y las tres han saltado ya:
- Narración que no cabe. Por encima de 225 palabras/minuto no es una elección de ritmo, es una toma inservible — y enterarse después de grabar cuesta una sesión de grabación.
- Contenido fuera del cuadro. Un fotograma recorta en silencio y en vídeo nadie hace scroll.
- Números inventados. La cifra de pruebas de la escena 08 se lee del README, que tiene un test que la mantiene cierta.
El tiempo de cada escena sale de la voz, no al revés. --narrate graba con ElevenLabs, con
la voz que nombra el guion, y se salta lo ya grabado (se factura por carácter). Luego --retime
mide las tomas con ffprobe y esa duración manda; imprime los capítulos ya calculados.
python docs/Blog/video/build-scenes.py --narrate # Rachel / Marcela, ~5.600 caracteres
python docs/Blog/video/build-scenes.py --retime # duraciones y capítulos desde el audio
python docs/Blog/video/build-scenes.py --video --assemble
La clave sale de ELEVENLABS_API_KEY o de video/.elevenlabs.key (ignorado por git). Rachel ya
no aparece en el listado de voces de la cuenta — ElevenLabs escondió las «premade» — pero sigue
funcionando por ID, que es lo que hace el guion. Marcela sí está en la biblioteca.
Imagen y sonido se montan por separado y se casan al final. Lo natural sería muxear cada
escena con su toma y luego concatenar: eso perdía segundo y medio por escena, porque apad
rellena con silencio el hueco entre la toma y su escena, y concatenar las pistas AAC con
-c copy recorta justo ese relleno. Once escenas después, la voz terminaba diecisiete segundos
antes que la imagen — y cada segmento medido por separado salía correcto. Ahora el sonido se
construye una vez en PCM, y --assemble falla si la pista no llega al final del vídeo.
Título:
Your AI agent knows XAF but has never seen YOUR app | XAF Logic Explainer — free & open source
Descripción (pegar tal cual):
Ask your AI assistant to add a rule to Invoice and it writes perfect XAF — then references a property your class doesn't have. It isn't hallucinating XAF. It knows XAF. It has never seen yours.
DevExpress already ships agent skills for how the framework works, and a docs MCP server for the reference. Neither has read a line of your codebase. XAF Logic Explainer is the third piece: it reads YOUR application with Roslyn and hands the result to whatever agent you code with.
It never compiles your project and never references a DevExpress assembly — so it works on a branch that doesn't build, and needs no DevExpress licence to run.
It also extracts the parts that aren't in your business classes at all: Model Editor (.xafml) customizations, custom property editors and the JavaScript they depend on, built-in editors reconfigured at run time, and version-gated migrations that run at most once per database.
And it answers a question nothing in an XAF repository answers: what runs when you open a screen. XAF generates a list, a detail and a lookup view for every business class, so the screens are in no file either — and which controllers load onto one is four conditions the framework evaluates at run time.
Free and open source (MIT). Built with .NET 10.
▶ How it works: https://peopleworks.github.io/XAFLogicExplainer/
⭐ Code: https://github.com/peopleworks/XAFLogicExplainer
📦 dotnet tool install -g XafLogicExplainer.Cli
CHAPTERS
00:00 It knows XAF, not your XAF
00:21 DevExpress closed part of the gap
00:36 Two minutes: AGENTS.md, CLAUDE.md, Copilot
00:52 Where behaviour actually hides
01:06 Custom editors, and their JavaScript
01:25 Migrations that run once per database
01:49 What runs when you open a screen
02:16 Roslyn: no compile, no licence
02:32 Why most docs are NOT in AGENTS.md
02:52 The domain map nobody has seen
03:10 Try it on your application
#DevExpress #XAF #dotnet #AI #OpenSource
Etiquetas / Tags (bloque para YouTube):
xaf, devexpress, devexpress xaf, expressapp framework, xpo, ef core, dotnet, .net 10, roslyn, mcp, model context protocol, ai coding agent, claude code, github copilot, agents.md, legacy code, code documentation, xafml, model editor, view controller, open source
Título:
Tu agente de IA sabe XAF pero no conoce TU app | XAF Logic Explainer — gratis y open source
Descripción (pegar tal cual):
Le pides a tu asistente de IA que añada una regla a Invoice y escribe XAF impecable — y entonces referencia una propiedad que tu clase no tiene. No está alucinando XAF. Sabe XAF. Lo que nunca ha visto es el tuyo.
DevExpress ya publica skills para enseñar cómo funciona el framework, y un servidor MCP con la documentación. Ninguno ha leído una línea de tu código. XAF Logic Explainer es la tercera pieza: lee TU aplicación con Roslyn y le entrega el resultado al agente con el que programes.
Nunca compila tu proyecto y nunca referencia un ensamblado de DevExpress — así que funciona en una rama que no compila, y para usarlo no hace falta licencia de DevExpress.
Además extrae lo que no está en las clases de negocio: personalizaciones del Model Editor (.xafml), editores de propiedad propios y el JavaScript del que dependen, editores integrados reconfigurados en tiempo de ejecución, y las migraciones con versión que se ejecutan como mucho una vez por base de datos.
Y responde una pregunta que nada en un repositorio XAF responde: qué se ejecuta cuando abres una pantalla. XAF genera una vista de lista, una de detalle y una de búsqueda por cada clase de negocio, así que las pantallas tampoco están en ningún archivo — y qué controladores se cargan en una son cuatro condiciones que el framework evalúa en tiempo de ejecución.
Gratis y de código abierto (MIT). Hecho con .NET 10.
▶ Cómo funciona: https://peopleworks.github.io/XAFLogicExplainer/
⭐ Código: https://github.com/peopleworks/XAFLogicExplainer
📦 dotnet tool install -g XafLogicExplainer.Cli
CAPÍTULOS
00:00 Sabe XAF, pero no tu XAF
00:22 DevExpress cerró parte de la brecha
00:37 Dos minutos: AGENTS.md, CLAUDE.md, Copilot
00:56 Dónde se esconde el comportamiento
01:10 Editores propios, y su JavaScript
01:30 Migraciones: como mucho una vez por base de datos
01:59 Qué se ejecuta cuando abres una pantalla
02:33 Roslyn: sin compilar, sin licencia
02:50 Por qué la mayoría de la documentación NO está en AGENTS.md
03:09 El mapa de dominio que nadie ha visto
03:31 Pruébalo en tu aplicación
#DevExpress #XAF #dotnet #IA #OpenSource
Etiquetas / Tags:
xaf, devexpress, devexpress xaf, xpo, ef core, dotnet, .net 10, roslyn, mcp, agentes de ia, claude code, github copilot, documentacion de codigo, codigo heredado, xafml, model editor, view controller, open source, programacion en español
Mismo patrón que SignsOfAI: HTML animado con CSS, sin narración salvo donde se indique, texto grande y una sola idea por short. Cada uno debe entenderse sin sonido.
Construidos con python docs/Blog/video/build-shorts.py (--video para los mp4), en los dos
idiomas, a partir de estos guiones. Comparten paleta y animaciones con el vídeo largo a través de
scene_kit.py: un short que no case con la película que promociona parece de otro.
Lo específico del formato vertical es la banda segura. TikTok, Reels y Shorts ponen su propia interfaz sobre la parte de arriba y la de abajo, así que nada legible sale de los 300 px superiores ni de los 400 inferiores — y el chequeo de desbordamiento mide contra esa banda, no contra el fotograma. Ya cazó el short 5 metiéndose 40 px por debajo.
Los números del short 8 (14 clases → 54 pantallas) se cuentan en el informe al construir, no se escriben aquí. El short 3 y el 4 muestran código y rutas reales del fixture.
[0.0s] Prompt en pantalla: "Add a validation rule to Invoice"
[1.5s] Aparece código XAF, impecable, línea a línea
[4.0s] Se resalta en rojo: Invoice.TotalAmount
[5.5s] Debajo, en verde: tu clase tiene → Total
[7.5s] Texto grande: No está alucinando XAF.
[9.0s] Sabe XAF. No ha visto EL TUYO.
[11.0s] Pills: Gratis · MIT · Sin licencia DX
El más importante. Es el único short que debería promocionarse pagando, si se paga alguno.
[0.0s] Tres filas apareciendo una a una, las dos primeras en gris:
Cómo funciona XAF → DevExpress agent-skills ✓
Qué dice la documentación → DevExpress Docs MCP ✓
[4.5s] La tercera entra en naranja, con retardo:
Qué hace TU aplicación → ¿?
[7.0s] Se rellena: XAF Logic Explainer
[9.0s] Texto: Se complementan. Ninguna sustituye a las otras.
[0.0s] Bloque de código: if (CurrentDBVersion < new Version("1.1.0.0"))
[2.0s] Sello girado encima: SE EJECUTÓ UNA VEZ
[4.0s] Texto: En la base de datos de producción de alguien. Hace tres años.
[6.5s] Pregunta: "¿por qué esta columna tiene ese valor?"
[8.5s] Respuesta del agente, tachada: se lo inventa
[10.5s] La ficha real de la herramienta, con el comentario del bloque resaltado
[12.5s] Texto: El comentario suele ser el único registro del porqué.
[0.0s] Árbol de la solución:
MiApp.Module/BusinessObjects/Product.cs ← estás leyendo aquí
MiApp.Blazor.Server/Editors/Barcode...cs ← el comportamiento está aquí
[4.0s] Flecha entre los dos, en naranja
[6.0s] Texto: Una propiedad string que se pinta como un escáner.
[8.0s] Texto: Y el JavaScript sin el que no funciona.
[10.0s] Texto: Ni en C#. Ni en XML.
[0.0s] El GIF del mapa de dominio, a pantalla completa (docs/assets/domain-map.gif)
[7.0s] Texto sobreimpreso: La mayoría de los equipos nunca ha visto el suyo.
[9.5s] Texto: Vive en la cabeza de una persona.
[11.0s] Texto, en naranja: Justo el conocimiento que se va cuando esa persona se va.
El más compartible. El movimiento del mapa retiene sin necesidad de leer nada.
[0.0s] Terminal: git checkout feature/rota
[1.5s] Salida de build en rojo: 47 errors
[3.5s] Terminal: xaflogic agents --project ...
[5.0s] Salida en verde: ✓ AGENTS.md · CLAUDE.md · copilot-instructions.md
[7.0s] Texto: Nunca compila tu proyecto.
[9.0s] Texto: Roslyn lee el código como texto.
[0.0s] Barra de contexto llenándose de gris hasta el 90%: "documentación volcada"
[3.0s] Texto: Se lee en CADA petición. Para siempre.
[5.0s] La barra se vacía a un 11% naranja: "índice"
[7.0s] Debajo, en gris claro: "70 KB, solo si hacen falta"
[9.0s] Texto: Lo más pequeño es lo que más pesa: si no está en la lista, no existe.
[0.0s] Terminal: grep -r "Patient_Prescriptions_ListView" .
[2.0s] Debajo, en gris: (sin resultados)
[3.5s] Texto grande: Y sin embargo tus usuarios la abren todos los días.
[6.0s] Contador subiendo: 14 clases → 54 pantallas
[8.0s] Debajo: ninguna escrita en ningún archivo
[10.0s] Corte a la sección Screens del informe, con DispenseController resaltado
[12.5s] Texto: Y 30 más que pone XAF. Ahora sabes cuáles.
El único short que necesita una captura real del informe. Los 12 primeros segundos funcionan enteros sin sonido, que es la prueba que importa.
Publicado el 2026-08-13, en los blogs propios. Estos son los canónicos definitivos:
| URL | |
|---|---|
| EN | https://peopleworksgpt.com/your-coding-agent-knows-xaf-it-has-never-seen-your-application/ |
| ES | https://peopleworks.com.do/2026/08/13/tu-agente-de-codigo-sabe-xaf-nunca-ha-visto-tu-aplicacion/ |
Están puestos en el canonical_url de cada .md y enlazados desde el README y desde el README
del paquete MCP. Dominios distintos: el inglés en peopleworksgpt.com, el español en
peopleworks.com.do — copiar el de al lado es el error fácil.
Al republicar en dev.to o LinkedIn, el canónico tiene que ser esa URL exacta. Un rel="canonical"
que apunta a una página que no existe es peor que no poner ninguno: el buscador descarta la copia
sin que el original gane nada.
Artículo en inglés en el blog propio (fija el✅canonical_url).- Short 1 en LinkedIn/X/YouTube Shorts, enlazando al artículo.
Artículo en español, 2–3 días después, para no solapar audiencias.✅ (mismo día, al estar en dominios y audiencias separadas)- Vídeo grande EN, enlazado desde el README y desde los dos artículos.
- Shorts 3 y 5 repartidos en la semana siguiente. El 5 es el más compartible.
- Vídeo grande ES.
- Hilo en el Support Center de DevExpress al final, cuando ya haya artículo y vídeo que enlazar. Ahí el tono cambia: menos lanzamiento, más «esto es lo que faltaba y aquí lo tenéis».
- No «reemplaza a las herramientas de DevExpress». Las complementa, y decirlo mal quema el único canal de distribución que de verdad importa.
- No «entiende tu aplicación». Extrae lo que tu aplicación declara. La diferencia es la honestidad entera del proyecto.
- No presumir de 1.0. Está en 0.x a propósito, y el artículo lo dice: el 1.0 se gana cuando haya leído código que no escribimos nosotros.
- No usar nombres de clientes en capturas ni en ejemplos. Todo el material visual sale de la aplicación demo sintética del repositorio. En vídeo esto es más delicado que en una imagen: un nombre de entidad se cuela en un fotograma y ya está publicado.
- No dar cifras que no salgan del repositorio ese día. Tests, herramientas y versión cambian cada release, y publicar un número viejo es exactamente el fallo que el artículo denuncia. Al grabar, comprobarlas contra el README, que sí tiene tests que lo obligan.