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.