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
Arquitectura de Sistema para Programadores de Vibe: Guía de un Ingeniero Senior
Un ingeniero con 10 años de experiencia comparte cómo abordar la creación de aplicaciones con Claude Code: empezar en el nivel del sistema, no en el código. Cubre los cuatro componentes — frontend, backend, base de datos y fontanería — con una inmersión profunda en la fontanería: APIs, hosting, despliegue, secretos y seguridad.
Dificultades de instalación de OpenClaw en Windows 11 para usuarios no desarrolladores
Un aficionado al bricolaje informático detalla tres obstáculos específicos al instalar OpenClaw en una Mini PC de $200 con Windows 11, incluyendo las políticas de ejecución de PowerShell, los bloqueos de Windows Defender y las dependencias faltantes como Node.js y Git.
Maximizando las capacidades de los agentes de IA en OpenClaw
La IA de OpenClaw se puede optimizar seleccionando el modelo adecuado y proporcionando un contexto del sistema específico. Los modelos Qwen sobresalen en el uso de herramientas, lo que es fundamental para los flujos de trabajo autónomos.
OpenClaw 4.1 con Gemma 4 Stack: Arquitectura Híbrida y Correcciones de Configuración
Una publicación de Reddit detalla una pila de agentes locales optimizada que combina OpenClaw 4.1 con el modelo Gemma 4 de Google, con una arquitectura híbrida, correcciones de configuración específicas para la llamada a herramientas de Ollama y ajustes en la ventana de contexto.