Méthode IA

Cette méthode IA est née de mon retour d’expérience sur plusieurs projets développés avec ChatGPT et Claude.

Introduction

Que pouvons-nous créer grâce à l’IA pour améliorer le quotidien d’une entreprise ?

Depuis quelques années, les IA génératives ont bouleversé la manière de développer. Chaque mise à jour des derniers modèles marque une nouvelle progression. Mais bon nombre de démonstrations montrent encore un créateur demandant à une IA de produire une application complète:

PROMPT DE DÉMONSTRATION « Crée-moi une application météo »

En espérant que l’IA devine ce que le demandeur a dans la tête. Cette approche peut fonctionner pour de petits projets. Mais pour des besoins plus spécifiques, plus complexes, elle va vite atteindre ses limites. Quid de l’architecture, de la sécurité, de la maintenabilité, de la documentation ou encore de la conformité légale ?

Travailler sur plusieurs projets avec ChatGPT et Claude (Messagerie on-premise assistée par IA, Audit O365, CRM,…) m’a fait prendre conscience d’une réalité :

LE DÉCLIC Un processus de développement s’imposait

Parce qu’au début j’ai fait des erreurs. Je demandais à Claude de me développer toute l’application. C’était une mauvaise idée. Je pensais que les gros prompts étaient la norme. Mauvaise idée également.

J’ai ainsi créé une méthode de travail qui me permet de conserver la maîtrise de la conception, la gouvernance du projet et la responsabilité des décisions tout en exploitant les forces des IA que j’utilise. C’est cette méthode que je vais aborder ici.

Au commencement était la feuille de papier

Je suis de la vieille école comme on dit maintenant. Quand j’ai créé mes premières architectures de messageries, je sortais mon cahier, mon stylo, et je faisais un schéma. Tout simple avec juste les grandes lignes. Un serveur principal, des serveurs pivots et des serveurs fonctionnels. Quelques pare-feux ici ou là. Puis j’ai fait un peu de scripts et de développement. Rien de bien sorcier mais j’ai conservé ce mode de fonctionnement. Une condition d’entrée, des actions conditionnées selon des réponses, prévoir plusieurs cas possibles, pour afficher un résultat final ou effectuer une tâche particulière.

Toujours sur une feuille d’abord. Je trouve important de relier le cerveau à une action de la main. Comme une sorte de trait d’union entre l’idée et l’exécution.

Avant même d’ouvrir ChatGPT, je prends une feuille. Je note quatre choses :

• Quel problème je cherche à résoudre
• Pour qui ?
• Quelles sont les contraintes ?
• Ce qui ferait dire « ce projet est réussi »

Tant que je ne suis pas capable de répondre à ces questions, je considère que je ne suis pas prêt à solliciter une IA.

POINT D’ATTENTION Cette étape est primordiale. Si vous la ratez, vous partez sur de mauvaises fondations et devrez corriger le tir ensuite. Avec une perte de temps (le temps c’est de l’argent) et des tokens volatilisés.

Une fois ces bases établies vous pouvez passer à la deuxième étape.

La première architecture

J’ai posé mes idées, les besoins, les premières briques de mon architecture. Il est temps d’aller un peu plus loin en listant :

• Les modules
• Les flux
• Les composants
• Les données

À ce stade nous ne demandons toujours pas de coder à Claude. Ni ne demandons à ChatGPT son avis. Pas encore. On affine le schéma, on liste des points d’attention éventuels. Toujours sur une feuille de notre cahier. Une fois cette étape terminée, on peut soit partager notre feuille telle quelle directement à ChatGPT ou la refaire dans un format plus facilement lisible via votre logiciel préféré (Visio, Draw.IO, …). Selon le niveau de complexité, et la difficulté de relecture de votre écriture, cette dernière version est préférable. Mais les deux fonctionnent.

Vous êtes prêts ? Alors discutons avec ChatGPT.

Premiers échanges avec ChatGPT

