plannotator place un point de contrôle humain devant chaque diff d'agent

Il y a un moment précis, dans le développement assisté par agent, où les choses empirent au lieu de s'améliorer. L'agent termine une tâche, imprime un résumé et vous demande de valider. Vous faites défiler. Le diff fait quatre cents lignes. Vous validez, parce que le lire correctement prendrait plus de temps que l'écrire vous-même.
plannotator, un projet à environ 10 500 étoiles qui grimpe vite cette semaine, est une tentative pour corriger ce moment. C'est une surface de revue locale, dans le navigateur, qui se branche sur un agent de code et s'ouvre quand l'agent a quelque chose à faire trancher. Vous annotez le plan, le document ou le diff, et vos commentaires repartent vers l'agent comme entrée suivante.
Le slogan parle de rester dans la boucle. L'architecture traite de quelque chose de plus étroit et de plus utile : faire de l'attention humaine une étape à part entière, au lieu d'une option.
Comment il se branche
Il ne remplace pas votre agent. Il se branche sur l'un d'eux. Le README liste Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness et Pi, et l'Inbox fonctionne aussi avec des assistants personnels comme Grok Bot, Muse, Hermes et OpenClaw. La connexion passe par les plugins, les hooks et les commandes de chaque harness, ce qui explique que la profondeur d'intégration varie d'un outil à l'autre.
Les commandes ont la forme habituelle :
/plannotator-review # uncommitted changes
/plannotator-review <github-pr-url> # a pull request
/plannotator-annotate README.md # a file
/plannotator-annotate https://docs.rs # a URL
/plannotator-last # the agent's last message
plannotator inbox # the queue
Sur Codex, les commandes slash deviennent `!plannotator ...` ou les skills packagés. Le mode plan ne demande aucune commande : il est câblé dans les hooks de chaque harness, donc quand l'agent écrit un plan, la surface de revue s'ouvre toute seule. Ce détail compte plus qu'il n'y paraît. Un point de contrôle qu'il faut penser à invoquer est un point de contrôle qu'on saute les jours chargés, et ces jours-là sont justement ceux où il compte.
La revue couvre Git, GitButler, Jujutsu, Perforce, GitHub et GitLab, donc la surface n'est pas liée à un forge unique. Vous commentez des lignes, proposez du code, et les commentaires repartent vers l'agent plutôt que dans un fil de PR que personne ne lit.
La boîte de réception est la partie intéressante
La revue à un seul agent est un problème résolu, avec une solution ennuyeuse : ouvrir un diff, laisser des commentaires.
L'Inbox est ce que l'équipe a construit pour la situation où se trouvent la plupart des gens, c'est-à-dire plusieurs agents qui tournent en même temps. C'est une fenêtre locale où les agents déposent messages, questions, fichiers et revues guidées pendant qu'ils continuent de travailler. Vous répondez à une question d'un clic, vous annotez un fichier, vous appuyez sur envoyer quand vous y arrivez. Rien ne garde une session d'agent ouverte pendant ce temps, et votre réponse retourne à la session qui a posé la question.
Cette phrase règle un vrai blocage. Le schéma standard du human-in-the-loop, c'est l'agent qui s'arrête et attend. Avec un agent, ça va. Avec quatre, vous devenez le processus le plus lent du système, et trois d'entre eux brûlent du contexte pendant que vous finissez de déjeuner. Une boîte de réception asynchrone permet à l'agent de mettre la question en attente, au lieu de la session.
Claude Code, Pi et OpenCode se connectent par plugins, donc les réponses arrivent au tour suivant. Le reste passe par MCP avec `plannotator inbox mcp`, et `plannotator inbox --help` sert aussi de document que l'agent lit pour apprendre le protocole. C'est un petit détail de conception avec un gros effet : le texte d'aide est la spec d'intégration.
Pourquoi un navigateur, et pourquoi en local
Un diff dans le terminal convient pour lire du code et pas pour lire autre chose. Relire une spec produit, une maquette HTML ou un rapport rendu dans un pager, c'est un exercice de plissement d'yeux, et les agents produisent maintenant ces trois choses régulièrement. Les rendre dans un navigateur et laisser le relecteur poser des épingles sur le rendu, voilà la surface correcte pour ce type d'artefact.

