$ man how-to/repo-context-engine

La mayoria de la gente piensa en un repositorio como almacenamiento de codigo. Los archivos entran. El control de versiones rastrea los cambios. Eso es la mitad de la historia. Un repositorio es tambien la fuente de contexto principal para cada agente de IA que toca tu proyecto. Cuando Claude inicia una sesion, lee tu repositorio. Cuando referencias un archivo con @, carga ese archivo en la ventana de contexto. Cuando un skill se ejecuta, lee archivos del repositorio. El repositorio ES el motor de contexto. Como lo organizas determina que tan bien funciona la IA para ti. Un repositorio desordenado produce resultados de IA desordenados. Un repositorio estructurado produce resultados de IA estructurados. La estructura del repositorio es ingenieria de contexto.

PATTERN

Cada carpeta debe tener un proposito claro. Cada archivo debe tener un nombre predecible. Cuando Claude necesita investigacion de un partner, busca en partners/{name}/research/. Cuando necesita un skill, busca en .cursor/skills/{name}/SKILL.md. Cuando necesita un borrador de contenido, busca en content/drafts/. Usa prefijos de fecha para contenido: 2026-02-18_nombre-del-tema.md. Esto ordena cronologicamente y le dice a Claude cuando se escribio algo. Usa slugs en minusculas para carpetas: partners/acme/, skills/deploy/. Usa SKILL.md (mayusculas) para archivos de skill para que destaquen en los listados de directorio. La taxonomia no es cuestion de estetica. Es cuestion de previsibilidad. Una estructura predecible significa que Claude gasta cero tiempo buscando y cero tiempo adivinando rutas de archivos. Va directamente al archivo que necesita porque la estructura siempre es la misma.

FORMULA

CLAUDE.md en la raiz: valores por defecto del entorno, preferencias de idioma, estilo de codigo. Menos de 50 lineas. .cursor/skills/ o skills/: un SKILL.md por flujo de trabajo. Deploy, tracker, publicacion de contenido, onboarding de partners. .cursor/rules/: patrones especificos de archivo. Reglas de formato de blog, convenciones de TypeScript, aplicacion de reglas de voz. content/: todo lo que produces. Borradores, posts publicados, imagenes, indices. partners/ o clients/: carpetas por entidad con investigacion, prompts, flujos de trabajo, recursos. workflows/: indices de contenido, seguimiento de pipeline, calendarios editoriales. data/: assets generados, estadisticas, exportaciones. Normalmente en gitignore para datos sensibles. scripts/: automatizacion en Python, procesamiento por lotes, transformaciones de datos. Normalmente en gitignore. Esta no es la unica estructura valida. Pero cualquier estructura que elijas, se consistente. Una estructura para cada partner, cada tipo de contenido, cada flujo de trabajo. La consistencia es lo que hace funcionar al motor de contexto.

PRO TIP

Un repositorio de contexto se acumula. Cada archivo que agregas hace que las futuras sesiones de IA sean mejores. Una guia de voz que escribiste en el primer mes hace que cada pieza de contenido del segundo mes en adelante suene como tu. Una carpeta de investigacion de partner que creaste para el cliente A se convierte en la plantilla para los clientes B a Z. Un skill que escribiste para desplegar un sitio evoluciona en un skill que despliega tres sitios con manejo de errores y verificacion. Mi repositorio comenzo con un CLAUDE.md y tres skills. Seis meses despues tiene mas de 40 skills, un sistema de voz completo, flujos de trabajo para partners, un sistema de progresion RPG y dashboards automatizados. No reserve tiempo para construir el motor de contexto. Lo construi haciendo el trabajo y capturando los patrones. Cada dia el repositorio mejora. Cada dia la IA trabaja mejor con el. Ese es el efecto compuesto.