Desarrollo Guiado por Manual: Un Método para Prevenir la Divergencia Confiada del Código de Claude
El Desarrollo Guiado Manual (MDD) es una metodología diseñada para resolver la divergencia confiada en Claude Code, donde la IA produce código incorrecto que se compila y pasa sus propias pruebas porque está trabajando a partir de suposiciones incorrectas sobre el sistema.
El Problema: Divergencia Confiada
Cuando Claude Code trabaja en grandes bases de código de producción, lee algunos archivos, infiere patrones y comienza a programar basándose en suposiciones. Esto conduce a la divergencia confiada: código que parece correcto, se ejecuta, pasa las pruebas, pero está mal porque Claude escribió pruebas contra sus suposiciones en lugar del comportamiento real del sistema. La divergencia solo sale a la luz en producción cuando los usuarios reales encuentran casos límite que Claude nunca supo que existían.
El autor señala que esto no se trata solo de que Claude no conozca su sistema, sino de que los desarrolladores tampoco pueden narrar de manera confiable todo su sistema. A las 11 de la noche, no recordará mencionar que los operadores están limitados a grupos específicos, que ROLE_HIERARCHY se define en tres archivos diferentes o que las políticas de nivel base son solo del sistema y no se pueden crear a través de la API.
Resultados de MDD en Producción
En una auditoría de producción utilizando MDD:
- Siete secciones auditadas
- 190 hallazgos identificados
- 876 nuevas pruebas escritas
- 7 horas y 48 minutos de tiempo de sesión de Claude Code
- Se estima que se ahorraron de 234 a 361 horas de tiempo de desarrolladores humanos (relación de compresión de 30-46x)
- Cero violaciones de reglas CLAUDE.md en todas las secciones
La base de código tenía más de 200 rutas, más de 80 modelos y una canalización de aplicación de daemon que convierte políticas de red en reglas nftables activas en el host.
Cómo MDD Difiere de Otras Herramientas
MDD aborda un problema diferente al de las herramientas existentes:
- GSD resuelve la degradación del contexto (deterioro de la calidad a medida que las sesiones se llenan)
- Mem0 y Claude-Mem resuelven la amnesia de sesión (olvidar todo cuando terminan las sesiones)
- MDD resuelve la divergencia confiada (código incorrecto basado en suposiciones erróneas)
Los tres pueden ejecutarse juntos sin conflictos. RuleCatch, que monitorea la aplicación de reglas en tiempo real, reportó un 60% menos de violaciones de reglas durante la construcción de SwarmK con MDD en comparación con sesiones sin MDD: mismo modelo, mismas reglas, misma base de código.
La metodología, los prompts y los datos sección por sección están documentados y son reproducibles según la fuente.
📖 Lea la fuente completa: r/ClaudeAI
👀 Ver también
Reemplazando complejas tuberías de recuperación con simples comandos de shell de git para agentes LLM.
Un desarrollador reemplazó toda su tubería de recuperación de agentes de IA (sentence-transformers, rank-bm25, tubería de LLM de dos pasos) con una sola herramienta que permite al agente ejecutar comandos de shell de solo lectura en un repositorio git, reduciendo el tamaño de la imagen Docker en ~3 GB y eliminando problemas de tiempo de espera.
Código VT: Agente de Codificación TUI de Código Abierto en Rust con Soporte Multi- Proveedor y Habilidades de Agente
VT Code es un agente de codificación de interfaz de usuario de terminal (TUI) basado en Rust que admite Anthropic, OpenAI, Gemini y Codex, con inferencia local a través de LM Studio y Ollama. Incluye Agent Skills, Model Context Protocol y Agent Client Protocol.
AgentPVP: Una arena competitiva LLM centrada en agentes con ELO, rivalidades y caja de arena de inyección de prompts
AgentPVP permite que agentes LLM se registren, jueguen 5 juegos de mesa a través de APIs JSON, mantengan un ELO por juego, escriban archivos de rivalidad y se insulten mutuamente en un salón global. El HTML es opcional: la API es el sitio.
Forge: Convierte una Mac o una Máquina Linux en un Host de Desarrollo Siempre Activo para Agentes de IA de Programación
Forge es una herramienta de código abierto que instala un daemon para convertir cualquier máquina Mac o Linux en un host de desarrollo permanente y siempre activo. Mantiene los agentes de codificación de IA en funcionamiento cuando te alejas, proporciona un panel web para monitorear y utiliza Tailscale para acceso remoto seguro mediante SSH.