Module 1 · Charge cognitive

Économiser l'attention

Avec des agents, le code ne manque plus. Ce qui manque, c'est l'attention de ceux qui relisent et décident, et un message mal écrit, une alerte inutile ou une décision posée en vrac en consomment une part. Ce qui sort de la machine doit donc se lire au moindre coût, et ce qui reste à faire doit être écrit ailleurs que dans une tête.

Les principes, sans le détail technique. Le mode initié montre comment on les applique chez Wavo. Avec les encadrés « Chez Wavo » : nos outils, nos réglages, et comment on mène ces chantiers dans Odette.

Attention is all you need

En 2017, une équipe de chercheurs de Google publie « Attention Is All You Need ». L'article introduit le Transformer, l'architecture sur laquelle reposent les grands modèles de langage. Tout part de là : pour la machine, l'essentiel est de savoir où porter son attention.

L'humain n'y échappe pas. Travailler avec des agents demande une attention bien placée :

Sans elle, l'agent devient une extension de soi qu'on ne maîtrise plus et qui ne suit plus nos intentions : c'est de là que viennent le désarroi et le syndrome de l'imposteur. Avec elle, l'IA prolonge l'humain. Ce module traite de cette attention et de la façon de la préserver.

Avant les outils : nos réactions

L'IA nous submerge de nouveautés, souvent plus vite qu'on ne peut les absorber. Ce flot provoque des réactions fortes, qui pèsent sur l'attention avant même qu'on ouvre un outil :

La réponse consiste à replacer l'humain dans la boucle, à une place qu'il choisit : l'agent explore, rédige et vérifie, l'humain cadre, tranche et relit. C'est la place la plus stimulante, et celle où il crée le plus de valeur. Vue ainsi, l'IA redevient un outil au service de l'humain, une extension de lui-même.

Chez Wavo · un exemple, pas une recommandation

Chez nous, l'agent prépare et l'humain décide, en 4 étapes :

  1. L'agent prépare. Il explore, rédige et vérifie : le diagnostic, le plan, le code.
  2. L'humain tranche dans un formulaire. Quand un choix lui revient, l'agent ne le noie pas dans un message : il pose la question avec 2 à 4 options, la conséquence de chacune et sa recommandation en premier. On répond d'un clic au lieu de rédiger (voir « Décider », plus bas).
  3. L'humain relit la PR. Aucune modification n'est mergée sans qu'un humain l'ait relue.
  4. L'équipe partage ce qu'elle essaie dans un canal d'atelier : un outil, un réglage, un échec. Ce qui marche chez l'un se diffuse aux autres.
Étape 1 : l'agent explore, rédige et vérifie. Étape 2 : il pose un formulaire avec 2 à 4 options et sa recommandation, et l'humain tranche d'un clic. Étape 3 : l'agent ouvre la PR, qu'un humain relit avant le merge. Étape 4 : l'équipe partage dans un canal d'atelier ce qu'elle a essayé.
Chez Wavo. Violet : les gestes humains.

La santé mentale, de front

Le sujet dépasse l'ergonomie. On voit en ce moment des burn-out dans les équipes tech, et l'IA peut les aggraver autant que les prévenir. Il y a 3 risques, à traiter ensemble :

Aucun réglage isolé n'y suffit : la réponse passe autant par l'outillage que par l'organisation et la culture.

Le goulot s'est déplacé

Un agent rédige une PR, un diagnostic ou un plan en quelques minutes. Un humain met plus longtemps à le lire qu'il n'en a fallu pour le produire. La capacité d'attention est fixe ; ce qu'on peut changer, c'est ce qui la consomme. La psychologie cognitive distingue 3 types de charge :

Deux barres de même longueur, chacune égale à toute l'attention disponible. Avant : le sujet, une grande part prise par la forme (transcripts, doublons, questions noyées, relances), et presque rien pour décider. Après : le sujet garde la même part, la forme se réduit, et la place libérée revient à comprendre et décider.
Un schéma, pas une mesure. On ne réduit pas la difficulté du sujet ; on retire ce que la forme ajoute.

La suite passe en revue les endroits où la charge extrinsèque s'accumule le plus vite quand on travaille avec des agents.

Tracer tout ce qui reste à faire

Une action qui n'est écrite nulle part occupe une place dans la tête de quelqu'un, jusqu'à ce qu'elle soit faite ou oubliée. Avec plusieurs agents qui avancent en même temps, ces restes se multiplient : un script à lancer après le merge, un cas limite repoussé, une question laissée en suspens dans une PR. D'où la règle : chaque action restante est un objet tracé dans un outil de gestion des tâches branché sur le développement, pas une note mentale.

