> ## Content Index > Fetch the complete content index at: https://jonathancanales.com/llms.txt > Use this file to discover other available public pages before exploring further. # Archivos que necesitas para vibe coding: dale contexto y orden a la IA - URL: https://jonathancanales.com/archivos-para-vibe-coding-contexto-y-orden/ - Published: 2026-10-05T14:00:00.000Z - Updated: 2026-10-19T01:02:28.000Z - Description: Si le pides a una IA «hazme una app» y nada más, la IA hace lo que haría cualquier persona contratada sin contexto: adivina. A veces adivina bien. Casi siempre adivina rápido y con mucha confianza, que es peor. - Author: Jonathan Canales - Tags: Tecnología y herramientas Archivos que necesitas para vibe coding: dale contexto y orden a la IA 0:00 /450 1× [![Escucha en Spotify](https://jonathancanales.com/content/images/2026/10/image-ebade917.jpg)](https://open.spotify.com/show/5cVfvljDnEEZ322kIJEs9Q?ref=jonathancanales.com) [Leer en inglés →](https://jonathancanales.com/en/files-for-vibe-coding-context-and-order/) Si le pides a una IA «hazme una app» y nada más, la IA hace lo que haría cualquier persona contratada sin contexto: adivina. A veces adivina bien. Casi siempre adivina rápido y con mucha confianza, que es peor. La solución no es un prompt más largo, sino unos cuantos archivos de texto que le digan qué estás construyendo, cómo y con qué reglas. Existe una lista de archivos para resolver justo esto. La idea me parece buena, así que aquí va mi versión en claro. Ojo: no es un estándar; es la práctica de una creadora de contenido, citada al final. Más abajo separo lo que de verdad es útil de lo que es opcional, y lo que las herramientas realmente hacen con esos archivos. El contexto de qué es el vibe coding y para quién sirve: [qué es vibe coding, cómo hacerlo bien y para quién](https://jonathancanales.com/que-es-vibe-coding-como-hacerlo-bien-y-para-quien/). ## La idea de fondo: memoria para alguien que olvida todo Las herramientas de programación con IA empiezan cada sesión casi en blanco. La documentación de Claude Code lo dice así: cada sesión arranca con una ventana de contexto nueva, y los archivos CLAUDE.md sirven para llevar instrucciones de una sesión a la otra. Piensa en un colaborador brillante con amnesia: cada mañana hay que dejarle una nota sobre la mesa. Esos archivos son la nota. Algunas de esas herramientas corren en tu propia computadora: [IA que programa en tu propia computadora: LLM locales](https://jonathancanales.com/ia-que-programa-en-tu-propia-computadora-llm-locales/). ## Los archivos, uno por uno La lista tiene estos documentos dentro de una carpeta `docs`. Te los resumo con lo que cada uno intenta resolver: - **PRD.md** (documento de requisitos del producto): qué se construye, para quién y qué problema resuelve. Es el «qué» y el «por qué». - **TRD.md** (requisitos técnicos): cómo debe funcionar técnicamente. En el ejemplo original lista tecnologías, objetivos técnicos, integraciones y restricciones. El «con qué». - **APP\_FLOW.md**: cómo se mueve el usuario por el producto, pantalla por pantalla. - **IMPLEMENTATION\_PLAN.md**: el orden de construcción en fases e hitos, con una etapa posterior al lanzamiento. - **TESTING.md**: cómo comprobar que todo funciona, con casos de prueba y una lista de verificación. - **BACKEND\_SCHEMA.md**: la estructura de los datos (qué se guarda y cómo se relaciona). - **README.md**: la portada del proyecto para humanos. - **AGENTS.md**: instrucciones directas para el agente de IA. - **DESIGN\_SYSTEM.md**: colores, tipografías y componentes, para que la interfaz no cambie de personalidad cada tres pantallas. - **ARCHITECTURE.md**: cómo está organizado el sistema por dentro. - **SECURITY.md**: reglas de seguridad, manejo de claves y datos. - **CODE\_STYLE.md**: convenciones de código. Doce archivos suenan a una oficina con mucho papeleo. Y aquí viene la parte importante. ## Lo que es requisito y lo que es costumbre Ninguna herramienta te obliga a tener esos doce nombres. Son la convención de la fuente citada al final, y una buena, pero convención al fin. Lo que sí existe como formato reconocido es más corto: - **AGENTS.md** es un formato abierto, descrito en agents.md como «un README para agentes»: un lugar predecible donde poner comandos de instalación, pruebas y reglas de estilo. Lo leen herramientas como Cursor, Aider, Amp, Gemini CLI, Zed, Windsurf y otras. - **CLAUDE.md** es el equivalente de Claude Code. Su documentación recomienda mantenerlo en menos de 200 líneas y específico: entre más largo, peor lo siguen. - **Reglas de Cursor** viven en la carpeta `.cursor/rules` y se pueden versionar junto con el proyecto. El resto (PRD, TRD, plan, esquema, etcétera) son documentos normales. Funcionan porque el agente puede leerlos cuando se los señalas o cuando tu archivo de instrucciones le dice que existen. No porque la herramienta los reconozca por el nombre. Esa diferencia importa: si crees que basta con soltar un PRD.md en una carpeta y la IA «ya sabe», te vas a llevar una decepción. 💡 Y una advertencia honesta de la propia documentación de Claude Code: estas instrucciones son contexto, no obligaciones. El modelo las toma en cuenta, pero no están garantizadas. Si necesitas que algo jamás ocurra, se pone como control técnico, no como una frase amable en un archivo. ## Un arranque razonable para un negocio pequeño Si vas a construir una herramienta interna o un prototipo, no empieces con doce archivos. Empieza con tres, y crece cuando duela: 1. **Un documento de producto corto** (tu PRD, una página): qué es, para quién, qué NO hará. Lo que no hará vale oro, porque la IA tiende a agregar cosas que nadie pidió. 2. **Un AGENTS.md o CLAUDE.md corto**: cómo se instala, cómo se prueba, qué convenciones seguir y qué cosas no tocar jamás. Pocas líneas, concretas. 3. **Un plan por fases**: construir en pedazos pequeños y revisables en lugar de «hazlo todo». Cuando el proyecto crezca, suma el resto según el dolor: ¿la IA inventa datos? Escribe el esquema. ¿La interfaz se ve distinta en cada pantalla? Escribe el sistema de diseño. ¿Se repite el mismo error? Eso va al archivo de instrucciones. La documentación de Claude Code da justo ese criterio: agrega una línea cuando la IA comete el mismo error por segunda vez. ![Dibujo estilo pizarrón: tres archivos conectados: qué construyo, cómo y reglas, orden por fases](https://jonathancanales.com/content/images/2026/10/3-vc-doodle-files-es-g.png) ## Cómo escribirlos sin que se vuelvan basura - **Breves y concretos.** «Usa TypeScript estricto y corre las pruebas antes de cerrar» sirve. «Escribe código de calidad» no sirve a nadie. - **Que los lea un humano.** Si tú no entiendes tu propio documento, la IA tampoco lo va a seguir mejor. - **Actualízalos.** Un plan viejo es peor que no tener plan: la IA lo obedece con total seriedad. - **Nada de claves ni contraseñas.** Estos archivos viajan con el código. Los secretos van en otro lado. - **Que la IA te ayude a redactarlos, pero tú decides.** Pedirle un primer borrador está bien; aceptarlo sin leerlo, no. ## Mi lectura La parte valiosa de esta lista no son los nombres de archivo. Es el hábito: antes de pedirle código a una IA, escribe qué quieres, cómo se va a construir y cómo sabrás que quedó bien. Eso es ordenar tu pensamiento, y le sirve igual a un programador humano que llegue al proyecto el mes que viene. Documentar da flojera hasta que descubres que ahora hay un lector que sí lo lee todo, cada vez, sin quejarse. Y si tu proyecto cabe en una página, con una página basta. Nadie ha ganado un premio por tener el PRD más largo. ## Fuentes y nota editorial Formato AGENTS.md: [agents.md](https://agents.md/?ref=jonathancanales.com). Memoria y archivos CLAUDE.md: [documentación de Claude Code](https://docs.claude.com/en/docs/claude-code/memory?ref=jonathancanales.com). Reglas de proyecto: [documentación de Cursor](https://cursor.com/docs/rules?ref=jonathancanales.com). La lista de documentos y sus descripciones sale de un reel de productwithzeey; son ejemplos de su flujo, no requisitos de ninguna herramienta.