Los 12 archivos que le doy a la IA antes de pedirle una línea de código

Cuando le pedís a la IA que te construya algo sin darle contexto, te devuelve lo que le devuelve a todos: la misma landing con las mismas secciones, el mismo tono, la misma cara de plantilla. No es que la IA no sepa. Es que no le dijiste quién sos. El resultado sale del criterio que le pasás como contexto, y estos doce archivos son ese criterio, escrito una vez y listo para pegar.

Los cinco de la marca son el quién. BRAND.md define paleta, tipografía, personalidad y voz. CONTENT.md ordena qué dice el sitio: headlines, bio, proyectos, stack y CTAs. DESIGN.md fija el criterio visual. REFERENCES.md le muestra a qué querés parecerte y, más importante, a qué no. Y SITEMAP.md traza la arquitectura: qué páginas hay, en qué orden van las secciones y cómo se navega.

Los cuatro del sistema visual son el cómo se ve. tokens.md guarda los valores exactos, que es la diferencia entre pedir "un gris" y pedir un color que ya está decidido. components.md define la estructura y los estados de cada componente, para que no termines con cinco botones distintos. layout.md fija el grid y el ritmo de las secciones, que es lo primero que delata una web hecha con IA. Y motion.md decide cuándo algo se mueve, porque sin esa regla la IA anima todo.

Los tres últimos son los que casi nadie escribe y los que más cambian el resultado. La plantilla de CLAUDE.md o AGENTS.md lleva las reglas que no se rompen y los errores que tu agente ya cometió, y la lee sola en cada sesión. PLAN.md ordena qué se construye, en qué orden, qué edge cases existen y, sobre todo, qué no se construye. Y el .env.example es la lista de todo lo que el proyecto necesita para arrancar, que es lo que separa "corre en mi máquina" de "corre".

Ese es el punto de fondo y no depende de ninguna herramienta: la IA es un ejecutor extraordinario y un decididor mediocre. Si le pasás las decisiones, te devuelve promedio. El modelo va a cambiar el mes que viene y estos doce archivos van a seguir sirviendo igual, porque no son sobre IA: son tu criterio, escrito.