La mayoría usa Claude Code con Power BI como un chat glorificado.
Le pegan un prompt enorme y esperan magia.
Ese es el error.
Si quieres que Claude Code trabaje como un consultor senior dentro de tu modelo, necesitas estructura.
No un CLAUDE.md de 200 líneas con instrucciones sueltas, sino un proyecto organizado como ingeniería de software.
Las 5 cosas que Claude necesita en todo momento
Para que Claude Code funcione de verdad con Power BI, necesita tener acceso permanente a cinco elementos clave.
1. El contexto
Qué modelo, para quién, qué negocio.
Claude necesita saber en qué proyecto está trabajando, quién es el cliente y cuál es el objetivo de negocio detrás de cada decisión de modelado.
2. El mapa
Arquitectura estrella, granularidad, relaciones.
Sin una visión clara de la estructura del modelo de datos, Claude no puede tomar decisiones coherentes sobre tablas, columnas o medidas.
3. Las reglas
Convenciones DAX, naming, patrones.
Cada proyecto tiene sus estándares. Si Claude no los conoce, generará código que técnicamente funciona pero que rompe la coherencia de tu modelo.
4. Los skills
Un SKILL.md por dominio: DAX, Power Query, TMDL, documentación.
Aquí es donde defines cómo quieres que Claude trabaje en cada área. No es lo mismo generar una medida DAX que refactorizar una consulta M o documentar un modelo semántico.
5. El diseño
Diagramas de tablas y bocetos del report.
Claude necesita ver la estructura visual del proyecto para proponer visualizaciones y layouts que encajen con lo que el cliente espera.
¿Y dónde vive todo esto? En un repositorio PBIP
Aquí es donde todo cobra sentido.
Los modelos de Power BI ya son archivos de texto. Se llama TMDL (Tabular Model Definition Language).
Cada tabla es un archivo .tmdl. Cada relación. Cada expresión M.
Todo es versionable con Git, todo es editable desde terminal.
Esto cambia el juego por completo.
Puedes pedirle a Claude que cree una tabla calculada, que refactorice una medida DAX o que documente el modelo entero.
Y lo hace respetando tus convenciones porque las tiene disponibles en la carpeta .claude/skills/ del repositorio.
La estructura completa del proyecto
En la imagen de arriba puedes ver la estructura completa que uso en mis proyectos con clientes reales.
Se divide en dos partes: la estructura del repositorio a la izquierda y los componentes clave a la derecha.
La raíz del proyecto contiene los archivos fundamentales: CLAUDE.md con el contexto del proyecto y README.md.
La carpeta documentacion/ incluye la arquitectura del modelo, las decisiones de diseño y las convenciones.
La carpeta .claude/skills/ contiene un archivo SKILL.md por cada dominio: DAX, Power Query, TMDL y documentación. Cada uno define patrones, estándares y formas de trabajar específicas.
El Modelo.SemanticModel/ es la estructura nativa PBIP con tablas, relaciones y expresiones en formato TMDL, editables directamente desde terminal.
La carpeta report/ contiene diagramas y bocetos de visualizaciones para que Claude sepa cómo debe quedar el resultado final.
Y scripts/ permite el despliegue automatizado al servicio de Power BI con CI/CD real para modelos semánticos.
Por qué este enfoque funciona
Llevo meses desarrollando modelos así para clientes reales.
Y no vuelvo atrás.
La diferencia entre usar Claude Code como un chatbot y usarlo como un verdadero asistente de ingeniería de datos está en la estructura que le proporcionas.
Cuando Claude tiene el contexto, el mapa, las reglas, los skills y el diseño, deja de ser una herramienta reactiva.
Se convierte en un colaborador que entiende tu proyecto. Genera código que respeta tus convenciones, propone soluciones alineadas con tu arquitectura y documenta de forma consistente.
No es magia. Es método, estructura y disciplina aplicados a la inteligencia artificial.
Deja un comentario