Programación con IA
Cómo usar IA para documentar software heredado
Un flujo de trabajo práctico para documentar software heredado desde código y evidencia operativa: arquitectura, flujos de datos, reglas, dependencias, runbooks y verificación sin adivinar.
La documentación de software heredado debe indicar qué se sabe, qué evidencia lo respalda y qué sigue siendo incierto. La IA puede explorar repositorios y proponer preguntas, pero no debe rellenar reglas de negocio, dependencias o comportamiento de producción sin prueba.
Flujo de trabajo
- Reúna repositorios, versiones desplegadas, diagramas, tickets, configuraciones, registros, runbooks y responsables operativos.
- Mapée entradas, módulos, servicios, datos, colas, integraciones y límites de confianza.
- Guarde archivo, línea, configuración, traza o test detrás de cada afirmación.
- Separe arquitectura confirmada, hipótesis, comportamiento observado y preguntas pendientes.
- Documente flujos críticos, reglas, fallos, recuperación y dependencias.
- Valide con mantenedores y con pruebas o entorno real cuando sea seguro.
Prompt
Documenta este sistema heredado solo con evidencia de repositorio y operación. Produce mapa de arquitectura, flujos de datos, dependencias, reglas observadas, runbooks, riesgos y preguntas abiertas. Cita archivos, configuraciones o trazas para cada afirmación. No inventes comportamiento, acceso ni secretos.