Spécifier pour des agents (et pour les humains, en fait)

Le grand renversement

Quand coder coûtait cher, on économisait sur la spec (« on verra en développant »). Quand coder devient rapide et délégable, la spec devient le goulot ET le levier : un agent exécute exactement ce qui est écrit — l'ambiguïté ne se résout plus à la machine à café. La bonne nouvelle : tout ce qui rend une spec bonne pour un agent la rend bonne pour un humain. Les agents n'ont pas inventé le besoin ; ils ont rendu son absence immédiatement douloureuse.

L'anatomie observée d'un ticket bien formé

Le flux de spécification du projet étudié (celui qui produit 60 tickets en dix jours proprement) :

• la spec produit (Notion) : le comportement attendu, les états, les cas limites, avec maquettes (prototypes HTML générés par IA — la maquette aussi s'est agentifiée) ;
• les règles de gestion numérotées (RG_09, RG_16…) : chaque règle a un identifiant — les tickets, les tests et les MRs les citent. La traçabilité spec ↔ code ↔ test par référence ;
• le découpage back/front explicite : « Compte Back — résolution enrichie + statut gradué », « Compte Front — side-panel comparaison » — chaque ticket est autoporteur, avec ses critères ;
• les tickets de recette : les retours de tests manuels deviennent des tickets aussi précis que les specs (« la saisie PRIX CUSTOM pollue PU HT et n'initialise pas la QTÉ ») — reproductibles, donc délégables.

Les ADRs, pour les agents aussi

Le cours « Stack IA » a montré les ADRs comme mémoire d'équipe. Nouveau rôle avec les agents : l'ADR est le contexte que l'agent charge pour comprendre pourquoi l'architecture est ce qu'elle est — et la commande /new-adr du projet rend leur écriture aussi rituelle qu'un commit. Une décision non écrite n'existe pas… surtout pour un équipier qui redémarre amnésique à chaque session.

La compétence d'équipe qui monte : le tri

Face à chaque tâche, trois questions : est-elle spécifiable (critères vérifiables) ? bornée (périmètre clair) ? vérifiable en aval (tests, revue) ? Trois oui = délégable à un agent (voire au job CI). Un non = du travail humain de spec AVANT d'être du travail de code. Les meilleures équipes agentifiées ne sont pas celles qui délèguent tout — ce sont celles qui trient vite et bien.