~$ cat ./dosieres/claude-code-agents-memory-skills.md
Claude Code: agents.md, memory.md, skills.md — cómo funcionan juntos
Claude Code extiende las capacidades de Claude con un sistema de archivos que define comportamiento de agentes de forma declarativa. Este enfoque permite separar instrucciones, memoria y habilidades para mantener proyectos organizados.
Los archivos agents.md, memory.md y skills.md forman capas complementarias que se activan según el contexto de la conversación. Comprender su interacción es esencial para construir agentes robustos en entornos profesionales.
Rol de agents.md en las instrucciones del proyecto
agents.md establece las reglas y objetivos generales del agente dentro de un proyecto específico. Contiene directrices que guían todas las respuestas y decisiones del modelo.
Este archivo funciona como punto de entrada principal y se carga al iniciar una sesión. Permite definir roles, restricciones y flujos esperados sin repetirlos en cada interacción.
Memory.md para memoria persistente entre sesiones
memory.md almacena información clave que debe sobrevivir al reinicio de conversaciones. Incluye hechos, preferencias y estado acumulado del proyecto.
Su uso evita la pérdida de contexto y permite que el agente recuerde decisiones previas o datos de usuario. Se actualiza de forma controlada para mantener coherencia.
Skills.md y capacidades reutilizables
skills.md define funciones modulares que el agente puede invocar bajo demanda. Cada skill describe entradas, salidas y lógica de activación.
Estas capacidades se mantienen separadas para facilitar su reutilización en distintos proyectos o agentes. El modelo las detecta y ejecuta cuando el contexto lo requiere.
Cómo se combinan las tres capas
agents.md proporciona la capa de instrucciones, memory.md añade persistencia y skills.md aporta ejecución modular. El sistema las evalúa de forma jerárquica durante cada respuesta.
Esta estructura permite que un agente siga reglas fijas, recuerde información y active herramientas específicas sin sobrecargar el prompt principal.
Buenas prácticas de estructuración y workflows
Mantén agents.md conciso y enfocado en objetivos de alto nivel. Actualiza memory.md solo con datos relevantes y versiona skills.md para facilitar mantenimiento.
Un workflow típico comienza con la carga de agents.md, consulta de memory.md y activación de skills según la tarea. Esto reduce errores y mejora la trazabilidad en proyectos complejos.
para recordar
- agents.md debe priorizar instrucciones claras y estables para todo el proyecto.
- memory.md requiere actualizaciones selectivas para evitar ruido en el contexto.
- skills.md se beneficia de una nomenclatura consistente que facilite su invocación.
- La combinación de las tres capas reduce la necesidad de prompts repetitivos.
- Versionar los tres archivos mejora la colaboración en equipos de desarrollo.
preguntas frecuentes
¿Qué diferencia existe entre agents.md y un prompt normal?
agents.md define reglas persistentes del proyecto que se cargan automáticamente. Un prompt normal es temporal y se limita a una sola interacción.
¿Cómo se actualiza la memoria en memory.md?
El agente escribe en memory.md solo cuando detecta información relevante y duradera. Esto mantiene el archivo limpio y enfocado en datos útiles.
¿Puedo reutilizar skills.md en varios proyectos?
Sí, skills.md está diseñado para ser modular y portable. Basta copiar el archivo y ajustar las referencias específicas del nuevo contexto.
¿Qué ocurre si los tres archivos entran en conflicto?
agents.md tiene prioridad sobre memory.md y skills.md. El sistema resuelve conflictos siguiendo un orden jerárquico definido en la documentación de Claude Code.
cursos para ir más lejos
