LLI Wiki — My Digital Knowledge Base

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

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

  1. Vider sa tête : tous les faits, doutes et idées en vrac sous le nœud racine, sans trier.
  2. 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.
  3. 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é.
  4. Comparer les options sous leurs branches : avantages, coûts, risques.
  5. 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

Mastodon LLIMastodon SocialFosstodon