Outil de refactoring assisté par IA pour codebases C++/Qt legacy

.\install.ps1 `
    -ProjectPath .\samples\SampleProject `
    -SolutionFile SampleProject.sln `
    -BuildScript "scripts/build.ps1"

Le projet SampleProject contient un main.cpp avec plusieurs dettes techniques typiques :

• God Object : Classe Manager monolithique (240 lignes)
• Gros constructeur : 70 lignes d'initialisation
• Fuites memoire : Allocations sans libération
• Fonctions monolithiques : doStuff() fait 7 tâches différentes

/refactor:explain samples/SampleProject/main.cpp

flowchart LR
    E[EXPLAIN] --> P[PROPOSE]
    P --> G[GENERATE]
    G --> S[SCORE]

    E ---|VOUS| R[LISEZ]
    P ---|VOUS| D[DECIDEZ]
    G ---|VOUS| V[VALIDEZ]
    S ---|VOUS| J[JUGEZ]

Analyse structurelle et identification de la dette technique :

• Structure (classes, methodes, dépendances)
• Dette technique classifiee par sévérité
• Métriques de complexité (cyclomatique, lignes/fonction)
• Éléments Qt spécifiques (Q_OBJECT, signals/slots)

Artefact : .refactor/analysis.md

Identification et classement des cibles potentielles :

Chaque proposition inclut :

• Identifiant unique
• Type de refactoring
• Niveau de risque avec justification
• Dépendances entre propositions
• Métriques attendues

Artefacts : .refactor/proposal.md, .refactor/proposal.json

Transformations appliquees de manière sécurisée :

1. Backup automatique : Copie dans .refactor/backup/{timestamp}/
2. Résolution des dépendances : Tri topologique
3. Application : Modifications du code source
4. Compilation : Exécution du script de build
5. Correction automatique : Max 3 tentatives en cas d'erreur
6. Rollback : Restauration si échec

Artefact : .refactor/generate-report.md

Comparaison objective avant/après :

Artefact : .refactor/score-report.md

Refactor EXpert connait les spécificités de Qt et les protège :

.refactor/
├── config.yaml              # 📝 Configuration
├── analysis.md              # 🔍 Diagnostic (EXPLAIN)
├── proposal.md              # 💡 Propositions (PROPOSE)
├── proposal.json            # 📋 Propositions parsables
├── generate-report.md       # ⚡ Rapport d'execution (GENERATE)
├── score-report.md          # 📈 Bilan (SCORE)
└── backup/                  # 💾 Sauvegardes
    └── 20250126_143022/
        └── samples/
            └── SampleProject/
                └── main.cpp

Le fichier .refactor/config.yaml est généré automatiquement :

user:
  name: 'Votre Nom'
  language: 'Français'

project:
  path: 'C:/MonProjet'
  solution: 'MonApp.sln'
  build_script: 'build.ps1'

qt:
  enabled: true
  constraints:
    protect_q_object: true
    protect_signals_slots: true
    exclude_ui_files: true

1. Vous décidez : L'IA ne modifie jamais du code sans validation explicite
2. Progressivité : Interventions ciblées, pas de "big bang"
3. Pas d'effet de bord : Chaque refactoring améliore la situation
4. Transparence : Tous les risques sont explicités avant intervention
5. Sécurité : Backup, compilation et rollback garantis

• Support de CMake (actuellement Visual Studio .sln)
• Génération automatique de tests unitaires
• Détection automatique des patterns récurrents
• Intégration CI/CD
• Mode "brigade" : plusieurs agents en parallèle

• PowerShell 5.1+
• Projet C++/Qt avec fichier .sln et script de build
• Claude Code ou GitHub Copilot

Distribué sous licence MIT - voir le fichier LICENSE pour plus de détails.