Ici, j’utilise ChatGPT comme un architecte logiciel. Je ne lui demande jamais d’écrire du code à cette étape. Son rôle est différent : challenger mes choix, identifier les angles morts, proposer des alternatives et m’aider à construire une architecture robuste.

L’objectif ici est de construire une architecture robuste. Quand bien même vous penseriez avoir tout envisagé, bien analysé votre projet, l’IA trouvera toujours quelque chose à revoir ou améliorer. Et c’est tant mieux. L’IA ici est une aide précieuse pour monter le niveau qualitatif de votre architecture. Cette première étape est généralement assez rapide. Ensuite ça se gâte un peu.

Raffinement

On entre dans le cœur du sujet. Je vais échanger longuement et en plusieurs itérations avec ChatGPT. Et c’est normal. Si cette phase est très courte, c’est soit que votre projet est extrêmement simple, soit que vous passez probablement à côté de nombreux sujets.

Durant ces échanges, je vais affiner beaucoup de points importants :

• L’architecture
• La sécurité
• Les performances
• L’UX
• Le business

NE PAS SOUS-ESTIMER Selon la taille du projet, cette étape peut prendre plusieurs heures voire une journée complète. Ne sous-estimez pas cette étape. C’est la dernière avant la validation de l’architecture.

Validation de l’architecture

Maintenant que j’ai posé les fondations de mon projet et affiné son architecture, il faut la valider. C’est moi le patron, pas l’IA. En réalité, c’est probablement le point le plus important de cette méthode : l’IA intervient comme un spécialiste, mais la gouvernance du projet reste entièrement humaine. Les décisions d’architecture, les arbitrages techniques et les validations ne sont jamais délégués.

Je vais demander à ChatGPT (ou une autre IA) un document d’architecture qui va contenir :

• L’architecture (forcément)
• Les principes
• Les conventions
• L’organisation du code

Ce document est mon référentiel. C’est sur lui que je pourrai m’appuyer pour m’assurer que le développement ne s’en écarte pas.

Je suis maintenant à la fameuse étape dite du « GO/NOGO » où, en tant que chef de projet, je vais passer la main aux développeurs. Ici mon développeur s’appelle Claude mais je dois encore lui dire quoi faire, et comment. On y va ?

Les prompts pour Claude AI

Une fois l’architecture validée, je change complètement de logique. ChatGPT laisse sa place à Claude, qui intervient ici comme un développeur spécialisé. Son objectif n’est plus de réfléchir à l’architecture mais de produire le code conformément au référentiel établi.

Mais pas n’importe comment. Je commence par lui fournir un cahier des charges précis et quelques consignes. Je vous conseille fortement de travailler en mode projet avec Claude. Ceci permet de centraliser vos différents prompts, d’avoir un dossier sur votre ordinateur dédié à ce projet et surtout, surtout, de donner des lignes directrices à Claude. Ce dernier a beau être puissant, il est conseillé de lui donner un modus operandi de ce que l’on veut qu’il fasse pour nous. Sans cela, je risque d’avoir parfois des résultats en deçà de mes attentes voire complètement à côté. Ça m’est déjà arrivé sur mes premiers projets. On apprend vite à corriger le tir. Aussi je vais lui donner un fichier Markdown avec :

• Le contexte
• Les contraintes
• Le résultat attendu
• Les critères d’acceptation
• La documentation

Autrement dit, un cahier des charges précis de ce que j’attends de lui. Je ne me prends pas la tête, ChatGPT est très bon pour faire ce fichier. Une fois ce fichier créé, je le mets à disposition à Claude dans la partie instructions du projet.

Ensuite c’est simple, je vais demander à ChatGPT de créer les prompts de manière itérative pour Claude. ChatGPT va décomposer le projet en plusieurs prompts. Il est conseillé de passer par plusieurs prompts, Claude est plus efficace ainsi. Sinon il a tendance à perdre les pédales et à se croire dans un concert de Pink Floyd.

C’est la première grande partie du développement de votre produit.

Le développement

J’envoie maintenant mes prompts (via le très basique et rudimentaire copier/coller) dans l’ordre que ChatGPT m’a donné.

