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.
📖 Read the full source: r/ClaudeAI
👀 Ver también
El hook de pre-commit de Git evita que los agentes de codificación con IA realicen commits con documentación desactualizada.
Un desarrollador creó un hook de pre-commit de Git que bloquea los commits cuando los archivos de documentación están desactualizados, abordando específicamente problemas con agentes de codificación con IA como Claude Code, Cursor, Windsurf y Copilot. La herramienta sale con el código de error 1 para obligar a los agentes de IA a actualizar la documentación antes de continuar.
Colaborar: Una habilidad de Claude Code para escritura estructurada y asíncrona de documentos con transferencias multiagente
Un skill de Claude Code llamado 'collaborate' permite la escritura de documentos con múltiples colaboradores, donde cada participante recibe de Claude un resumen en lenguaje sencillo sobre los cambios anteriores, el razonamiento y las próximas tareas, con soporte para secciones paralelas, crítica estructurada y notificaciones por Slack/Signal.
Prism MCP v5.1 añade compresión de memoria 10x y aprendizaje del agente a partir de correcciones.
Prism MCP v5.1 presenta una compresión de memoria 10 veces mayor mediante TurboQuant portado a TypeScript, permitiendo millones de recuerdos en una computadora portátil sin bases de datos vectoriales. La actualización añade aprendizaje del agente a partir de correcciones del usuario y una interfaz visual de grafo de conocimiento.
La herramienta Nia-docs crea un sistema de archivos local a partir de URLs de documentación para Claude AI.
La herramienta nia-docs permite ejecutar npx nia-docs con una URL de documentación para crear un sistema de archivos local de la documentación, que la IA Claude puede luego acceder directamente sin configuración adicional.