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.