Un Flujo de Trabajo de IA en Dos Pasos para la Modernización de Código Heredado
Una publicación de Reddit en r/ClaudeAI argumenta en contra de simplemente pedirle a la IA que 'refactorice' código espagueti heredado, señalando que la IA tiende a preservar las estructuras existentes defectuosas. En cambio, propone un flujo de trabajo de 'ingeniería inversa' en dos pasos que aprovecha el razonamiento de los LLM de manera más efectiva.
El problema con la refactorización directa
Cuando pegas código antiguo en un agente de IA con una solicitud como 'Por favor refactoriza esto y hazlo limpio', el resultado a menudo es solo una versión pulida de la misma mala arquitectura. La IA está sesgada por el código que proporcionas: intenta preservar tu estructura, nombres de variables y flujo lógico, incluso si estaban defectuosos desde el principio.
El proceso de 'ingeniería inversa' en dos pasos
Paso 1: Extraer la intención (El 'Qué')
No le pidas a la IA que arregle el código. En su lugar, pídele que ignore la estructura del código y extraiga la lógica de negocio. Específicamente, haz que escriba un Documento de Requisitos de Negocio (BRD) de alto nivel basado en el archivo. Esto produce la lógica pura sin la deuda técnica.
Paso 2: La construcción 'Desde Cero' (El 'Cómo')
Toma ese BRD nuevo y aliméntalo en un prompt de 'Arquitecto Maestro'. Ahora, la IA no está arreglando errores antiguos; está construyendo una solución desde cero usando las mejores prácticas modernas. Este enfoque también facilita la migración tecnológica (por ejemplo, de Java heredado a Node.js moderno) porque la capa intermedia del BRD es independiente de la tecnología.
La publicación menciona que el prompt específico de 'Arquitecto Maestro' utilizado para el Paso 2 se proporciona en el primer comentario del hilo de Reddit.
📖 Leer la fuente completa: r/ClaudeAI
👀 Ver también
Claude no es malo programando — tu configuración de contexto es el problema
Después de meses usando Claude, un desarrollador argumenta que los fallos provienen de cómo estructuras el contexto, no del modelo en sí. Mejoras clave: separar instrucciones de la lógica, reducir el ruido del contexto y usar patrones estables.
Ejecutando OpenClaw dentro del contenedor Docker de Ollama para una red más simple
Un usuario de Reddit muestra cómo instalar OpenClaw dentro del contenedor Docker oficial ollama/ollama para que OpenClaw se comunique con Ollama a través de localhost, evitando host.docker.internal y configuración de red adicional. La desventaja es un mayor uso de RAM.
Código Listo para Agentes: Reglas Negativas, Nombres Precisos, READMEs de Directorios
Un desarrollador comparte cómo las reglas de CLAUDE.md, las instrucciones negativas y la nomenclatura precisa redujeron el desperdicio de tokens y evitaron que Claude Code inflara clases como UserManager.
Añade listas de verificación decoradas con emojis en Claude agregando una línea a CLAUDE.md
Agrega una línea de marcadores a tu CLAUDE.md a nivel de usuario para que Claude decore las listas de verificación con emojis de estado — 14 iconos fijos para completado, en ejecución, fallido, bloqueado, etc.