Cartes mentales pour l'analyse technique : explorer un problème avec Freeplane
Structure d'une bonne carte d'analyse (contexte, contraintes, options, risques, décision) et passage de la carte aux tâches.
Avant d'écrire la moindre ligne de script, je pose le problème sur une carte mentale. Un texte linéaire force à choisir un ordre trop tôt ; une carte permet de jeter les idées en vrac, de les regrouper ensuite, et de voir d'un coup ce qui manque. J'utilise Freeplane (libre, fichiers XML versionnables), mais n'importe quel outil de cartes mentales convient.
Pourquoi une carte plutôt qu'un document
- On explore : les branches s'ajoutent au fil de la réflexion, sans réorganiser un plan.
- On voit les trous : une branche « risques » vide saute aux yeux.
- On peut replier : un détail technique ne pollue pas la vue d'ensemble.
- Les nœuds peuvent porter des notes et des liens vers des fichiers, des pages ou des requêtes.
Limite : une carte ne remplace pas un texte pour décider. Elle sert à explorer et à structurer ; la décision finale est écrite ensuite (voir l'article sur l'analyse avant de coder).
La structure d'une bonne carte d'analyse
Je pars toujours du même squelette à cinq branches :
flowchart LR
R["Problème à analyser"] --> C["Contexte"]
R --> K["Contraintes"]
R --> O["Options"]
R --> X["Risques"]
R --> D["Décision"]
C --> C1["État actuel"]
C --> C2["Qui est concerné"]
K --> K1["Techniques"]
K --> K2["Délais, droits, coût"]
O --> O1["Option A"]
O --> O2["Option B"]
O --> O3["Ne rien faire"]
X --> X1["Par option"]
D --> D1["Choix et raisons"]
D --> D2["Tâches"]
| Branche | Ce qu'elle contient | Question qu'elle pose |
|---|---|---|
| Contexte | État actuel, volumes, qui utilise quoi | De quoi parle-t-on exactement ? |
| Contraintes | Techniques (limites du service, droits), organisationnelles (délai, budget) | Qu'est-ce qui n'est pas négociable ? |
| Options | Au moins deux solutions, plus « ne rien faire » | Quelles voies existent ? |
| Risques | Par option : ce qui peut casser, comment le détecter | Qu'est-ce qui peut mal tourner ? |
| Décision | Choix, raisons, points ouverts | Qu'est-ce qu'on fait, et pourquoi ? |
Astuce : toujours inclure l'option « ne rien faire ». Elle sert de référence, et il arrive qu'elle gagne.
Dérouler une session
- Vider sa tête : tous les faits, doutes et idées en vrac sous le nœud racine, sans trier.
- Regrouper : déplacer chaque nœud sous l'une des cinq branches. Ce qui ne rentre nulle part est souvent une question ouverte : je le marque d'une icône.
- Vérifier les faits : tout nœud du contexte doit être confirmé (documentation, requête en lecture seule, relecture du code). Je distingue visuellement ce qui est vérifié de ce qui est supposé.
- Comparer les options sous leurs branches : avantages, coûts, risques.
- Décider et écrire la décision dans sa branche, avec les raisons.
De la carte aux tâches
Une analyse qui ne produit pas d'actions est inutile. Sous « Décision », je crée une sous-branche « Tâches » : un nœud par tâche, formulée par un verbe, avec un critère de vérification (« test passé », « vue mise à jour »). Ces nœuds se transforment ensuite en éléments d'une liste de tâches ou de tickets. Freeplane sait aussi exporter la carte en texte indenté, ce qui donne un premier plan à copier.
Les nœuds de la carte peuvent pointer vers le dossier de travail par un lien relatif : la carte devient aussi un index du code concerné.
Et l'IA ?
Un assistant peut aider à remplir les branches (« quels risques pour cette option ? ») ou à relire la carte pour trouver des trous. Mais il propose volontiers des risques génériques ou des fonctionnalités inexistantes : chaque affirmation technique reste à vérifier avant de la garder.
Retour d'expérience
- Ne pas figer trop tôt. Mieux vaut beaucoup de nœuds en vrac qu'un plan prématuré.
- Une carte par sujet. Une carte fourre-tout devient illisible ; je garde les cartes d'analyse séparées de la carte d'inventaire de la plateforme.
- Replier les branches terminées, pour garder la vue sur ce qui reste ouvert.
- Archiver la carte avec la décision. Dans six mois, elle explique pourquoi on a écarté telle option.