Programmation avec l'IA

Comment utiliser l'IA pour documenter un logiciel legacy

Un flux de travail pratique pour documenter un logiciel legacy à partir du code et de preuves opérationnelles : architecture, flux de données, règles, dépendances, runbooks et vérification sans deviner.

Publié Mis à jour
Logiciel legacyDocumentation logicielleArchitecture systèmeCartographie du codeProgrammation avec l'IA

La documentation d'un logiciel legacy doit indiquer ce que l'on sait, quelle preuve le soutient et ce qui reste incertain. L'IA peut explorer des dépôts et proposer des questions, mais ne doit pas combler règles métier, dépendances ou comportement de production sans preuve.

Flux de travail

  1. Rassemblez dépôts, versions déployées, diagrammes, tickets, configurations, journaux, runbooks et responsables opérationnels.
  2. Cartographiez entrées, modules, services, données, files, intégrations et limites de confiance.
  3. Conservez fichier, ligne, configuration, trace ou test derrière chaque affirmation.
  4. Séparez architecture confirmée, hypothèses, comportement observé et questions en attente.
  5. Documentez flux critiques, règles, pannes, reprise et dépendances.
  6. Validez avec les mainteneurs et avec des tests ou un environnement réel lorsque c'est sûr.

Prompt

Documente ce système legacy uniquement avec des preuves de dépôt et d'exploitation. Produis une carte d'architecture, des flux de données, des dépendances, des règles observées, des runbooks, des risques et des questions ouvertes. Cite fichiers, configurations ou traces pour chaque affirmation. N'invente ni comportement, ni accès, ni secrets.

Guides associés