PR d'agent : cacher le pavé sous details/summary

Ce qui se passe

La plupart des changements que Simon Willison apporte à ses projets arrivent par des pull requests ouvertes pour lui par Claude Code ou Codex. Les agents rédigent de très bonnes descriptions : précises, complètes, elles exposent le problème, la solution détaillée et les étapes de vérification. Le souci est précisément là — c'est trop. Une description écrite par une machine se repère au premier coup d'œil, et la réaction immédiate est « je ne vais pas lire tout ça », quelle que soit son exactitude, même quand c'est soi qui a piloté l'agent.

Ce que ça change

La solution tient dans deux balises HTML, <details> et <summary> : le summary s'affiche comme un titre repliable, et cliquer déplie le reste. Le point clé, c'est que le Markdown de GitHub les reconnaît — collées dans une description de PR ou un commentaire, elles masquent le détail et n'affichent que le résumé avec une flèche.

<details>
  <summary>Claude Opus 5.5 Medium</summary>
  <h2>The hook</h2>
  Plugins implement <code>register_agent_reference_types(datasette)</code>...
</details>

La recette :

1. Un premier paragraphe court, écrit à la main, qui dit à quoi sert la PR et si elle mérite qu'on s'y attarde. Parfois une capture d'écran, souvent le meilleur moyen de montrer une fonctionnalité.
2. Tout l'essai de l'agent replié dans le bloc <details>, dont le summary porte le nom du modèle et son niveau d'effort — « Claude Opus 5.5 Medium », par exemple — pour que le lecteur sache d'emblée ce qu'il regarde.

Le lecteur reçoit le jugement humain en une ligne ; l'information détaillée reste là, disponible pour qui veut. La promesse tient au premier paragraphe : il représente ce qui vaut vraiment le temps du lecteur.

Un moyen de retenir l'ordre des balises

L'ordre se confond facilement. Deux repères : le summary est, littéralement, le résumé des détails — ce qui place <details> en enveloppe de tout le reste. Et surtout, prononcez l'ensemble « details-summary » : deux syllabes suivies de trois, ça roule mieux que l'inverse. Dites-le quelques fois à voix haute, et vous ne vous tromperez plus.

Source : Simon Willison, en anglais.