Quand la documentation devient la première pierre d'un système : retour sur la redécouverte de 104 projets d'automatisation dormants et pourquoi aucun agent IA ne doit coder avant d'avoir cartographié l'existant.
1. LE SYNDROME DE LA PAGE BLANCHE ET L'AMNÉSIE PATRIMONIALE
Dans la grande majorité des chantiers de transformation numérique, le premier réflexe de l'ingénieur ou du consultant est presque toujours le même : ouvrir un éditeur de texte, créer un dépôt vide, et déclarer avec enthousiasme :
— « On repart de zéro. On va tout reconstruire proprement en utilisant les dernières technologies d'IA. »
Cette pulsion de la feuille blanche est une illusion destructrice. Dans n'importe quelle organisation ayant plus de quelques mois d'existence, le néant n'existe pas. Il existe en revanche un patrimoine invisible : des dizaines de scripts artisanaux, de macros discrètes et d'automatisations conçues dans l'urgence qui font tourner silencieusement le quotidien.
Le 20 septembre, en lançant un audit d'inventaire sur notre infrastructure Google Cloud et Workspace, nous sommes tombés sur un trésor enfoui sous la poussière : 104 projets Google Apps Script actifs et oubliés.
Des connecteurs de facturation, des trieurs d'emails juridiques, des synchroniseurs d'agendas, des passerelles Sheets vers Drive : tout un écosystème automatisé conçu au fil des années, fonctionnel mais totalement dépourvu de cartographie globale.
Vouloir brancher des agents d'intelligence artificielle sur un tel environnement sans état des lieux préalable aurait relevé du suicide opérationnel.
Lancer un agent de code sans inventaire préalable aboutit inévitablement à recréer en doublon ce qui existe déjà, ou pire, à écraser des déclencheurs critiques dont personne ne se souvenait mais dont dépend la paie ou la facturation.
2. LA DOCTRINE DE « LA MATRICE D'ABORD »
Face à ce constat, nous avons gravé un commandement strict : pas une seule ligne de code, pas un seul nouveau script avant que la matrice documentaire ne soit rédigée, validée et versionnée.
Qu'est-ce que « la matrice » ? C'est le contrat fondateur entre l'humain et les agents :
- Un tableau exhaustif de chaque composant existant avec son propriétaire, sa criticité, ses dépendances et son niveau de maintenance.
- Une arborescence logique qui définit la cible avant d'entamer le moindre chantier.
- Un sitemap et un contrat d'interfaces clair.
LA PYRAMIDE DE L'ARCHÉOLOGIE LOGICIELLE
───────────────────────────────────────
┌──────────────────┐
│ CODE & AGENTS │ (Étape 3 : Exécution ciblée)
└────────┬─────────┘
│
┌────────────┴────────────┐
│ MATRICE DOCUMENTAIRE │ (Étape 2 : Contrat sémantique)
└────────────┬────────────┘
│
┌─────────────────┴─────────────────┐
│ INVENTAIRE EXHAUSTIF DU PATRIMOINE│ (Étape 1 : 104 Apps Scripts)
└───────────────────────────────────┘Pourquoi cette discipline change-t-elle radicalement l'efficacité de l'IA ?
- Un assistant IA sans cadrage produit du plausible, pas du juste : Donnez-lui une matrice stricte, il produira du conforme.
- La vitesse de relecture : Une matrice documentaire se valide en 15 minutes par un architecte humain. Corriger 5 000 lignes de code générées de travers demande trois jours d'efforts ingrats.
- Le coût de l'erreur : Une incohérence corrigée dans la matrice coûte une seconde de frappe. La même incohérence découverte en production paralyse un service.
3. L'ARCHÉOLOGIE LOGICIELLE : NOUVELLE DISCIPLINE DE L'ÈRE AGENTIQUE
Pour analyser ces 104 projets sans y passer six mois, nous avons mandaté nos agents sur une mission d'archéologie logicielle assistée :
- Extraction des manifestes : Téléchargement automatisé des fichiers
appsscript.jsonpour recenser les scopes d'autorisation OAuth utilisés. - Cartographie des dépendances : Détection des déclencheurs temporels (Triggers) et des Webhooks externes.
- Classification par état : Tri entre les projets morts (à archiver proprement), les projets stables (à sanctuariser), et les composants pivots (à migrer vers nos serveurs MCP).
- Scellement dans Google Sheets : Centralisation de la matrice avec identifiants uniques pérennes.
Cette fouille a permis de découvrir que sur les 104 projets, 42 étaient des doublons historiques abandonnés, 38 assuraient des tâches d'arrière-plan toujours vitales, et 24 méritaient d'être promus au rang d'outils souverains connectés à notre copilote J.A.R.V.I.S.
4. LE GUIDE DE CONFIGURATION : RENDRE L'IA REPRODUCTIBLE
Une fois la matrice dressée, le deuxième document fondamental concerne le guide de configuration de l'assistant (System Prompt & Règles d'atelier).
La plupart des utilisateurs d'IA réécrivent leurs invites à chaque session, dans la précipitation, et s'étonnent d'obtenir des résultats erratiques. Un guide de configuration versionné dans Git est l'assurance que n'importe quel membre de l'équipe — ou un autre modèle d'IA dans six mois — obtiendra exactement le même comportement déterministe.
Une bonne documentation moderne doit être bilingue : limpide pour un décideur humain qui n'est pas informaticien, et suffisamment structurée (schémas ASCII, listes délimitées, contrats d'erreur) pour être parsée sans ambiguïté par un modèle de langage.
5. CE QU'IL FAUT RETENIR POUR VOS PROJETS
- Ne partez jamais d'une feuille blanche sans fouille préalable : Votre organisation possède déjà du code et des processus. Trouvez-les avant d'en créer de nouveaux.
- La matrice est votre boussole : Si vous ne pouvez pas résumer l'ensemble de vos briques logicielles dans un tableau d'une page, vos agents d'IA ne feront qu'amplifier la confusion.
- Le temps passé à documenter est multiplié par dix à l'exécution : Chaque heure investie dans la clarté du contrat documentaire épargne des dizaines d'heures de débogage et des centaines d'euros de cycles de calcul inutiles.