LLI Wiki — My Digital Knowledge Base

Écrire une analyse technique avant de coder : options comparées, ADR léger et assistants IA

Énoncé du problème, état actuel, tableau d'options, décision et raisons, points ouverts, et ce que l'IA apporte ou fausse.

Le réflexe de coder tout de suite coûte cher : on découvre la contrainte qui tue la solution après trois jours. J'écris donc une courte note d'analyse avant le code : un fichier Markdown à côté du projet, qui sert de brouillon de réflexion puis de trace de la décision.

Le plan de la note

  1. Énoncé du problème : deux ou trois phrases. Quel est le besoin, pour qui, quel symptôme ou quelle limite l'a déclenché ?
  2. État actuel : comment cela fonctionne aujourd'hui, avec uniquement des faits vérifiés (relecture du code, requête en lecture seule, documentation officielle). Les hypothèses sont marquées comme telles.
  3. Options comparées dans un tableau.
  4. Décision et ses raisons.
  5. Points ouverts : ce qui reste à confirmer, et par qui.

Comparer les options dans un tableau

Un tableau force à utiliser les mêmes critères pour toutes les options :

Critère A : sauvegarde exportée en fichier B : copie géo-répliquée C : ne rien faire
Effort de mise en place Moyen Faible Nul
Coût récurrent Stockage Base secondaire Nul
Délai de restauration Long Court Inchangé
Risque principal Fichier incomplet Bascule mal testée Limite atteinte
Réversible ? Oui Oui Oui

Les options ci-dessus sont un exemple générique. Je garde toujours « ne rien faire » comme référence, et une ligne « réversible ? » : une décision réversible peut être prise plus vite.

Un ADR léger

Un ADR (Architecture Decision Record) est la partie « décision » de la note, réduite à l'essentiel :

## Décision : copier la base par une file de demandes

- Statut : accepté
- Contexte : les copies manuelles sont longues et non tracées.
- Décision : on traite les demandes par une file, avec approbation.
- Raisons : traçabilité, reprise après échec, pas de droits directs.
- Conséquences : un composant à maintenir ; la file doit être surveillée.
- Alternatives écartées : script manuel (non tracé), service tiers (coût).

Le point clé est la section « Raisons ». Dans six mois, personne ne se souviendra pourquoi on a choisi ceci plutôt que cela : le fichier le dit. Si la décision change, on n'efface rien : on ajoute un nouvel ADR qui remplace l'ancien (statut « remplacé »).

Les assistants IA : aide et pièges

Ce qui marche bien :

Là où il trompe :

Retour d'expérience

Mastodon LLIMastodon SocialFosstodon