Qué hace realmente un archivo CLAUDE.md
Si usas Claude Code o Claude Projects, ya sabrás que Claude no recuerda nada entre conversaciones. Cada sesión comienza desde cero. Terminas reexplicando la estructura de tu proyecto, el tono que prefieres, quiénes son tus clientes, qué herramientas usas. Un archivo CLAUDE.md resuelve exactamente ese problema.
El archivo vive en la raíz de tu proyecto o se pega en las instrucciones de un Proyecto de Claude. Claude lo lee al inicio de cada sesión. Cuando está bien construido, Claude ya sabe:
- Qué es el negocio o proyecto y a quién sirve
- Qué herramientas, tecnologías y sistemas están en juego
- Cómo se toman las decisiones y qué es lo que más importa
- Qué evitar y por qué
- El tono y estilo esperado para cualquier resultado
El nombre viene de la propia guía publicada por Anthropic sobre cómo estructurar contexto para Claude. No es un nombre mágico, pero se ha vuelto una convención porque funciona.
Por qué la mayoría de los archivos CLAUDE.md quedan cortos
La versión más común de un CLAUDE.md es superficial. Unos cuantos puntos sobre el proyecto, quizás una lista de tecnologías, una nota sobre el estilo de código preferido. Eso cubre tal vez el 20% de lo que Claude realmente necesita para ser útil.
El resto es más difícil de capturar porque vive en tu cabeza: los supuestos que nunca has escrito, las formas en que tu negocio es diferente a la versión genérica de tu industria, las cosas que han salido mal antes, los clientes reales para los que construyes. Un CLAUDE.md superficial produce resultados superficiales.
También hay un problema de estructura. Un bloque largo de texto no ayuda a Claude tanto como secciones organizadas que separan la orientación (¿qué es esto?) de la profundidad (¿cómo funciona?) y los procesos (¿cómo hacemos cosas específicas?). La mayoría de las personas que escriben su propio archivo no piensan en esas capas.
Las opciones: desde cero, plantilla o generador
Escribir desde cero funciona si eres disciplinado y sabes qué incluir. La mayoría de las personas escribe demasiado poco (un párrafo que dice "dirijo una agencia de marketing") o demasiado (un bloque de texto sin jerarquía). El principal problema es la omisión: no sabes qué falta hasta que Claude comete un error.
Las plantillas son mejores que nada. Hay varias buenas en GitHub y en la documentación de Anthropic. Una plantilla te da la estructura; tú pones el contenido. El problema son las preguntas. Las plantillas genéricas preguntan cosas como "describe tu proyecto" o "lista tu stack tecnológico." Eso está bien para un repositorio de software. Para un cerebro de negocio, las preguntas necesitan extraer las cosas que normalmente no piensas en escribir.
Un generador basado en cuestionario es la opción más sólida si quieres buenos resultados sin pasar horas descubriendo qué debe ir en el archivo. La diferencia está en que un buen cuestionario hace preguntas dirigidas que extraen la información correcta y luego estructura el resultado de manera adecuada. No necesitas saber qué necesita un CLAUDE.md. Respondes lo que ya sabes y la estructura sale bien.
Por qué un cuestionario supera una página en blanco
Cuando te sientas a escribir un CLAUDE.md desde cero, estás resolviendo dos problemas al mismo tiempo: descubrir qué información necesita Claude y encontrar cómo expresarla con claridad. Es mucho trabajo cognitivo, y la mayoría de las personas pierde la mayor parte del valor en el proceso.
Un cuestionario separa esos dos problemas. Las preguntas ya fueron diseñadas para sacar la información correcta. Para el cerebro de un negocio pequeño, eso significa cosas como: quién es el cliente y qué quiere lograr en concreto, no solo su perfil demográfico. Qué hace el negocio de manera diferente a sus competidores, con ejemplos reales. Cómo es un buen resultado versus uno que parece correcto pero falla en el punto clave. Cuáles son los tres a cinco flujos de trabajo que ocurren con más frecuencia.
Esas preguntas no son obvias. Surgen de entender qué necesita Claude para ser útil, no de lo que naturalmente sientes como importante escribir sobre tu negocio.
Qué genera AI Brain Docs
AI Brain Docs está construido específicamente para este problema. Respondes seis preguntas sobre tu negocio. El generador produce:
CLAUDE.md -- la capa de orientación. Es lo que Claude lee primero. Cubre qué es el negocio, a quién sirve, cómo se toman decisiones, el tono y estilo, y qué evitar. Está estructurado según las recomendaciones de Anthropic, no de la manera genérica que siguen la mayoría de las plantillas.
Una base de conocimiento -- siete documentos que profundizan en el negocio. Perfiles de clientes, posicionamiento, productos y servicios, contexto competitivo, contexto operacional. Son la capa de profundidad que respalda la orientación.
Un Plan de Acción con IA -- una lista priorizada de las acciones de mayor valor que la IA puede hacer para ese negocio específico, basada en sus flujos de trabajo y contexto. No son sugerencias genéricas.
Un conjunto de habilidades, agentes y prompts -- instrucciones listas para usar que tu IA puede seguir en tareas recurrentes concretas. Redactados para el contexto de tu negocio.
Todo el proceso toma unos diez minutos. La generación corre del lado del servidor y los resultados están disponibles de inmediato. El CLAUDE.md y la base de conocimiento se descargan como un ZIP que puedes poner en tu Proyecto de Claude, usar en Claude Code, o agregar a las instrucciones personalizadas de ChatGPT.
Cómo usar lo que obtienes
Agregar los archivos a Claude Projects (el campo de instrucciones) es el camino más directo. Claude leerá el CLAUDE.md al inicio de cada conversación en ese proyecto. Los documentos de la base de conocimiento aportan profundidad cuando Claude necesita detalles específicos.
Para Claude Code, el CLAUDE.md va en la raíz de tu directorio de trabajo. Claude Code lo lee automáticamente. La base de conocimiento puede vivir en un subdirectorio knowledge-base/.
Para ChatGPT, el contenido del CLAUDE.md va en el campo de instrucciones personalizadas de un GPT que configures. Los documentos de la base de conocimiento se pueden adjuntar como archivos de referencia.
Gemini con un system prompt o Gems funciona de la misma manera.
Los archivos son markdown simple. Nada está bloqueado en una plataforma. Si quieres editar una sección después, la abres y la cambias.
Para quién es esto
Si usas Claude Code en un proyecto y quieres que Claude deje de hacerte las mismas preguntas cada sesión, un CLAUDE.md vale la hora que toma escribirlo bien. Si quieres recuperar esa hora y que el resultado sea más estructurado de lo que la mayoría produce por su cuenta, AI Brain Docs lo hace por ti.
El costo único es de aproximadamente $29.99. Hay un nivel gratuito que incluye el CLAUDE.md y una vista previa de la base de conocimiento para que puedas evaluar el resultado antes de pagar.
Si has estado posponiendo construir tu contexto de IA porque la página en blanco es frustrante, comienza el cuestionario en aibraindocs.com/start y tendrás algo funcional en unos diez minutos.