Sistema de ingeniería portátil para Claude Code con ganchos, agentes especializados y automejora.

Un desarrollador frustrado por repetir instrucciones a Claude Code construyó un sistema de ingeniería portátil que reside en ~/.claude/ y se aplica automáticamente a cada proyecto. El sistema aborda dos problemas principales: el ciclo de repetición donde Claude Code encontraba el mismo error días después y lo resolvía desde cero, y la desconexión entre proyectos donde las reglas refinadas en un proyecto no existían en otro.

Componentes del sistema

El sistema incluye varios componentes clave:

• Una constitución (CLAUDE.md) – 650 líneas de reglas con una jerarquía de valores, límites de decisión y tres modos de ejecución según la complejidad de la tarea
• Ganchos que aplican reglas determinísticamente – No son sugerencias que la IA podría ignorar, sino scripts bash que bloquean físicamente comandos peligrosos como pushes forzados, uso incorrecto del gestor de paquetes o rm -rf
• Tres agentes especializados – Un orquestador que delega pero nunca codifica, constructores que trabajan en copias aisladas del repositorio, y un revisor de solo lectura que no puede corregir cosas (solo informa)
• Un pipeline de habilidades – Desde la planificación hasta la construcción, envío y producción, mayormente autónomo con una puerta no negociable: el despliegue en producción siempre pregunta
• Un sistema inmunológico – Cada error se registra con la causa raíz Y los enfoques que fallaron. El mismo error en 2+ proyectos se convierte en una regla permanente, desarrollando anticuerpos
• Verificación anti-Goodhart – Cinco preguntas que cada agente debe responder antes de declarar "terminado", porque "todas las pruebas pasan" no significa que la aplicación funcione

Enfoque de ingeniería compuesta

El sistema se basa en Ingeniería Compuesta: Planificar → Trabajar → Revisar → Compuesto. Ese cuarto paso es donde el sistema se mejora a sí mismo. El desarrollador menciona reglas específicas que antes tenía que repetir diariamente: "usa pnpm no npm", "no elimines pruebas que pasan" y "ejecuta pruebas antes de confirmar".

El proyecto es de código abierto en https://github.com/vinicius91carvalho/.claude con un recorrido completo de las 15 piezas disponible en https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code.