Penser architecture avec l'IA
Planifier, structurer et documenter tes projets grâce à l'IA.
8.1La carte du monde
Dans un RPG open-world, tu ne pars pas explorer sans carte. Tu regardes d'abord le terrain, tu repères les zones dangereuses, tu planifies ton itinéraire. Coder un projet, c'est pareil : si tu commences sans plan, tu vas te perdre.
L'IA peut t'aider à dessiner cette carte. Pas en décidant à ta place, mais en te posant les bonnes questions et en structurant tes idées.
8.2Structurer un projet from scratch
Tu es un architecte frontend senior.
Je veux créer une application de [description du projet].
Cible : [type d'utilisateurs]
Stack imposée : Next.js 15 (App Router), TypeScript, Tailwind CSS
Fonctionnalités clés :
1. [fonctionnalité 1]
2. [fonctionnalité 2]
3. [fonctionnalité 3]
Avant d'écrire du code, j'ai besoin de :
1. Une structure de dossiers (App Router)
2. La liste des composants principaux avec leurs responsabilités
3. Le modèle de données (types TypeScript)
4. Les API routes nécessaires
5. La stratégie d'état (state management)
Présente chaque point avec un court paragraphe d'explication
de tes choix.8.3Faire valider un choix technique
Tu hésites entre deux approches ? L'IA peut jouer le rôle de l'avocat du diable sur chacune :
J'hésite entre deux approches pour [problème].
## Option A : [nom]
[description de l'approche]
## Option B : [nom]
[description de l'approche]
## Mon contexte
- [taille du projet]
- [taille de l'équipe]
- [contraintes de perf / SEO / temps]
Compare ces deux options avec un tableau :
avantages, inconvénients, complexité de mise en place,
maintenabilité sur 6 mois.
Donne-moi ta recommandation et explique ton raisonnement.Exemple d'utilisation réelle :
J'hésite entre deux approches pour le state management.
## Option A : Zustand
Store global simple, peu de boilerplate, léger.
## Option B : React Context + useReducer
Natif React, pas de dépendance, pattern Redux-like.
## Mon contexte
- App Next.js 15, 20-30 pages
- 2 développeurs
- State à partager : panier, auth, préférences UI
- Performance critique (e-commerce)
Compare ces deux options. Donne-moi ta recommandation.8.4Documenter avec l'IA
La documentation, personne n'aime l'écrire. Mais tout le monde regrette quand elle n'existe pas. L'IA peut faire le gros du travail :
README de projet
"Génère un README.md pour ce projet à partir de cette structure de fichiers et ce package.json."
Documentation de composant
"Ajoute une JSDoc complète à ce composant : description, props, exemples d'usage, cas limites."
Guide de contribution
"Écris un CONTRIBUTING.md pour ce projet. Conventions de code, process de PR, structure des commits."
Documentation d'API
"Documente cette API route : endpoint, méthode, params, réponses, codes d'erreur, exemple curl."
8.5Planifier une migration
Les migrations (changer de framework, upgrader une version majeure, refactorer une architecture) sont des moments où l'IA brille. Elle peut analyser ton code actuel et proposer un plan de migration étape par étape.
Tu es un architecte senior spécialisé en migrations frontend.
Je dois migrer mon projet de [ancien] vers [nouveau].
## État actuel
- [framework / version actuelle]
- [nombre de fichiers / composants]
- [dépendances critiques]
## Objectif
- [framework / version cible]
- [deadline approximative]
- [contraintes : pas d'interruption de service, etc.]
Propose-moi un plan de migration en phases :
1. Ce qu'on peut migrer sans risque
2. Les parties délicates qui demandent de l'attention
3. Ce qu'il faut tester en priorité
4. Un ordre de migration fichier par fichier
Pour chaque phase, estime la complexité (faible/moyenne/élevée)
et les pièges courants.Attention
L'IA peut proposer un plan de migration, mais elle ne connaît pas les détails cachés de ton projet (les hacks en prod, les cas limites non documentés, les dépendances implicites). Utilise son plan comme base et ajuste avec ta connaissance du terrain.
À toi de jouer
La prochaine fois que tu démarres un nouveau projet ou une nouvelle feature, commence par demander à l'IA de t'aider à structurer ton plan. Tu seras surpris de voir combien de temps tu gagnes en planifiant avant de coder.