Qué poner en CLAUDE.md y qué añadir solo a una tarea
Claude Code lee CLAUDE.md del repositorio al arrancar. Codex y muchos otros agentes tienen un archivo equivalente: AGENTS.md. Es un buen sitio para todo lo que el agente debe saber del proyecto: cómo ejecutar los tests, dónde está cada cosa y qué reglas de código seguir.
Con el tiempo el archivo crece y aparecen instrucciones que no hacen falta en todas las tareas.
Un ejemplo: revisores después del desarrollo
Una técnica útil para las tareas de código son los revisores independientes. Tras el desarrollo, el agente lanza subagentes aparte que no han visto cómo se escribió el código. Leen los cambios y los contrastan con la tarea y con las reglas del proyecto. Uno comprueba si se hizo lo que se pedía. Otro revisa el estilo y el código sobrante. El agente corrige lo que encuentran antes de decir «listo».
Una instrucción así ocupa unas quince líneas. Si se pone en CLAUDE.md, el agente la recibe en cada sesión: tanto en una tarea sobre el texto de una landing como en el análisis de unos logs, donde no hay código que revisar. Es contexto de más y, a veces, trabajo de más.
Escribirla a mano en cada tarea tampoco resulta cómodo. Es fácil olvidarla, y al copiarla de una tarea antigua es fácil quedarse con una versión desactualizada.
Una instrucción para un tipo de tarea
En Tascue una instrucción así se convierte en un fragmento (include), por ejemplo «Revisores independientes». Se marca en las tareas donde cambia el código y, al copiar la tarea, se coloca al final del prompt. En las tareas de textos o de investigación simplemente no está.
Si el fragmento aparece cuando el backlog ya tiene muchas tareas, se puede añadir a todas a la vez con «Aplicar a todas las tareas del backlog». Las tareas en curso y las ya hechas no cambian.
Qué va dónde
| Instrucción | Dónde guardarla |
|---|---|
| Hace falta en cualquier tarea de este repositorio: cómo ejecutar los tests, cómo está organizado el proyecto | CLAUDE.md |
| Hace falta en tareas de un mismo tipo: revisión de código, comprobación en el navegador, reglas de textos | Fragmento del proyecto |
| Hace falta en todos los proyectos: «no hagas commits» | Fragmento común, incluido por defecto en las tareas nuevas |
| Hace falta en una sola tarea | Texto de la tarea |
Una comprobación sencilla para una instrucción nueva: ¿hace falta en todas las tareas? Si no, su sitio es un fragmento, y CLAUDE.md se mantiene corto y se lee en un minuto.
El prompt de la tarea se monta solo: intro, campos, texto y fragmentos. En Claude Code se puede pegar después de «Copiar» o entregar por MCP, y el agente recibe la misma tarea completa.