Estructura de Código de Claude que Sobrevivió a Múltiples Proyectos Reales
Lo que funcionó después de múltiples proyectos
Un desarrollador en r/ClaudeAI compartió su estructura de Claude Code que no falló después de implementarla en 2-3 proyectos reales. Esta configuración resistió una vez que agregaron múltiples habilidades, servidores MCP y agentes, superando las simples demostraciones.
Decisiones estructurales clave
- Usar CLAUDE MD: Omitir CLAUDE MD al principio llevó a resultados inconsistentes. Una vez que definieron convenciones, reglas de prueba y estándares de nomenclatura, los resultados se volvieron más predecibles.
- Dividir habilidades por intención: Organizar habilidades como
code-review/,security-audit/,text-writer/funcionó mejor que agrupar toda la lógica en un solo lugar. Esto hizo que la activación fuera más limpia. - Implementar hooks: No usar hooks inicialmente fue un error. Los hooks PreToolUse y PostToolUse ayudaron a detectar comandos incorrectos y salidas desordenadas, y fueron útiles para pequeñas automatizaciones.
- Separar agentes: El enfoque de agente único no escaló bien. Tener agentes dedicados para revisión, escritura y auditoría demostró ser más predecible.
- Gestionar el uso de contexto: Cuando el uso del contexto es demasiado alto, la calidad disminuye. Mantenerlo aproximadamente por debajo del 60% marcó una diferencia notable.
- Separar responsabilidades: Mezclar configuración, habilidades y lógica de ejecución hizo que la depuración fuera dolorosa. Mantener estos elementos separados hizo que todo fuera más fácil de entender.
Integración MCP
La integración de MCP (Protocolo de Contexto del Modelo) con GitHub, Postgres y acceso al sistema de archivos cambió completamente cómo se comporta Claude. Según el desarrollador, aquí es donde la configuración dejó de sentirse como un juguete y comenzó a comportarse más como un asistente de desarrollo en lugar de solo entrada → salida.
El desarrollador señala que todavía están descubriendo la forma más limpia de estructurar agentes, pero esta configuración actualmente funciona bien para proyectos que van más allá de simples demostraciones.
📖 Leer la fuente completa: r/ClaudeAI
👀 Ver también
Cómo configurar sub-agentes con espacios de trabajo separados en OpenClaw
Solución de la comunidad para configurar múltiples sub-agentes con workspaces aislados y diferentes modelos
Obstáculos en la instalación de OpenClaw en Windows 11 y cómo superarlos
Un usuario detalla tres obstáculos específicos al instalar OpenClaw en una máquina nueva con Windows 11: la política de ejecución de PowerShell, el bloqueo de Windows Defender y las dependencias faltantes como Node.js y Git.
Arquitectura de memoria de tres capas para el contexto persistente del agente OpenClaw
Un desarrollador construyó un sistema de memoria de 3 capas sobre la infraestructura de OpenClaw para evitar que los agentes comenzaran cada sesión sin contexto. La arquitectura incluye archivos de espacio de trabajo L1 inyectados en cada turno, búsqueda de memoria semántica L2 y documentos de referencia L3 abiertos bajo demanda.
Qué falla al ejecutar agentes de código en modelos locales pequeños
Puntos de fallo reales al probar tareas con múltiples archivos en modelos con menos de 7B parámetros: delimitadores de markdown, fiabilidad de la salida estructurada, errores al editar archivos y clasificación de acciones de lectura frente a escritura.