Migration de projet WD/WB vers une autre techno grâce à l’IA

[Fabrice Garcia]

Up

0

Down

::

Un guide interactif pour suivre votre progression (page HTML à télécharger) Guide_Interactif_Migration_WinDev_IA_Methode_Fabrice_Garcia

autre ref : https://www.linkedin.com/pulse/m%C3%A9thode-de-migration-projet-windev-webdev-vers-une-autre-garcia-tsj2f/

I — À SAVOIR AVANT DE COMMENCER LA MIGRATION

1 — Pour migrer votre projet, utilisez Claude AI d’Anthropic comme IA (rien d’autre), ne vous laissez pas influencer.

• Moteur conseillé pour définir/générer l’analyse et ses documents : Fable 5.
• Moteur conseillé pour générer le code : Opus 5 (uniquement parce que moins cher pour un résultat équivalent dans ce domaine).
• Abonnement conseillé :
  • Forfait Pro si vous avez très peu de temps à consacrer, mais vous serez très limité. Disons que c’est bien pour débuter, apprendre ou se faire un avis, mais si votre projet est gros, vous pouvez oublier complètement le forfait Pro pour la migration.
  • Forfait Max : très fortement conseillé pour migrer de façon sérieuse. Si vous êtes nombreux à plein temps pour migrer plusieurs projets, prévoir un forfait Max par programmeur.

2 — Quel mode d’utilisation pour l’IA : on l’utilise comment ?

Lorsque vous avez découvert l’IA (ChatGPT, Claude ou autre), vous avez probablement utilisé/découvert cela dans votre navigateur Web. Cette méthode n’est pas du tout adaptée aux développeurs professionnels pour la migration de projets. Il va falloir complètement l’oublier et la rejeter.

Il vous faudra installer obligatoirement l’application Claude Desktop. Si vous ne le faites pas, ce n’est pas la peine de continuer, c’est sans espoir. Le but n’est pas du tout de faire des discussions sympas avec l’IA : le but, c’est de changer totalement votre méthode de travail.

Il va falloir obligatoirement consacrer un ou plusieurs dossiers sur votre disque dur à l’IA. C’est-à-dire donner accès à l’IA à une partie de votre arborescence du disque. C’est dans ces dossiers que vous mettrez tout ce qu’il faut pour que l’IA travaille. Ne la laissez pas accéder à tout votre disque n’importe comment. Cantonnez-la obligatoirement à un certain nombre de dossiers. L’idéal serait peut-être d’avoir un disque/une partition dédié(e).

Faites des sauvegardes systématiques et hyper fréquentes du contenu de ces dossiers (2 fois par jour minimum).

Évidemment, ne travaillez pas directement sur des environnements de production.

3 — Exigences au niveau des technologies de type langages de programmation à adopter

• Il faut évidemment que Claude AI connaisse votre langage de développement, mais il ne suffit pas qu’elle le connaisse un peu. Plus un langage est pratiqué au niveau mondial, plus il a d’utilisateurs, plus l’IA a pu être entraînée sur ce langage et plus le code sera sain et performant. Il est évident, par exemple, que si vous choisissez Python ou C++, vu le succès de ces langages, vous n’aurez aucun problème à ce niveau.
• Connaître le langage de développement ne va pas suffire : il va falloir que la technologie utilisée pour générer l’interface graphique de votre futur logiciel soit connue.

Par exemple : supposons que vous choisissiez le langage Rust pour faire le programme. Vous pouvez choisir Tauri pour générer l’interface graphique.

Mais si vous choisissez Tauri, ça sous-entend 2 choses : Claude connaît Tauri (OK), mais aussi et surtout Claude sait générer et peut générer dans un fichier texte du code Tauri.

C’est pareil si vous choisissez Python. Claude AI connaît très bien Python. Mais si vous voulez générer des logiciels Python très rapidement, un bon choix est de choisir Tkinter.

Parce que Claude connaît Tkinter et peut saisir du code Tkinter pour vous générer l’interface graphique.

