Estructura recomendada para tu setup de Claude Code

Después de meses iterando, esta es la estructura que me parece más sólida. Adaptala a vos. No es quick-start, es la base sobre la que se construye un Claude Code productivo.

Estructura de ~/.claude/

~/.claude/
├── CLAUDE.md              # Identidad + reglas core (siempre cargado)
├── rules/                 # Reglas modulares
│   ├── auto-protocol.md   # Triage A/B/C/D/E + RPI + checkpoints
│   ├── tool-routing.md    # Routing automático MCPs y skills
│   ├── skills-strategy.md # Matriz intent → skill
│   ├── memory-system.md   # Sistema memoria (4 capas)
│   ├── context-mgmt.md    # Token economy
│   └── platform-quirks.md # Específicos de tu OS / stack
├── skills/                # Skills propias custom
├── agents/                # Sub-agents especializados
└── projects/              # Auto-memoria por proyecto

Los 3 cambios que más impacto tienen

1. Reglas lazy-loaded por path

No cargues todas las reglas al inicio. Configurá frontmatter paths: para que solo se carguen las que matchean el cwd actual. Ahorra 5-10K tokens por sesión.

---
paths:
  - "**/n8n/**"
  - "**/*workflow*.json"
---

# Reglas n8n (se cargan solo en proyectos n8n)
...

2. Memoria automática por proyecto

Cada proyecto debería tener su ~/.claude/projects/<repo>/memory/ con:

• project_*.md — estado de proyectos activos
• feedback_*.md — errores nuevos resueltos
• reference_*.md — recursos recurrentes

Regla core: cada error nuevo resuelto se guarda en feedback ANTES de seguir trabajando. La segunda vez que aparece, ya no es problema.

3. Sub-agents para work pesado

En vez de hacer 30 tool calls que pollutan el contexto, spawná un Agent con context: fork y recibí solo la conclusión.

Ejemplo: si tenés que leer 20 archivos para entender un repo, delegalo a un sub-agent y recibí un sumario.

Lo que NO funciona

• ❌ MCPs masivos (Composio, "Apify everything"). Mucho ruido, poca señal. Curá solo los que usás.
• ❌ Skills en inglés genérico. Si trabajás en español, las skills en español tienen mejor signal.
• ❌ Cargar 50 archivos de memoria al inicio "por si acaso". Solo el índice + lo que realmente necesitás.
• ❌ CLAUDE.md de 500 líneas. Imposible de mantener. Modulariza con rules/.

Lo que SÍ funciona

• ✅ Rules cortas con frontmatter paths:
• ✅ Skills propias en tu tono y tu vertical
• ✅ Auto-memoria con feedback files antes de seguir tras un error nuevo
• ✅ Sub-agents con context: fork para work pesado
• ✅ `/compact` con hint específico cada 2-3 tareas grandes

Mantenimiento

Una vez por semana:

• Revisar memoria, archivar lo viejo
• Verificar que el índice MEMORY.md no tenga referencias rotas
• Limpiar logs/screenshots viejos

Una vez por mes:

• Auditar las rules, borrar las que ya no aplican
• Verificar que claude-mem worker corra bien
• Snapshot del setup para backup

¿Querés ayuda a armar el tuyo?

Escribime a @juanbertorello.ia↗ y vemos cómo dejarte el setup afilado.