Preparar un proyecto para agentes de IA no debería ser un ritual manual
Cada vez que arranco un proyecto nuevo pasa lo mismo. Antes de escribir la primera línea de código real, hay que sentarse a explicarle al agente de IA de turno cómo está armado todo: qué convenciones usa el repo, dónde vive cada cosa, qué reglas no se negocian. Es un ritual que se repite proyecto tras proyecto, y cada vez lo hago un poco distinto, un poco a mano, un poco de memoria.
Eso me hizo pensar que el problema no era mío en particular. Configurar CI/CD para un proyecto nuevo hace rato que dejó de ser opcional. Dejar un proyecto listo para que un agente de IA lo entienda debería tener el mismo estatus — no una improvisación cada vez, sino un paso de setup con la misma seriedad que cualquier otro.
Con esa idea armé un framework pensado para integrarse a cualquier
proyecto de desarrollo, sin importar el stack. La instalación puede ser
manual, con scripts automatizados (.bat para Windows, .sh para Linux y
Mac), o con un solo comando curl cuando querés la versión rápida.
Documenté soporte para 23 agentes de IA distintos — Copilot, Claude,
ChatGPT, Cursor, entre otros —, más de 15 bases de datos, y templates para
más de 7 configuraciones de MCP.
Nota
El objetivo no es "hablarle bien a la IA". Es dejar un proyecto en un estado donde cualquier agente — hoy o dentro de un año, con otro modelo — pueda entenderlo sin que alguien tenga que sentarse a explicarle todo de nuevo.
Para mostrarlo en acción armé un ejemplo concreto: BackupGuard Pro, un sistema ficticio de monitoreo de backups montado con Docker Compose, pensado específicamente para que el framework tuviera algo real sobre lo cual pararse — no un "hola mundo" vacío, sino un proyecto con piezas que interactúan entre sí.
El proyecto se propuso documentar 87 tecnologías con fuentes oficiales verificadas. No es un número que pueda reconfirmar hoy con la misma exactitud con la que lo escribí en su momento — pero sí puedo decir para qué estaba pensado: cada tecnología documentada debía tener detrás una referencia real, no una alucinación de modelo sobre cómo "probablemente" funciona tal o cual librería.
Dejás un proyecto sin CI/CD y aceptás que algo se va a romper en producción tarde o temprano. Dejás un proyecto sin preparar para agentes de IA y aceptás lo mismo, solo que en otra capa: cada agente nuevo va a improvisar su propio entendimiento del código, con la misma variabilidad — y el mismo riesgo — que cualquier configuración que nunca se documentó.
Publiqué esta idea originalmente en LinkedIn.