Le piège, c’est de ne considérer que le langage et pas la technologie qui génère l’interface graphique. Claude AI ne peut pas faire du drag and drop de vos contrôles/champs sur une fenêtre : il va générer du code qui construit la fenêtre.

Donc, si vous voulez aller vite, il faut que Claude puisse générer le code du logiciel et le code de l’interface graphique. Sinon, c’est l’enfer : vous n’êtes pas sorti d’affaire !

• Pour les personnes qui comptent utiliser des technologies Web, il n’y a aucun problème. Si vous comptez faire du PHP/MySQL/JavaScript/CSS/HTML5, vous pouvez dormir tranquille, ça marchera.
• En général, si vous utilisez des langages connus de type Python, Rust, C++, PHP, Java, Swift, C#, vous n’aurez aucun problème au niveau du langage.

Faites seulement attention à la technologie utilisée pour générer le code de l’interface graphique. (Par exemple, faire du C#, c’est OK, mais avec WinForm, c’est un très mauvais choix, il me semble, car cela vous ralentit.)

En fait, de nos jours, faire une application ne nécessite pas de connaître un seul langage, mais plusieurs (le principal et celui de l’interface graphique).

Donc, choisissez votre technologie avec cela en tête.

---

II — PHASE DE RÉCOLTE D’INFORMATIONS POUR FUTURE ANALYSE

Si vous pensez que vous allez commencer à demander à Claude de coder directement votre projet, vous êtes dans l’erreur la plus totale. En fait, vous y arriverez peut-être un jour, mais vous aurez tellement perdu de temps et dépensé d’énergie que, franchement, vous allez vous faire très mal. Optez pour l’efficacité et la simplicité : soyez malin…

1 — Créez un dossier analyse_projet_X

Vous allez plus tard remplir ce dossier de deux types de fichiers uniquement :

• Des fichiers texte (.txt).
• Des fichiers Markdown (.md), qui sont aussi des formes de fichiers texte que l’on peut ouvrir notamment avec Visual Studio Code.

Vous allez complètement fuir/abandonner les fichiers PDF : c’est très mauvais pour nous, car cela consomme trop de tokens et pour d’autres raisons (plus lent à modifier et surtout ça ne nous sert à rien).

Donc, rappelez-vous bien : PDF : interdit !

Je ne veux que des fichiers .txt et .md, rien d’autre dans ce dossier.

2 — Allez dans l’analyse de votre projet WinDev

Icône Génération → Générer le script SQL → Choisir le type de base vers laquelle vous désirez migrer.

2 solutions :

• Soit le type de base de données est listé : parfait, choisissez-le.
• Soit le type de base de données que vous avez choisi est absent : prenez MySQL.

Enregistrez la description de la base dans le dossier analyse_projet_X sous le nom :

Base_windev.txt

3 — Créez un dossier documents_projet_X

Dans ce dossier, je ne veux que vous y mettiez que 3 types de choses. Il n’y a aucune exception à tolérer, juste ça :

• Des sous-dossiers.
• Des fichiers texte qui seront du code de votre projet WinDev (.txt).
• Des images au format PNG.

Il faut maintenant obéir à cette règle : chaque dossier/fichier devra être nommé avec la plus grande précision possible.

Par exemple :

Fenetre de saisie Article Onglet 1.png

et surtout pas un truc du genre :

FenArtOng1.png

où personne ne comprend rien.

Donc, il ne doit y avoir dans le futur que des images PNG et du code au format TXT : rien d’autre.

4 — Le plus gros travail (plusieurs jours) : récolter un maximum d’informations en provenance de votre application PC SOFT

Il va falloir faire les captures d’écran systématiquement de toutes les fenêtres de votre application (100 %). Ces captures doivent être précises, pas floues, avec une résolution et une taille suffisantes pour que l’on puisse lire clairement le nom de tous les libellés de champs et informations qui y sont affichés. Cela est vital, car Claude AI va lire ces captures d’écran pour déduire des informations et faire de la reconnaissance de formes et de caractères dessus.

Bonne nouvelle : ce n’est pas la peine d’exporter absolument tout le code de votre application dans des fichiers texte.

Il va falloir cependant exporter beaucoup de code. Vous choisirez vous-même le code à exporter en fonction de sa pertinence. Je fais confiance à votre intelligence pour cela. S’il y a des parties de programmes très délicates et très peu intuitives, mettez ce code dans des documents texte en priorité, notamment des règles de gestion qui ne peuvent être déduites.

Plus vous exportez du code, plus ça sera simple après. Claude AI comprend le langage WinDev/WebDev, il l’interprétera. Prenez bien soin de nommer avec la plus grande précision possible vos fichiers texte de code.

Lorsque Claude voit un fichier de code, il doit pouvoir comprendre la thématique sans pour autant avoir à le lire et à tout parcourir, sinon ça sera trompeur et plus lent.

---

III — PHASE DE GÉNÉRATION DE L’ANALYSE

Je le répète : à ce stade, il est encore beaucoup trop tôt pour penser à générer du code.

Oubliez donc le code, on n’y est pas encore.

1. Créez un projet dans Claude Desktop
2. Décrivez votre projet de migration lors de la création en quelques lignes sans trop parler, ça ne sert à rien
3. Donnez l’accès aux dossiers que nous avons créés
4. Ouvrez un fil de discussion en utilisant le moteur Fable 5 de préférence
5. Vous allez commencer une discussion basique avec Claude AI, mais attention, pas de blabla

Le but est de :

• Dire que vous voulez migrer un projet WinDev vers une nouvelle technologie (dire exactement laquelle : détailler très fortement ce point, langage, bases, etc.).
• Lui expliquer en quoi consiste votre projet actuel en WinDev : vous devez vous assurer qu’il a parfaitement compris la thématique.
• Lui interdire toute génération de code avec des mots très clairs :
  INTERDICTION TOTALE DE CODER : CELA EST UN ORDRE NON NÉGOCIABLE.
• Lui expliquer que vous allez lui demander de générer une analyse par RÉTRO-INGÉNIERIE.
• Lui expliquer que, pour l’aider, vous lui avez fourni des documents : lui indiquer vaguement le dossier concerné : documents_projet_X.
• Lui expliquer que l’analyse devra être générée au format .md (Markdown) dans le dossier analyse_projet_X.
• Lui expliquer que, plus concrètement, il va falloir générer plusieurs documents au format .md.
• Lui expliquer que la description de la base WinDev est contenue dans le document : Base_windev.txt.

Voici les documents qu’il devra générer GROSSO MODO :

• 01_CAHIER_DES_CHARGES.md (le plus important)
• 02_BASE_DE_DONNEES.md (très important, description de la base, informations dessus)
• 03_CHARTE_GRAPHIQUE.md (si vous désirez reprendre le look de votre ancien logiciel)
• 04_SPECIFICATIONS_FENETRES.md (décrit les fenêtres dont il a lu les images)
• 05_FENETRES_DEDUITES.md (décrit les fenêtres dont il a déduit l’existence, mais ne les a pas vues)
• 06_DEMANDES_INFORMATIONS.md (décrit des questions que l’IA vous pose parce qu’elle n’a pas tout compris ; elle mettra ces questions dans ce document)

Pourquoi GROSSO MODO ? Parce qu’en fonction de la nature de votre projet, il faudra essayer d’en demander plus… Donnez-lui l’ordre de procéder à la rétro-ingénierie et à la génération des documents demandés au regard des éléments fournis.

Une fois les documents générés : lisez-les tous, mais plus particulièrement :

• 01_CAHIER_DES_CHARGES.md
• 06_DEMANDES_INFORMATIONS.md

Cela pour savoir de quoi on parle.

Maintenant, vous allez inverser la situation : c’est à Claude AI de vous poser des questions. Notamment au regard du document :

06_DEMANDES_INFORMATIONS.md

Vous allez demander à Claude AI de vous poser des questions sous la forme de QCM (j’insiste : sous la forme de QCM !).

Cela dans le but de l’éclairer et surtout de corriger TOUT DE SUITE le cahier des charges et les autres documents.

TOUT CE QUE VOUS ALLEZ LUI EXPLIQUER DEVRA ÊTRE ÉCRIT OBLIGATOIREMENT DANS CES DOCUMENTS, CAR PLUS TARD ELLE VA TOUT OUBLIER : RETENEZ BIEN CELA.

CES DOCUMENTS SONT LE SOCLE DE VOTRE MIGRATION, VOTRE MÉMOIRE, SA MÉMOIRE. SANS CELA, VOUS ÊTES FICHUS.

Une fois que vous avez répondu à toutes les questions et qu’elle a modifié le cahier des charges : relisez tout sans rien modifier. Si vous n’êtes pas content sur un point, dites-le à l’IA, faites-le lui modifier par elle, ne modifiez pas vous-même directement. Discutez-en avec elle. Il faut que vous soyez certain d’être au top sur ces documents.

Une fois que c’est parfait, passez à la phase suivante.

---

IV — GÉNÉRATION DU PLAN D’ACTION

Une IA, ça oublie beaucoup de choses et ça perd le fil des discussions.

Parfois même, une session/un fil de discussion plante et vous devrez réexpliquer un certain nombre de choses que vous n’aurez pas notées dans des documents .md.

Donc, il est indispensable, pour ne pas perdre le fil, de générer un plan d’action.

• Demandez à l’IA de générer un plan d’action numéroté et structuré au format .md : PLAN_ACTION.md.
• Demandez-lui absolument que ce plan d’action soit représenté sous la forme d’une liste de tâches à effectuer.
• Demandez-lui de débuter la phrase de chaque tâche par les caractères [ ]. Le but, c’est que lorsqu’elle effectue cette tâche, elle puisse cocher avec un X (comme cela : [X]).
• À la fin de chaque tâche, demandez-lui de créer un jalon de validation que seulement vous aurez le droit de cocher pour signifier qu’un bloc de tâches est finalisé et testé par vous.

Une fois qu’elle a généré le plan d’action : lisez-le. Si vous êtes un développeur expérimenté, vous verrez qu’il contient des aberrations dans l’ordre d’exécution des tâches. Demandez à l’IA de remonter ou de descendre certaines tâches dans le plan d’action.

Par exemple, on ne peut pas faire :

« Fenêtre saisie Facture »

avant d’avoir fait :

« Fenêtre Saisie Article »…

Ce plan d’action, ça va être le document le plus important que vous ayez avec le cahier des charges. C’est avec lui la colonne vertébrale de votre projet. Sans cela, vous allez vous noyer. Au cours de la migration, vous pourrez faire rajouter/modifier/supprimer des choses à l’IA dans ce plan d’action. À chaque tâche qu’elle effectuera, demandez-lui de cocher les cases de ce plan d’action.

Pour finir : il va falloir dire au revoir à Fable 5 (le meilleur modèle pour l’instant), car concrètement, c’est trop cher actuellement.

Donc, comme la conséquence risque d’être un oubli massif, vous allez lui demander de générer un dernier document à destination d’une autre IA/moteur (Opus 5) :

CONSIGNES_REPRISE.md

Elle devra notamment y écrire :

• La mission.
• Avant toute chose : lire les dossiers X.
• État du projet à la passation (24/07/2026).
• Règles de conduite ABSOLUES (les choses interdites, etc.).
• La façon de travailler avec vous.
• Rituel de début de session.

Le but, c’est de retransmettre à une autre IA le savoir qu’elle a récolté. D’ailleurs, vous allez lui dire que vous ne l’avez utilisée que pour l’analyse et que le codage sera fait par quelqu’un d’autre : il faut qu’elle consigne les informations pour poursuivre le développement du projet. Ce document de reprise vous servira aussi en cas de sinistre/crash de votre ordi ou autre. Il faudra le mettre à jour tout au long de vos migrations. C’est un document assez court qui dit là où vous en êtes et comment travailler.

---

V — PHASE JUSTE AVANT CODAGE DE L’APPLICATION

1 — Créez un autre fil de discussion avec le moteur Opus 5

Opus 5 codera avec la même qualité que Fable pour un coût inférieur d’environ 50 %.

2 — Demandez à Opus 5 / Claude AI de relire les documents

Demandez à Opus 5 / Claude AI de relire les documents d’analyse .md, la description de la base, ainsi et surtout :

• CONSIGNES_REPRISE.md
• PLAN_ACTION.md

3 — Demandez-lui ultimement si elle est prête pour commencer à coder

Demandez-lui si elle est prête à commencer à coder et si elle a des questions QCM à vous poser avant de commencer globalement.

4 — Expliquez-lui brièvement comment elle doit progresser dans le développement

Il ne faut pas qu’elle pense qu’elle doit tout coder d’un coup.

---

VI — DÉBUT CODAGE APPLICATION — DÉBUT DE LA MIGRATION

Selon la difficulté des tâches ou des blocs de tâches et leur complexité, il faudra toujours procéder ainsi :

Progression par tâche uniquement ou par groupe de tâches (plus rapide).

1 — INTERDISEZ LE CODAGE DE LA TÂCHE/OU DU BLOC DE TÂCHES PRÉVU DANS LE PLAN D’ACTION

Donnez pour cela un ordre franc :

STOP CODAGE ! On discute uniquement.

2 — Discutez de la tâche à effectuer

Donnez-lui des infos, des conseils, le contexte informatique, mais aussi éventuellement commercial s’il le faut.

3 — Demandez-lui si elle a des questions QCM à vous poser

4 — Une fois que tout est OK : donnez-lui l’ordre de coder la tâche ou le bloc de tâches

Et de stopper là lorsqu’elle aura fini.

Il faut maîtriser l’IA qui est parfois comme un cheval fou qui ne sait pas s’arrêter…

Ordre :

Go, Code ! Feu vert, code cette tâche !

5 — Une fois la tâche/le bloc de tâches effectué : vous testez

En fonction de cela, vous bouclez sur la tâche actuelle si les tests sont mauvais.

S’ils sont bons : tâche suivante.

NE PAS OUBLIER DE COCHER LA TÂCHE DANS LE PLAN D’ACTION.

---

Directive

N’essayez pas de coder ou de corriger le code vous-même. Le code n’est plus votre problème, ce n’est plus à vous de le faire, ce n’est plus votre métier.

• S’il y a un bug, vous pouvez essayer d’aider l’IA à le trouver, lui donner des conseils, des indications, lui demander de générer des logs, mais vous ne touchez à rien.
• Plus une seule ligne de code tapée par un humain, absolument aucune.
• C’est à l’IA de corriger ses bugs, elle les corrigera plus vite que vous. Ne touchez surtout à rien dans le code. Je ne peux pas être plus clair.
• C’est l’IA qui va générer 100 % du code de votre projet.
• Vous êtes son manager, son coach, vous êtes un analyste, un testeur, un architecte, un rédacteur de documents texte, vous n’êtes plus un codeur !

[Fabrice Garcia]

Up

0

Down

::

Dans cette méthode que je vous ait présenté je pense ne pas assez avoir insisté sur une chose :
Les Captures d’écrans sont quelque chose de vraiment essentielles.
Vous devez systématiquement demander à l’ia de s’appuyer dessus et pas que sur les documents .md et txt.
Il faut comprendre que le but ce n’est pas de passer sa vie a faire des prompts.
Il n’y a rien de mieux qui décrit votre futur projet que votre ancien projet Windev.
Donc la clef c’est la retro-ingénierie.

[Auteur]

Messages