Sin tecnicismos. Sin miedo. Una guia para entender donde vive cada cosa, que hace cada pieza y como sacarle el maximo provecho.
Porque no puedes romper nada que no se pueda revertir.
Piensa en Claude Code como un empleado muy capaz que acaba de llegar a tu empresa.
No sabe nada de ti, de tu negocio, ni de como te gusta trabajar. Pero aprende rapido.
El problema es que si no le dejas instrucciones, va a improvisar. Y a veces improvisa bien. Pero a veces no.
Los archivos que vamos a ver son esas instrucciones.
Son archivos de texto (.md) que Claude lee automaticamente para saber que hacer, como hacerlo y que no hacer.
Claude lee estas capas automaticamente, de la mas general a la mas especifica. No tienes que hacer nada especial — solo poner los archivos en el lugar correcto.
Es lo primero que Claude lee al iniciar una conversacion. Como el manual que le das a un empleado nuevo el primer dia.
$ ubicacion:
tu-proyecto/CLAUDE.md$ contenido:
Puedes tener varios: uno en la raiz del proyecto y otros dentro de subcarpetas. Claude carga todos los que encuentre en la ruta donde estes trabajando.
Claude tiene memoria entre conversaciones. Recuerda quien eres, como te gusta trabajar, que proyectos tienes y que errores no repetir.
$ ubicacion:
~/.claude/projects/tu-proyecto/memory/$ guarda (automaticamente):
Puedes pedirle que recuerde algo: "Recuerda que siempre respondas en espanol". Tambien puedes pedirle que olvide algo.
Cuando Claude necesita ayuda con algo complejo, puede lanzar "subagentes" — asistentes que trabajan en paralelo. El AGENTS.md es el briefing que reciben ellos (no Claude principal).
$ ubicacion:
tu-proyecto/AGENTS.md$ contenido:
La diferencia: CLAUDE.md es para Claude principal. AGENTS.md es para los subagentes que el lanza.
En vez de meter todo en un solo CLAUDE.md gigante, puedes crear reglas individuales por tema. Cada una es un archivo .md separado que se activa cuando es relevante.
$ ubicacion:
tu-proyecto/.claude/rules/$ ejemplo:
seo.md → solo se activa cuando trabajas con SEOcopy.md → solo cuando escribes copytesting.md → solo cuando haces testsPueden activarse solo para ciertos archivos. Ejemplo: una regla que solo aplica cuando editas archivos .tsx
Cuando le pides algo complejo, Claude puede lanzar asistentes que trabajan en paralelo. Cada uno con su propio contexto y herramientas.
Tu hablas con Claude
Le pides: "Crea una landing page para el producto X"
Claude lanza subagentes en paralelo:
Copywriter
Escribe los textos
SEO
Optimiza para buscadores
Disenador
Implementa en codigo
Claude recoge los resultados, los combina y te presenta el resultado final. Los subagentes no hablan entre si — Claude es el intermediario.
Puedes crear "empleados especializados" con su propia personalidad, conocimiento y herramientas. Son archivos .md en una carpeta.
"Eres un copywriter senior. Antes de escribir, lee el contexto de marketing. Genera 2-3 variaciones. Justifica cada decision."
.claude/agents/copywriter.md"Eres un especialista SEO. Audita la pagina, optimiza meta tags, sugiere keywords, revisa schema markup."
.claude/agents/seo-specialist.md"Eres un disenador frontend. Implementas landing pages en Next.js + Tailwind. Mobile-first. CTAs prominentes."
.claude/agents/landing-designer.md"Eres un especialista en automatizacion. Disenas flujos en n8n, conectas servicios, documentas todo."
.claude/agents/n8n-automation.mdCada agente tiene: un nombre, una descripcion (cuando usarlo), herramientas permitidas y sus instrucciones. Son solo archivos de texto. Los puedes editar, copiar o borrar sin miedo.
Si los agentes son "quien lo hace", los skills son "como se hace". Son instrucciones que Claude usa cuando son relevantes.
Ejemplo real: el skill /create-landing orquesta todo el flujo de crear una landing: primero le pide al agente copywriter que escriba, luego al SEO que optimice, luego al disenador que implemente. Un solo comando, tres especialistas.
Y lo mejor: puedes instalar skills de la comunidad. Hay miles disponibles en marketplaces como GitHub.
Asi se ve todo junto. Cada archivo tiene su lugar y su funcion.
tu-proyecto/
CLAUDE.md <- briefing principal
AGENTS.md <- instrucciones para subagentes
.claude/
agents/
copywriter.md <- agente de copy
seo-specialist.md <- agente SEO
landing-designer.md <- agente de diseno
skills/
create-landing/ <- flujo orquestado
copywriting/ <- skill de copywriting
seo-audit/ <- skill de auditoria SEO
rules/
seo.md <- regla condicional
.agents/
product-marketing-context.md <- brief del negocio
Son archivos de texto. Si borras algo, lo vuelves a crear. Si cambias algo y no funciona, lo reviertes. Git esta ahi para eso.
Cambia una instruccion en CLAUDE.md y mira que pasa. Crea un agente nuevo. Instala un skill. Lo peor que puede pasar es que Claude haga algo raro — y le dices que pare.
Lo mejor de Claude Code es que puedes preguntarle: "Que archivos tienes cargados?", "Que agentes hay?", "Que recuerdas de mi?". El mismo te explica.
CLAUDE.md → Las instrucciones que Claude lee siempre
Memory → Lo que recuerda de ti entre conversaciones
AGENTS.md → Instrucciones para los asistentes que Claude lanza
Rules → Reglas modulares que se activan por contexto
Agentes → Empleados especializados (.claude/agents/)
Skills → Manuales de procedimiento (.claude/skills/)
Todo son archivos de texto. Todo se puede editar. Todo se puede revertir.
No hay nada que romper.