RÈGLE Une règle simple : un prompt ==> on attend que Claude ait fini avant d’envoyer le prompt suivant.

Il pourra me poser des questions s’il en estime le besoin. Je n’ai pas la réponse (ça peut arriver) ? Pas de panique, je demande à ChatGPT de répondre pour moi. Il me dira quoi faire.

Claude va produire normalement :

• Le backend
• Le frontend
• Les API
• Le(s) Docker(s)
• La base SQL éventuelle

Le tout en plusieurs itérations. Cette étape peut être assez longue selon la complexité du projet. Avoir l’abonnement adéquat est conseillé. Si je suis un peu juste sur les tokens, je découpe les itérations sur plusieurs jours.

Une fois la passe des itérations effectuée, je communique à ChatGPT les résultats. La documentation créée suffit en général mais je peux également fournir des captures d’écran. Selon les résultats, ChatGPT me fournira une nouvelle liste de prompts à injecter dans Claude. Je vous conseille fortement de lire les analyses de ChatGPT. Même s’il est très bon sur cette partie, ça reste une IA qui peut faire des erreurs. Et avant de valider la prochaine itération de prompts, je vérifie qu’il ne dit pas de bêtises ou oublie des points importants.

L’humain doit toujours rester le valideur. C’est la règle.

Validation humaine

Après chaque lot de prompts je dois vérifier :

• La logique
• La cohérence
• La lisibilité

Et faire des tests. Des bugs sont possibles à ce stade, c’est le bon moment pour les corriger avant d’implémenter les prompts suivants. Je fais faire des prompts correctifs à ChatGPT si besoin avant d’avancer dans l’implémentation des fonctions suivantes.

Documentation

Après chaque phase d’itérations la documentation doit être mise à jour :

• README
• Architecture obtenue
• API
• Guides utilisateurs
• Guides intégrateurs
• Toute documentation utile

Je passe du temps à les relire. Il est rare qu’il y ait des erreurs mais ça reste possible. La phase de développement est terminée, il reste à vérifier que tout le projet tienne bien la route.

Audits

Une fois le développement terminé, Claude change une nouvelle fois de rôle. Il ne développe plus. Il devient un auditeur technique chargé d’examiner de manière critique le travail réalisé.

Je demande les prompts à ChatGPT mais selon le projet, une demande directement dans Claude est également faisable. Plusieurs audits sont à faire :

• Audit de sécurité
• Revue de code
• UX
• Performances
• Conformité OWASP
• Architecture (l’architecture obtenue est-elle conforme à celle souhaitée ?)
• Documentation (manque-t-il quelque chose ? Erreurs éventuelles ?)

L’IA ne va pas développer ici, elle va analyser et critiquer son travail. Je relis les documents obtenus et les fais analyser par ChatGPT.

Corrections

Les audits ont révélé des points d’attention. Corrections, améliorations, il y en aura forcément.

Je demande à ChatGPT de faire les prompts de corrections que j’envoie à Claude. Une fois le travail fini, je refais les audits. ChatGPT mettra des notes sur les audits, je devrais avoir entre 9 et 10/10 au final. En dessous il y a des points à revoir.

Documentation finale

Toutes les étapes sont terminées et validées, il est temps de constituer le véritable dossier du projet :

• L’architecture finale
• Changelog
• Documentation utilisateurs
• Guide administrateurs
• Audit sécurité
• Revue de code
• Tests
• Release Notes

Je demande les prompts à ChatGPT pour que Claude crée les documents demandés si besoin.

Validation finale (ou presque)

Je fais une revue globale du projet. Je teste le produit obtenu et je valide au minimum les points suivants :

• Cohérence
• La sécurité
• L’ergonomie
• Les performances
• La maintenabilité

Si tout est bon, je peux envoyer le résultat à un développeur. Oui vous avez bien lu, un développeur. Vous allez peut-être me dire à quoi bon ? À moins d’être déjà un développeur senior vous-même avec un nombre incalculable de lignes de code à votre actif, je ne saurais que trop vous conseiller cette étape.

