Lo esencial
La estructura de carpetas no es una cuestión de orden, es una cuestión de arquitectura: Claude Code piensa en tu proyecto exactamente como están organizadas tus carpetas, y una jerarquía correcta multiplica la calidad del trabajo de los agentes.
Conceptos clave
- PARA es un sistema de 4 categorías que cubre el 100% de cualquier información
- Estructura de carpetas = arquitectura del pensamiento: como está organizado, así se piensa
- Claude Code lee la estructura a través de
CLAUDE.md: es el mapa para el agente - Unas reglas de oro para nombrar archivos hacen más precisa la búsqueda de la IA
- Jerarquía plana vs. profunda: cada enfoque tiene sus casos de uso
Teoría
El sistema PARA: cuatro cajones para todo
PARA lo desarrolló Tiago Forte y se volvió el estándar del "segundo cerebro". La idea: cualquier unidad de información cae en uno de cuatro cajones.
| Letra | Nombre | Qué va ahí | Ejemplo |
|---|---|---|---|
| P | Projects | Proyectos activos con fecha límite | Lanzar un producto nuevo para el 1 de junio |
| A | Areas | Áreas de responsabilidad sin fecha límite | Salud, finanzas, marketing |
| R | Resources | Material de consulta | Guías, plantillas, investigaciones |
| A | Archive | Lo terminado y lo que ya no aplica | Proyectos viejos, borradores |
El principio clave de PARA: la información no se organiza por tema (como los cuadernos de la escuela), sino por nivel de actividad. Eso importa para la IA: el agente entiende que lo que está en Projects es vivo e importante, y lo que está en Archive es inactivo y opcional.
Por qué estructura de carpetas = arquitectura del pensamiento
La estructura de carpetas influye en cómo tú (y tus agentes) toman decisiones.
Mala estructura:
/projects/
/my_business/
idea1.txt
old_idea.txt
notes_final.docx
notes_final_v2.docx
notes_REALLY_final.docx
random_stuff/
...Claude en esta estructura: "No entiendo qué es lo actual, qué es lo viejo y qué es lo importante. Voy a adivinar".
Buena estructura (PARA):
/projects/
/launch-product-x/ ← proyecto activo
BRIEF.md ← contexto para Claude
/research/
/drafts/
/final/
/areas/
/marketing/ ← área permanente
/finance/
/resources/
/templates/ ← reutilizable
/guides/
/archive/
/2025-product-y/ ← terminadoClaude en esta estructura: "Veo proyectos activos, material de consulta y un archivo. Voy a trabajar en /projects/launch-product-x/ y a usar las plantillas de /resources/templates/".
Cómo Claude Code entiende la estructura de carpetas a través de CLAUDE.md
Al arrancar, Claude Code lee CLAUDE.md en la raíz del proyecto. Es la instrucción para el agente: qué está dónde, cómo se llama, qué reglas hay. Todo sobre ese archivo: CLAUDE.md: el prompt de sistema de tu proyecto. Puedes crear un borrador con el comando /init. Además de CLAUDE.md, Claude Code lee AGENTS.md, las reglas de la carpeta .claude/rules/ y lleva su propia memoria (auto memory), que puedes administrar con el comando /memory.
Ejemplo de CLAUDE.md para una estructura PARA:
# Project Context ## Structure - `/projects/` — proyectos activos (cada uno en su carpeta con BRIEF.md) - `/areas/` — áreas de responsabilidad permanentes - `/resources/` — plantillas, guías, material de consulta - `/archive/` — proyectos terminados (no editar) ## Naming Convention - Carpetas: kebab-case, siempre en minúsculas (product-launch, not ProductLaunch) - Archivos: kebab-case + fecha si tiene versiones (report-2026-10.md) - MAYÚSCULAS: solo CLAUDE.md, README.md, BRIEF.md (instrucciones importantes) ## Rules - Nunca edites `/archive/` - Guarda los borradores en la carpeta `/drafts/` dentro del proyecto - Las versiones finales van en `/final/` sin sufijos _v2, _final
Con un CLAUDE.md así, el agente trabaja con claridad: sabe dónde buscar, dónde guardar y qué no tocar.
Reglas de oro para nombrar archivos pensando en la IA
Los agentes de IA son como buscadores: funcionan mejor con nombres predecibles.
Regla 1: kebab-case en todos lados
✅ market-research-2026.md ❌ Market Research 2026.md ❌ marketResearch2026.md ❌ market_research_2026.md
Regla 2: la fecha al principio en archivos con fecha
✅ 2026-10-01-competitor-analysis.md ❌ competitor-analysis-may.md
Fecha al principio = orden cronológico automático.
Regla 3: un verbo o un sustantivo, no "final"
✅ landing-page-copy.md ✅ email-sequence-onboarding.md ❌ landing_FINAL_v3_use_this.md ❌ email_copy_new2.docx
Regla 4: MAYÚSCULAS solo para las instrucciones principales
CLAUDE.md ← el agente lo lee primero
README.md ← la persona lo lee primero
BRIEF.md ← contexto del proyectoRegla 5: sin espacios en los nombres de carpetas
✅ /my-business/
❌ /My Business/ ← rompe comandos de bash y confunde a los agentesEjemplo de estructura para un emprendedor con IA
~/workspace/
├── CLAUDE.md ← instrucción principal
├── projects/
│ ├── saas-tool-launch/
│ │ ├── BRIEF.md ← contexto para Claude
│ │ ├── research/
│ │ │ └── 2026-09-competitors.md
│ │ ├── drafts/
│ │ │ └── landing-page-v1.md
│ │ └── final/
│ │ └── landing-page.md
│ └── youtube-channel/
│ ├── BRIEF.md
│ └── content-calendar.md
├── areas/
│ ├── marketing/
│ │ ├── brand-voice.md ← Claude lo lee antes de escribir
│ │ └── target-audience.md
│ ├── finance/
│ │ └── budget-2026.md
│ └── tech-stack/
│ └── tools-and-keys.md
├── resources/
│ ├── templates/
│ │ ├── blog-post.md
│ │ ├── email-sequence.md
│ │ └── project-brief.md
│ └── guides/
│ └── claude-code-cheatsheet.md
└── archive/
└── 2025-old-project/Jerarquía plana vs. profunda: qué conviene en sistemas con IA
Estructura plana (flat):
/projects/
project-a-research.md
project-a-draft.md
project-b-research.md✅ Buena para: proyectos pequeños, búsqueda rápida, hasta 50 archivos ❌ Mala para: sistemas grandes, trabajo en equipo, crecer
Estructura profunda (deep):
/projects/
/project-a/
/phase-1/
/research/
/primary/
/interviews/✅ Buena para: proyectos grandes con muchas etapas ❌ Mala para: el trabajo diario (demasiados pasos); al agente le cuesta orientarse a 4 niveles o más de profundidad
Regla: máximo 3 niveles de anidación
/root/
/category/ ← nivel 1
/project/ ← nivel 2
/file.md ← nivel 3Tres niveles alcanzan para cualquier proyecto individual. Más profundo, solo en empresas grandes con equipos.
Práctica
- Mira tu estructura actual con honestidad:
find ~/workspace -maxdepth 3 -type d | head -30
# o si no tienes workspace:
ls -la ~/Desktop- Crea una estructura PARA para tu proyecto principal:
mkdir -p ~/workspace/{projects,areas,resources,archive}
mkdir -p ~/workspace/projects/mi-proyecto/{research,drafts,final}
mkdir -p ~/workspace/areas/{marketing,finance}
mkdir -p ~/workspace/resources/{templates,guides}Crea un
CLAUDE.mden la raíz de~/workspace/(toma el ejemplo de la lección y adáptalo a ti)Crea un
BRIEF.mden la carpeta de tu proyecto activo:
# Project Brief: [Nombre]
## Objetivo
[Qué estamos creando y para qué]
## Público
[Para quién]
## Fecha límite
[Cuándo]
## Contexto para Claude
[Lo que Claude debe saber antes de empezar]
## Restricciones
[Qué no se vale, estilo, presupuesto]- Abre Claude Code en la carpeta
~/workspace/y comprueba que entiende bien la estructura:
Lee CLAUDE.md y explícame: si te pido escribir un borrador de landing page para el proyecto X, ¿dónde lo vas a guardar y por qué?
Herramientas y recursos
- Building a Second Brain (libro): el libro original de Tiago Forte sobre PARA
- PARA Method (artículo): explicación detallada y gratuita del sistema
- Obsidian: un segundo cerebro local con plugins para PARA
- Notion: PARA en la nube con acceso para equipos
Ideas clave
PARA no es un sistema para guardar archivos, es un sistema para administrar la atención: Projects pide acción ahora, Areas pide atención constante, Resources se usa cuando hace falta y Archive queda para la historia.
Claude Code trabaja tan bien como entiende la estructura del proyecto.
CLAUDE.mdes el mapa del agente; sin él, es como un empleado nuevo en su primer día sin organigrama.
Tres niveles de anidación y nombres en kebab-case: dos reglas que hacen notablemente más preciso el trabajo con agentes de IA con un esfuerzo mínimo.
Siguiente lección
→ Copywriting con IA a través de una cadena de prompts: escribir con tu propia voz
La marca se guarda solo en este navegador y no se envía a ningún sitio. Mi progreso