Llevamos más de un año integrando IA en el trabajo real del estudio, no como juguete sino como herramienta que escribe código, redacta contenidos, analiza datos, genera propuestas, audita webs y mueve operaciones. Y hay una lección que se ha vuelto inapelable: el archivo que vale más que cualquier prompt es el que documenta tu contexto. No el prompt estrella, no la cadena de razonamiento más elaborada, no la última técnica viral de LinkedIn: el archivo donde está escrito quién eres, cómo trabajas, qué errores has cometido ya y qué decisiones te importan. Lo vemos pasar en comunidades de desarrolladores que usan Claude Code con un CLAUDE.md bien cuidado, y lo confirmamos todos los días en nuestro propio estudio. Este artículo explica por qué, cómo construir ese archivo para tu negocio (no solo para código) y qué hace que funcione y qué no.
El problema: repetirte es caro y silencioso
Cuando empiezas a trabajar con IA, cada conversación arranca desde cero. Le explicas quién eres, qué haces, qué quieres, cómo hablas, qué tono usas, qué clientes tienes, qué errores no quieres volver a cometer. La primera vez tiene sentido; la segunda, da pereza; la centésima, dejas de explicarlo y el resultado empieza a degradarse sin que te des cuenta.
Este coste es silencioso por definición. No hay un error que salte a la vista: simplemente los resultados son genéricos. El tono no acaba de ser el tuyo, las decisiones no se alinean con cómo trabajas, los ejemplos no reflejan tu realidad, las propuestas son de libro en vez de estar adaptadas a tu contexto. Y como es gradual, lo normalizas. Piensas que la IA “es así” cuando en realidad es que no le estás dando lo mínimo para que sea tú.
La gente de la comunidad de Claude Code lleva meses haciendo ruido con una idea muy concreta: antes de añadir más agentes o más herramientas, arregla tu archivo de contexto. El 70% de los problemas que la gente intenta resolver con más infraestructura se resuelven con un documento de contexto bien escrito. Es el consejo más infravalorado del año y lo hemos visto funcionar en nuestra propia operación.
Qué es un archivo de contexto (y por qué da igual cómo lo llames)
En el mundo del desarrollo lo llaman CLAUDE.md, CODEX.md, AGENTS.md o similares. Fuera del desarrollo puedes llamarlo como quieras: contexto_empresa.md, sobre_nosotros.txt, brief_ia.md. El nombre no importa. Lo que importa es que sea un documento único, vivo, al que puedes apuntar cada conversación nueva con IA para que arranque con la información que necesita sin que tú la repitas. Técnicamente: es lo que pegas al principio o referencias al principio de cualquier prompt complejo.
Un archivo de contexto no es un manual, ni un FAQ, ni una guía corporativa. Es algo más útil y más sucio: es el resumen brutalmente sincero de quién eres, cómo trabajas y qué errores no quieres volver a cometer. Cuanto más honesto y específico, mejor funciona. Cuanto más corporativo y genérico, peor.
Los 7 bloques que componen un archivo de contexto útil
Qué debe contener un archivo de contexto que funciona
Hemos probado muchas estructuras y hemos descartado muchas. Esta es la estructura que nos funciona a nosotros y que recomendamos a los clientes que empiezan a trabajar con IA seriamente. No es larga; se suele quedar entre 800 y 2.500 palabras. Más allá, empieza a diluirse.
1. Identidad en dos líneas
Quién eres tú y qué haces, en la forma más compacta posible. No hace falta escribir un párrafo poético: una frase sobre la persona o el negocio, una frase sobre a quién sirve. Esto ancla cada respuesta al contexto correcto sin rodeos.
2. Cómo hablas (tono y voz)
Este bloque es fundamental y casi nadie lo pone. Ejemplos cortos de frases que sí usas, frases que no usas, palabras prohibidas, cómo son tus titulares, qué estructura tienen tus posts, si usas ironía o no. Si escribes con irreverencia, escríbelo con irreverencia en el propio archivo: el modelo copia el estilo del documento. Si el documento es corporativo, las respuestas serán corporativas.
3. Qué clientes atiendes y cómo hablan ellos
El contexto más útil para salidas prácticas: qué tipo de cliente, qué problemas reales tienen, cómo te los cuentan en conversación, qué les importa y qué no les importa. Esto convierte respuestas genéricas en respuestas aplicables a tu realidad inmediata.
4. Decisiones que ya has tomado (y no quieres reconsiderar)
Este es probablemente el bloque que más te ahorra tiempo. Un listado corto de decisiones que son fijas: qué tecnología usas, qué servicios ofreces, qué servicios no ofreces, qué canales sí y cuáles no, qué precios, qué condiciones. Sin esto, cada conversación con IA acaba debatiendo cosas que tú ya tienes resueltas.
5. Errores típicos que no quieres repetir
Este es el bloque de lecciones. Cada vez que la IA te da una respuesta que no encaja, en vez de frustrarte, añade una línea al archivo explicando qué fue mal y por qué. En unas semanas este bloque se convierte en tu mejor protección contra errores recurrentes. Es literalmente aprender de las veces que no salió bien.
6. Cómo quieres que te responda
Preferencias de formato. Listas sí o no. Longitud preferida. Idioma. Nivel de detalle. Si prefieres respuestas directas y crudas o explicaciones paso a paso. Si quieres que te contradiga cuando considere que te equivocas o que asuma que tienes razón. Este bloque calibra todo.
7. Lo que NO quieres que haga
Tan importante como lo que sí. Acciones o actitudes específicas que has visto que la IA tiende a hacer y no te funcionan: añadir disclaimers innecesarios, rellenar con palabras vacías, proponer 5 opciones cuando pides 1, ser servil en vez de honesto, recomendar herramientas de moda sin evaluarlas para tu contexto. Cada uno tiene su lista; tu lista debe ser específica a tu experiencia.
Cómo construir el tuyo en 2 horas
No hace falta planificar ni contratar consultores. El archivo útil se escribe en 2 horas con esta secuencia concreta. Si te tomas más es que estás sobrepensándolo.
Paso 1: empieza por los errores (25 minutos)
Abre una página en blanco y lista todas las veces que la IA te ha dado una respuesta que tuviste que corregir en las últimas 4 semanas. De cada una, anota qué pediste, qué te dio y por qué no funcionaba. Esta lista ya es el corazón del archivo: tus aprendizajes reales. No teórico, no aspiracional: lo que ya ha pasado y ha costado tiempo.
Paso 2: identidad y voz (20 minutos)
Escribe 2 frases sobre ti o tu negocio. Después, 10 frases de ejemplo que representen tu tono real: pueden ser extractos de emails reales, de posts tuyos, de respuestas a clientes. Literal. No “intenta escribir como…” sino “aquí tienes 10 ejemplos de cómo yo escribo”. El contraste con texto genérico es abismal.
Paso 3: decisiones fijas (20 minutos)
Lista de 10-15 decisiones no-negociables sobre tu operación. Servicios que ofreces, que no ofreces, tarifas base, con qué tipo de cliente trabajas, con cuál no, condiciones de pago, plazos típicos. Todo lo que ya has resuelto y no quieres renegociar cada conversación.
Paso 4: preferencias de output (15 minutos)
Cómo quieres las respuestas. Longitud. Formato. Idioma. Nivel de detalle. Honestidad. Si prefieres opciones o propuestas cerradas. Si quieres ejemplos concretos o marcos conceptuales. Lo que te haga la vida más fácil, no lo que suena mejor.
Paso 5: prohibiciones (15 minutos)
Lista de 5-10 cosas que no quieres que haga. Sé específico: “no añadas disclaimers al final del texto”, “no me preguntes si quiero que desarrolle cuando ya he pedido el desarrollo”, “no me propongas 5 opciones, propón 1 con criterio”. Cada prohibición concreta vale más que un párrafo de buenos deseos.
Paso 6: prueba inmediata (25 minutos)
Coge una tarea real que tenías pendiente y hazla con IA usando el archivo nuevo. Compara con cómo te quedó sin archivo. Ajusta el archivo con lo que hayas aprendido. Repite con 2 o 3 tareas más. En la tercera ya tendrás una versión que te funciona y que vas a querer mantener.
Los errores típicos al construir el archivo
Hemos visto (y cometido) estos errores. Si los evitas, te ahorras bastante frustración.
- Escribirlo como un documento corporativo. La mitad de la gente empieza con “Somos una empresa líder en…” y ya ha perdido la partida. Eso no le da contexto útil a la IA: le da ruido promocional. Escríbelo como si se lo contaras a un nuevo empleado que empieza mañana.
- Intentar cubrirlo todo. Un archivo de 15.000 palabras no es útil: diluye la información importante. Los archivos que funcionan son ajustados y específicos. Si algo no te importa que la IA sepa, no lo pongas.
- No actualizarlo nunca. El archivo es vivo. Cada vez que la IA te da una respuesta incorrecta por falta de contexto, deberías añadir la línea que faltaba. Un archivo que no se actualiza en 2 meses está muerto en la práctica.
- Ser aspiracional en vez de real. “Trabajamos con los mejores clientes de la industria” no ayuda. “Nuestros clientes suelen ser pymes de 5-20 personas con presupuesto entre X e Y euros y problemas concretos de tipo Z” sí ayuda. La realidad vale más que la aspiración.
- Ponerle información sensible sin cuidado. No pongas contraseñas, datos bancarios, información personal de clientes u otros secretos. El archivo lo vas a compartir con una herramienta IA y, aunque muchas respetan la privacidad, el principio es: no guardes ahí nada que te doliera ver filtrado.
Aplicaciones concretas más allá del código
El concepto se originó en el mundo del desarrollo (CLAUDE.md para Claude Code, AGENTS.md para GitHub Copilot), pero la idea es perfectamente transferible a cualquier trabajo que uses con IA. Algunas aplicaciones que nosotros usamos o hemos implementado para clientes:
- Marketing digital de una pyme. Archivo con tono de marca, servicios, clientes tipo, errores pasados en comunicación, plantillas de email habituales, decisiones sobre canales. La IA redacta emails y posts coherentes sin que tengas que revisar cada palabra.
- Consultoría comercial. Archivo con propuesta de valor, objeciones típicas, tarifas, estructura de propuesta comercial, condiciones no-negociables. La IA genera propuestas adaptadas a cada prospecto sin salirse del marco.
- Atención al cliente. Archivo con tono, políticas de reembolso, escalado a humano, fraseos permitidos y prohibidos, clientes VIP con tratamiento especial. La IA responde a clientes manteniendo la coherencia de marca.
- Redacción de contenido. Archivo con estilo editorial, estructura de artículo, fuentes preferidas, tipografía de títulos, palabras prohibidas, enlaces internos habituales. Los artículos salen parecidos entre sí sin perder la voz.
- Gestión de operaciones. Archivo con procedimientos fijos, responsables por área, formatos de reporte, plantillas de reunión, decisiones operativas no-negociables. La IA asiste en el trabajo de coordinación sin reinventar la rueda cada día.
En todos estos casos, el archivo es la pieza clave: con él, la IA es tu copiloto real. Sin él, es un asistente genérico más.
Por qué un archivo vale más que prompts elaborados
Una tentación constante es invertir tiempo en prompts cada vez más sofisticados: cadenas de razonamiento, role-playing, instrucciones de paso a paso, “think step by step” y similares. Todo esto tiene su momento, pero para trabajo repetido es una trampa: escribes el mismo prompt elaborado una y otra vez, cuando lo que necesitas es que el contexto ya esté asumido y el prompt sea corto y directo.
Un archivo bien escrito + un prompt corto y claro rinde casi siempre mejor que un prompt elaborado sin archivo. Y no solo rinde mejor: te ahorra escribir. Con el archivo de contexto, prompts de una línea dan respuestas que antes necesitaban 10 líneas de setup. El retorno sobre el tiempo invertido es enorme.
Cómo mantener el archivo vivo sin que se convierta en otra carga
La tentación es dejar de mantenerlo. Al principio lo escribes con entusiasmo, lo usas unos días, y luego se queda en el mismo estado durante meses aunque hayas aprendido cosas nuevas. Para evitarlo, dos rutinas sencillas:
- Regla de la corrección. Cada vez que corriges a la IA una respuesta, te obligas a añadir una línea al archivo explicando qué habría hecho falta saber. No es opcional: se hace en el mismo momento. Si te da pereza, no lo hagas, pero acepta que el archivo se va a quedar desactualizado.
- Revisión cada 30 días. Una vez al mes, abres el archivo, le echas 15 minutos y quitas cosas obsoletas, reformulas las que ya no suenan bien, añades lo nuevo. Con 15 minutos al mes mantienes una herramienta que te ahorra horas todas las semanas.
Si estas dos rutinas te parecen demasiado, el archivo no es tu prioridad y probablemente la IA no esté jugando un papel importante en tu día a día. Está bien saberlo: no todos los negocios están en el mismo punto.
Cómo lo aplicamos en Gecko Studio
Para transparencia: nosotros mantenemos varios archivos de contexto por área de trabajo. Uno para auditorías SEO (con decisiones metodológicas, tipos de informes, estructura de entregables, errores pasados típicos), uno para redacción de contenidos (con voz de marca, pilares editoriales, plantillas), uno para comunicación con clientes (con tono, tiempos de respuesta, fraseos) y uno para operaciones internas (con procedimientos, responsables, decisiones fijas). Los revisamos cada pocas semanas y los usamos como primer contexto en cualquier trabajo con IA. Esto es parte de lo que hace que nuestras salidas sean consistentes, que los resultados se parezcan entre sí y que la IA no deshaga en 10 minutos lo que costó semanas construir en términos de identidad y criterio.
Si estás montando un proyecto que depende de IA para cualquier capa de su operación y quieres plantearlo con criterio desde el principio, en Gecko Studio ayudamos a diseñar esa base. No es un servicio tradicional ni está en el catálogo: es algo que hacemos a medida porque es relativamente nuevo y cada negocio tiene su matiz. Lo importante es que empieces por el archivo antes que por la infraestructura: es más barato y más eficaz.
Cómo escribir tu archivo de contexto para IA esta misma tarde
Si usas IA con frecuencia en tu trabajo, tu archivo de contexto para IA es la pieza con mejor retorno por hora invertida que puedes construir hoy. La regla práctica es brutal: bloquea dos horas esta tarde, no mañana. En la primera hora, lista los 10 últimos errores que has tenido que corregir a un modelo (con qué pediste, qué te dio, qué faltaba) y escribe 10 frases reales tuyas que representen tu tono. En la segunda hora, enumera 15 decisiones fijas de tu operación (servicios que sí, servicios que no, tarifas, clientes tipo) y 10 prohibiciones concretas sobre cómo quieres que te responda. Eso es tu v1.
El paso crítico es la prueba inmediata: coge una tarea real pendiente, ejecútala con IA usando el archivo nuevo y compara con cómo te quedaría sin él. La diferencia va a ser visible en la primera comparación y vas a querer mantener el archivo actualizado. Mantenlo con dos rutinas simples: cada vez que corrijas una respuesta, añade una línea explicando qué faltaba saber, y cada 30 días dedica 15 minutos a revisar y quitar lo obsoleto. Con esto, la IA deja de ser un asistente genérico y pasa a trabajar dentro de tu criterio, tu tono y tus decisiones ya tomadas. El resto de la infraestructura (prompts elaborados, agentes especializados, flujos complejos) es accesorio comparado con esto.