Si comme moi vous êtes avant tout un chef de projets avec certes un peu d’expérience dans le développement, ce n’est clairement pas suffisant. Dire le contraire est avoir un ego plus développé que ses compétences réelles. Malgré le processus développé ici, l’expérience personnelle vécue a montré qu’une passe d’un développeur n’était pas du luxe.

Même s’il y a très souvent peu de choses à corriger il en reste toujours un peu. Rien de très problématique en général, mais suffisamment important pour que l’on y porte un peu d’attention.

Cette étape est souvent rapide (sauf gros projet) mais nécessaire au final. Il peut aussi y avoir quelques changements mineurs à effectuer pour que l’application que vous avez créée qui fonctionne très bien sur votre Mac puisse fonctionner sur un serveur dédié sur un tout autre OS. Le mieux étant encore de laisser faire celui qui connaît le mieux cet environnement. 

Si l’on devait résumer son rôle il consisterait à :

✓  Vérifier la qualité du code

✓  Exécuter les tests fonctionnels

✓  Réaliser une revue de sécurité supplémentaire

✓  Identifier des régressions éventuelles

✓  Proposer des améliorations possibles

Si vous avez cette casquette tant mieux. Mais laisser un œil extérieur regarder le projet n’est pas une tare, bien au contraire.

Publication

Toutes les étapes sont terminées, la documentation à jour, les bugs corrigés et la sécurité renforcée. Je peux publier mon projet ou le livrer au client final.

Une dernière chose

Vous vous posez peut-être une question : Pourquoi ChatGPT + Claude ?

Avec le temps, je me suis aperçu que chaque IA possède ses points forts. Plutôt que d’essayer d’en faire un outil universel, je préfère leur attribuer un rôle précis dans le processus de développement.

RÉPARTITION DES RÔLES

RÔLE	OUTIL
● Architecte	ChatGPT
● Développeur	Claude
● Auditeur	Claude
● Décideur	Humain

In fine, les deux se trouvent être complémentaires. Les lacunes de l’un étant comblées par l’autre, et vice versa.

Ce que cette méthode m’a appris

Au début je pensais que soumettre l’idée d’une application en la détaillant un peu suffisait à l’IA pour qu’elle développe rapidement derrière. Que faire directement les prompts dans Claude suffisait également. Et que les audits n’étaient pas utiles. C’étaient des erreurs :

✓  L’architecture est l’étape la plus importante

✓  L’écriture du prompt peut être déléguée à une autre IA que celle qui code

✓  Les audits sont essentiels en fin de projet

✓  Toujours relire les résultats créés par IA

Les IA génératives donnent l’illusion que créer une application est facile et rapide. C’est vrai en partie. Mais elles ne suppriment pas les fondamentaux qui eux restent encore du domaine de l’humain.

Conclusion

Je tenais à vous partager cette méthode car elle a été acquise au fil des projets et m’a permis :

• D’obtenir des architectures plus cohérentes
• De réduire le nombre d’allers-retours en développement
• D’améliorer de manière significative la qualité de la documentation
• D’intégrer les audits de sécurité et de qualité dès le cycle de développement
• De conserver une vision globale du projet malgré l’utilisation d’IA générative
• De réduire le temps de vérification du développeur senior

Les IA génératives vont continuer d’évoluer. Demain, les modèles évolueront encore. En revanche, une gouvernance claire, une architecture solide, une documentation maintenue et une validation humaine resteront les véritables fondamentaux d’un projet logiciel.

Ce que je vous ai exposé ici n’est pas une méthode pour travailler avec ChatGPT ou Claude. Ou les deux. C’est une méthode pour continuer à produire des applications de qualité dans un monde où les IA deviennent des partenaires de développement.

N’OUBLIEZ PAS Une IA peut écrire une grande partie d’une application. Elle ne porte jamais la responsabilité du produit livréLe rôle du chef de projet ne disparaît pas avec l’IA. Il devient encore plus important.

Et vous, comment procédez-vous ?