CLAUDE.md: 6 capas para Claude Code sin pérdidas

Configuración de Claude.md: 6 Capas para un Contexto Sólido en Claude Code

Claude Code inicia cada sesión desde cero: sin conocimiento del proyecto, sin detalles del servidor, sin correcciones previas. Esto provoca explicaciones repetidas y riesgos, desde borrar datos de producción hasta subir secretos al repositorio. La configuración CLAUDE.md de 582 líneas resuelve esto con 6 capas: desde reglas hasta hooks automáticos. Cada capa surgió de incidentes reales.

Incidentes que Definieron la Arquitectura

Tres fallos marcaron el enfoque:

• SNI-proxy vía localhost. El agente cambió 127.0.0.1 por una IP real, rompiendo las subidas. Causa raíz: no entendió por qué ese valor específico importaba.
• Bloqueo por Fail2ban. Múltiples inicios de SSH en un minuto se detectaron como ataque de fuerza bruta, deteniendo el entrenamiento del modelo.
• Borrado de dataset. Un comando de "filtro" eliminó archivos en lugar de solo moverlos.

Lecciones aprendidas: las reglas deben analizar valores actuales antes de cambios, imponer un único túnel SSH y exigir confirmación explícita para eliminaciones.

La Estructura de 6 Capas

Capa 1: Reglas (9 archivos)

Cargadas contextuales: las reglas de SSH no entorpecen tareas de texto, las de depuración omiten guías de estilo.

Capa 2: Memoria (78 archivos)

Grafo de conocimiento con 178 referencias cruzadas vía [[filename]]. Archivos centrales siempre en contexto; los específicos por tema se cargan bajo demanda. Cubre infraestructura, correcciones y trampas.

Capa 3: Transiciones

Resúmenes de sesión: objetivo, logros, fallos, próximos pasos. Ejemplo:

## Objetivo de la Sesión
Comprobador de color: barrido CNN + difusión.

## Hecho
- Baseline CNN: mediana 1.99 deg (11M params)
- Barrido: crop128(3.17), bs16(2.04)
- Difusión: época 5/50, pérdida 0.827

## Lo que Falló
- EfficientNet-B0: hash no coincide
- lr=3e-4: NaN sin clipping

## Próximos Pasos
Inferencia para difusión + hojas visuales.

27 transiciones en 4 días evitan repasar callejones sin salida. Funciona entre suscripciones.

Capa 4: Crónicas

Línea de tiempo de decisiones: 3-7 líneas por hito. Complementa transiciones con la historia completa.

Capa 5: Hooks

Scripts Python automáticos activados por eventos (SessionStart, Stop, PreToolUse). Independientes de la memoria del modelo.

Ejemplo de hook de transición:

# remind_handoff.py (hook de Stop)
age = session_age_minutes()
if age < 15 or fresh_handoff_exists():
    return
print(json.dumps({
    "decision": "block",
    "reason": f"Sesión {int(age)} min, sin transición registrada."
}))

Capa 6: Habilidades (16 kits)

Guías basadas en disparadores: "usa esto para GPUs atascadas" en lugar de instrucciones vagas.

Hooks vs Reglas: Ejecución Garantizada

Las reglas de prompt se olvidan en sesiones largas. Los hooks se ejecutan mecánicamente. El hook de inicio valida enlaces de CLAUDE.md; el de cierre insta a las transiciones.

Defensa de la Cadena de Suministro: Configuración de Una Línea

En .npmrc:

min-release-age=7

Bloquea paquetes de menos de 7 días. Nos salvó del ataque axios 1.14.1 (Sapphire Sleet, 31 de marzo de 2026, ventana de 3 horas). Equivalente en Python en uv.toml:

exclude-newer = "7 days"

Principios de 37 Artículos de Investigación

Destilados en reglas:

• Bucle de Prueba. Sin auto-confirmación: exige prueba externa (tests de una sesión fresca).
• Razonamiento Estructurado. Formato: hechos → rastro → conclusiones → hipótesis verificadas. Precisión de parches: 78% → 93%.
• Orquestación Determinista. Tareas fijas (tests, linting) vía scripts de shell.
• Líneas Rojas. Prohibiciones estrictas: "sin eliminaciones sin confirmación", ligadas a incidentes específicos.

Otros: generador-evaluador, desglose multiagente, seguridad de agentes.

Métricas y Autoactualización

• 78 archivos de memoria, 178 enlaces.
• 27 transiciones en 4 días.
• Tasa de acierto KV-cache 96.9% (83 sesiones).

La config se auto-valida: el hook SessionStart verifica enlaces tras ediciones.

Lecciones Clave:

• Transiciones y Memoria evitan pérdida de contexto entre sesiones.
• Hooks aseguran que acciones críticas ocurran.
• Escudos de cadena de suministro: min-release-age=7 en .npmrc / uv.toml.
• Razonamiento Estructurado eleva precisión de depuración a 93%.
• Líneas Rojas reducen riesgos en producción.

Pila mínima: Orquestación Determinista + Razonamiento Estructurado + Defensa de Cadena de Suministro + Transiciones.

Repo: github.com/AnastasiyaW/claude-code-config (MIT).

— Editorial Team