Une feature Odette dont le plan validé est découpé en tâches A et B. Chaque tâche est démarrée dans son propre espace Superset, avec sa branche et un agent amorcé par la tâche. En cours d'implémentation, la tâche B révèle un second sujet : il devient une tâche sœur C, sous la même feature, avec son propre espace.
Chez Wavo. Le découpage part du plan ; une inconnue découverte en route devient une tâche sœur.
ÉtapeStatut
Découper le plan d'une feature en tâches cohérentesen place
Démarrer une tâche : branche liée et espace de travail amorcéen place
Voir toutes les sessions parallèles au même endroiten place
Créer une tâche sœur quand un sujet apparaît en cours de routeen place
Poster la checklist post-déploiement dans le fil de la PRen place
Rappeler chaque étape de la checklist, à cadence fixe ou à dateen place
Fermer une étape depuis la session qui l'a exécutéeen cours
Chez Wavo · un exemple, pas une recommandation

Les features, plans et tâches vivent dans Odette, notre outil de pilotage interne. Le skill odette-split-plan découpe le dernier plan d'une feature en tâches ; odette-start-task crée la tâche sous sa feature, crée et lie sa branche GitHub, puis ouvre un workspace Superset sur cette branche avec un agent amorcé par la description de la tâche. Superset affiche tous les workspaces en cours, ce qui donne la vue d'ensemble de ce qui tourne en parallèle. Un sujet découvert en route passe par le même skill : la tâche sœur est créée sous la même feature et part dans son propre workspace.

Du contenu qui se lit en une fois

Chez Wavo · un exemple, pas une recommandation

Les instructions communes demandent des réponses courtes, sans préambule. Un skill vulgarisation réécrit un incident pour un lecteur non technique : verdict, cause racine traduite en gestes et en données, chiffres tracés, demande précise à la fin. Les analyses plus longues, comme ce dossier, sont publiées en pages plutôt que collées dans Slack.

Dire l'intention sans friction

La charge vaut aussi dans l'autre sens : formuler une idée coûte, et chaque frottement entre l'idée et l'agent en fait perdre une partie. Autant rendre l'expression aussi naturelle que possible.

Chez Wavo · un exemple, pas une recommandation

On parle à Claude Code en français, à la voix : la dictée est réglée en mode hold, on parle en gardant la barre d'espace enfoncée. Ce qui arrive est plein de « euh » et de phrases reprises en cours de route ; l'agent en retire les tics et garde l'intention. Le réglage "language": "French" le fait répondre en français, tandis que le code et les commits restent en anglais. Plusieurs sections de ce dossier sont nées ainsi.

Un graphique quand il remplace un paragraphe

Un schéma vaut le coup quand il montre un mécanisme que la prose oblige à reconstruire de tête : un flux, une frontière de confiance, une séquence d'états. Sinon, il ajoute de la charge au lieu d'en retirer.

Chez Wavo · un exemple, pas une recommandation

Les schémas de ce dossier sont écrits en D2, mis en page par le moteur TALA sur une grille d'une rangée, avec les vrais logos des outils. Un skill du dépôt porte la méthode, et ses premiers essais ratés (flux à l'envers, flèches qui traversent le titre avec d'autres moteurs) l'ont façonnée.

En phase de plan, le skill de plan dessine un schéma d'architecture seulement si le plan ajoute ou déplace un composant, un appel entre composants ou une frontière de compte. Sinon, une ligne sous le titre dit qu'il n'y en a pas : le lecteur sait que l'absence est voulue.

Des notifications qui méritent d'être lues

Une notification interrompt. Elle n'a le droit d'exister que si quelqu'un doit agir ou savoir, et elle doit coûter le moins possible à traiter. La base est connue : les bots postent, les humains répondent en fil. Reste la forme de la notification elle-même :

Une exécution de pipeline échoue sur AWS et poste un seul message Slack, qui porte l'alerte, son état et le seul bouton Redrive. Le clic pose un sablier et lance un redrive sur AWS. En cas de succès, le message de tête passe du sablier à la coche ; en cas d'échec, une réponse sans bouton arrive dans le fil et le bouton reste sur le message de tête.
Chez Wavo. Le message de tête porte l'état, le fil porte l'historique.
Chez Wavo · un exemple, pas une recommandation

Les alertes de la data platform suivent ce cycle : un sablier posé sur l'alerte dès le clic sur Redrive, remplacé par une coche quand l'exécution reprise réussit, pas quand elle démarre ; en prod, ce succès ferme aussi les issues Sentry que l'exécution avait levées ; un redrive qui échoue répond dans le fil de l'alerte d'origine, sans bouton, et le bouton reste sur le message de tête. Les anomalies de ventes, qui concernent un client, ont quitté Slack pour être levées dans l'application.

Chaque jour ouvré à 9 h 30, un workflow planifié envoie à chaque relecteur un message privé qui nomme la PR à relire en premier. Le classement place d'abord ce qui bloque (le correctif d'une alerte de production, une PR sur laquelle une autre est empilée), puis la priorité de la tâche liée, puis une relecture demandée nommément, puis l'ancienneté. Un modèle rédige le résumé, et le niveau de risque vient de règles fixes sur les chemins et la taille. Deux relecteurs peuvent recevoir la même PR le même jour : rien ne dédoublonne encore.