La section sur la vie privée du README est étonnamment précise pour un outil de cette taille, et mérite d'être citée sur le fond plutôt que résumée. Pas de télémétrie. Plans, diffs, annotations, brouillons et historique restent en local par défaut. Chaque surface interroge GitHub pour la dernière version au chargement, et cette vérification ne se désactive pas. La revue Git locale peut lancer `git ls-remote` vers votre origin configurée pour détecter la branche par défaut et une base obsolète, et cette requête part à l'ouverture de la revue, au chargement du diff, au changement de base et quand vous appuyez sur fetch. Une page de revue inactive ne fait aucun appel réseau, ce qui est une promesse plus forte que celle de la plupart des outils.
Le contenu ne quitte la machine que quand une fonction réseau en a besoin : l'annotation d'URL récupère la page, la revue GitHub passe par votre CLI authentifiée, Ask AI envoie la question sélectionnée et son contexte au fournisseur que vous avez configuré, et le partage téléverse du chiffré vers un service de paste.
Pour un outil posé au-dessus du code source, ce niveau de transparence est le bon réflexe. Le mode de défaillance typique de l'outillage pour agents, c'est l'assistant serviable qui envoie votre dépôt à un serveur sans le dire, et la seule défense de l'utilisateur est un mainteneur qui documente les frontières avant qu'on les lui demande.
La conséquence gênante
Tout, dans ce projet, est un pari : la contrainte sur le travail des agents est la bande passante de revue humaine, pas la capacité du modèle.
Le pari me semble juste. Les gens que je connais qui font tourner plusieurs agents passent leur journée à lire : des plans, des diffs, des sorties de tests, des résumés de ce que l'agent croit avoir fait. La partie génération est rapide et le devient davantage. La partie vérification est bornée par la vitesse à laquelle une personne lit et décide.
Il y a un effet de second ordre qu'il vaut la peine de nommer. Une surface de revue qui capture les décisions crée un registre de ces décisions. plannotator a une commande archive qui parcourt en lecture seule les décisions de plans enregistrées, et les annotations persistent dans le répertoire de données, donc les revues en terminal et les revues dans l'app s'accumulent au même endroit. Une fois que vous avez quelques centaines de plans approuvés avec les commentaires qui les ont façonnés, vous possédez quelque chose qu'aucune session individuelle ne contient : une description de la façon dont votre équipe décide.
C'est ça, l'actif. Le visualiseur de diff, n'importe qui peut le construire. La trace du raisonnement, non.
Là où ça fait encore mal
Deux choses, toutes deux inhérentes.
La première, c'est qu'un outil de revue améliore la revue, et que la revue n'est pas la justesse. Une approbation bien annotée d'une mauvaise architecture reste l'approbation d'une mauvaise architecture, et une surface de revue bien tenue donne l'impression que valider est un travail sérieux. L'Inbox en particulier rend facile de vider une file, et vider une file est un comportement différent de la comprendre.
La seconde, c'est que l'outil ajoute un navigateur, un serveur local et une couche de hooks à un flux de travail qui était un terminal. Cela fait trois choses de plus qui peuvent casser, et l'échec d'un hook est silencieux : l'agent avance sans le point de contrôle, et vous l'apprenez plus tard.
Les deux sont des coûts acceptables pour ce qui est acheté, à savoir un endroit où se tenir pour l'humain. L'alternative, celle que font la plupart des équipes aujourd'hui, c'est de lire une transcription de chat et d'espérer que l'important s'y trouve.
Si vous ne testez qu'une chose
Lancez `/plannotator-review` sur votre prochaine modification non commitée et commentez trois lignes, même si vous n'avez rien à dire. Les commentaires sont accessoires. Ce que vous apprenez, c'est combien de temps prend une vraie revue quand la surface est conçue pour ça, et ce chiffre devient votre nouveau plafond de débit. La plupart des équipes ne l'ont jamais mesuré.
Articles associés
La règle ne vise pas les puces, elle vise l'accès à distance
Washington ne contrôle plus seulement la puce qui traverse une frontière, mais le calcul qui la traverse. Cinq pays, une licence, et un flou qui coûte cher aux néoclouds.
Trois documents en neuf jours, et un comité qui compte
En neuf jours, le conseil de Nvidia a publié une enquête, créé une présidence et monté un comité export. Ce dernier est le seul qui change vraiment la machine.
AMD a pris 18,93 % pour une raison qui ne parle pas d'AMD
AMD a gagné 18,93 % pendant que Nvidia perdait 12,75 %. Le marché n'a pas choisi un gagnant : il a fui un nom. La différence compte pour les deux prochaines années.
Ce que Colette Kress doit dire en trois phrases
Nvidia publie son premier trimestre sans Huang. Derrière des chiffres attendus, une seule question : la nouvelle patronne peut-elle encore vendre la visibilité du groupe ?