Ce qu'on a suppriméUn récapitulatif quotidien des ventes au-dessus de la médiane. Personne n'avait rien à faire d'une bonne nouvelle, et il postait, en production, dans un canal de test. Plutôt que de le migrer, on l'a supprimé.

Décider : l'agent interviewe, un formulaire tranche

La pire forme d'une décision, c'est une liste de points « en attente de ta décision » à la fin d'une longue réponse : elle ne se distingue pas du reste, elle oblige à rédiger une réponse, et elle se perd. Il vaut mieux faire l'inverse : l'agent prépare la décision, l'humain la prend d'un clic, dans un formulaire.

  1. Les enjeux. Ce que la décision engage : coût, risque, réversibilité, qui la subit. Une décision réversible et peu coûteuse ne mérite pas d'entretien.
  2. Les options. Une par alternative réelle, de 2 à 4. « Ne rien faire » en fait souvent partie.
  3. Avantages et inconvénients, écrits comme des conséquences concrètes : ce qui se passe si on choisit cette option, pas une qualité abstraite.
  4. Une recommandation, placée en premier et marquée. Répondre doit pouvoir se réduire à valider.
  5. La trace. La décision et son pourquoi sont écrits là où le sujet vit : la tâche, le fil, la PR (module 2).

Quand la décision demande d'abord de cerner le sujet, l'agent mène un entretien plutôt qu'un questionnaire :

Chez Wavo · un exemple, pas une recommandation

Une règle des instructions globales : toute décision qui revient à l'humain passe par AskUserQuestion, le formulaire de Claude Code, avec une option par alternative réelle, sa conséquence dans la description, la recommandation en premier, et jusqu'à 4 questions dans le même appel. Dès qu'une réponse contiendrait « dis-moi » ou « tu préfères », c'est un formulaire. Pour spécifier une feature, le skill prd-interview applique l'entretien : une question par tour, une réponse par défaut, 12 questions au plus, puis le document est rédigé et poussé sur Odette.

Le tour de table

Les agents tiennent désormais des tâches longues seuls. On en mène parfois plus d'une dizaine en même temps, chacune avec sa PR. L'humain ne pilote plus chaque session : il fait le tour de table, et ce sont les sessions qui l'interviewent, l'une après l'autre, quand elles ont besoin de lui.

Trois sessions Claude dans Superset. La session A avance seule jusqu'à la PR. La session B s'arrête sur une décision produit ou un risque et envoie une notification ; l'humain arrive, lit le récap d'avancement, tranche dans un formulaire, et la session repart. La session C, en pointillés, s'arrête alors que la PR pouvait partir : c'est l'arrêt qu'on cherche à supprimer.
Chez Wavo. Violet : la décision qui fait repartir la session. Pointillés : l'arrêt qu'on cherche à supprimer.
Chez Wavo · un exemple, pas une recommandation

Chaque tâche tourne dans son workspace Superset, et la liste des workspaces sert de table. Les instructions laissent à l'agent les commits, les tests et les relances, et ne remontent à l'humain que les choix qui lui reviennent, par AskUserQuestion. Le hook Stop qui juge la ligne Goal: renvoie au travail une session qui s'arrête avant l'objectif. Une tâche annexe qui peut attendre est créée dans Odette sans être démarrée : elle reste au backlog, sans workspace ni session.

Ce qui frottaitDes sessions finissaient l'implémentation, puis s'arrêtaient pour demander s'il fallait ouvrir la PR. La consigne est désormais écrite : développement terminé, la procédure de PR part sans attendre. Seul le texte de la PR est relu avant sa création.

À reprendre

  1. Replacez l'humain dans la boucle, à la place où il tranche : l'IA est une extension de lui, pas un remplaçant.
  2. Traitez la santé mentale de front : limiter ce qui tourne, garder la réflexion, des temps sans agent, et en parler.
  3. Ne réduisez pas la difficulté du sujet, retirez ce que la forme ajoute.
  4. Toute action restante est une tâche tracée ; une feature se découpe en tâches scopées, et un sujet découvert en route devient une tâche sœur plutôt que de gonfler la tâche.
  5. Une tâche, une branche, un espace, un déploiement, et une vue d'ensemble de ce qui tourne en parallèle.
  6. Le verdict en première ligne, le détail ensuite, la page quand c'est long.
  7. Parlez à l'agent dans votre langue et à la voix, il garde l'intention et retire le reste.
  8. Un graphique seulement s'il remplace un paragraphe, et jamais sur des chiffres inventés.
  9. Une notification actionnable, qui change d'état au lieu de se multiplier.
  10. Les décisions par formulaire, la recommandation en premier, la trace écrite.
  11. Faites le tour de table : des sessions longues, des arrêts rares, un récap et un formulaire à chaque passage.
  12. Plafonnez les tâches en parallèle ; ce qui peut attendre va au backlog.