édition-de-prose

---

name: édition-de-prose description: Couper et façonner des écrits : documentation, runbooks, README, rapports, invites et instructions pour modèles. À utiliser lors de l'édition ou de la relecture de prose, lorsqu'un brouillon est boursouflé ou hésitant, ou avant de publier un écrit.

Édition de prose

Suppose une vérité de base. Il s'agit des mots et de la forme, pas des faits. NOTES.md à côté de ce fichier contient des exemples concrets.

Le test

Chaque phrase dit au lecteur quoi faire, à quoi s'attendre ou ce qui se passe s'il se trompe ; supprimez celle qui ne fait rien de tout cela. La concision n'est pas la brièveté : ne coupez jamais le fond pour atteindre une longueur, coupez l'échafaudage qui l'entoure.

Coupez

• Les préambules. Mettez le fond dans la première phrase.
• Les redites. Dites-le une fois, au meilleur endroit.
• Les transitions vides (« il est intéressant de noter que », « comme mentionné ci-dessus », « afin de »).
• Les commentaires éditoriaux qui ne changent pas le comportement (« sans glamour mais important »).
• Les quantifications vagues (« une part surprenante »). Donnez la vraie raison pour laquelle cela fonctionne, ou supprimez l'affirmation.
• Les hésitations qui évitent de s'engager. Énoncez clairement l'incertitude réelle, avec les critères de décision.
• Les citations en bloc pour l'emphase. Gardez-les pour les avertissements qui changent ce que quelqu'un fait.

Supprimez ce qui marque le texte comme généré

Un modèle choisit ce qui convient au plus large éventail de lecteurs ; un écrivain choisit pour un lecteur et un sujet. Cherchez d'abord la structure, car les habitudes de mots changent avec chaque modèle. Une phrase ne reste que si elle donne à ce lecteur quelque chose qu'il n'a pas.

• Mise en scène au lieu d'énonciation. « Pas X mais Y » alors que personne n'a dit X, une phrase de conclusion d'un paragraphe qui répète le point, un élan avant le point, un dicton qui semble profond et n'affirme rien. Énoncez le fait.
• Rythme mécanique. Triades et tirets partout, débuts de phrases répétés, qualificatifs empilés. Utilisez trois éléments quand il y en a trois.
• Gonflement. Des faits ordinaires qualifiés de cruciaux ou robustes, langage commercial, autorités non nommées, participes présents sous-entendant un sens. Dites ce qu'il fait, ou supprimez-le.
• Formatage mécanique. Gras sur chaque élément et titre sur chaque pensée, là où l'emphase ou la structure ne signifie rien.
• Résidus de brouillon. Enveloppes de chat, clauses de non-responsabilité sur les limites de connaissance, titre répété comme première phrase, texte sur le document plutôt que sur son sujet.
• Le mauvais lecteur. Réexpliquer ce qu'il sait déjà, de sorte que la décision arrive en dernier.

Gardez ce que l'auteur voulait dire, et n'ajoutez rien pour remplacer ce que vous avez coupé. Un vrai contraste, une vraie liste de trois ou une source citée reste ; un tic ne compte que s'il n'ajoute rien.

Protégé : le pourquoi n'est jamais superflu

Gardez une phrase expliquant pourquoi (cet ordre, cet outil, cette vérification en premier, cette étape ne peut pas être sautée) même si elle ne donne pas d'instruction : la raison permet au lecteur de gérer le cas que le document n'a pas anticipé et de voir quand la procédure ne s'applique plus. Donnez la raison partout où elle n'est pas évidente, surtout pour les règles de sécurité et de conformité, où l'intention est ce qui permet à quelqu'un d'appliquer la règle là où aucune ne couvre le cas. Quand une phrase porte un embellissement et une raison, réécrivez-la pour garder la raison. Le test est « le lecteur serait-il moins bon dans ce domaine sans cela ».

Supprimez la structure non méritée

Ajoutez des niveaux, des tableaux, des matrices, des titres imbriqués ou des branches uniquement là où le travail en a besoin, pas parce qu'ils semblent rigoureux. Demandez : le travail se ramifie-t-il vraiment ici (si chaque lecteur suit le même chemin, c'est une liste) ? Cette étape est-elle nécessaire, ou donne-t-elle seulement l'impression d'être complète ? Si la procédure comporte quatre étapes, écrivez-en quatre : une procédure en quatre étapes suivie dès la première lecture est plus efficace qu'une procédure correcte en neuf étapes qui sera parcourue en diagonale. Les pièges, les séquences à risque et le pourquoi restent.

Instructions chargées par un modèle

Les feuilles de règles, les compétences, les fichiers de rôle et les invites sont payés en jetons à chaque chargement, et le lecteur est un modèle qui a besoin de la règle, pas de son histoire. Tarifez-les en fonction de leur moment de chargement (D28) :

• Chaque session (feuilles de règles, descriptions de compétences et de rôles) : la règle seule. Une description dit ce que la compétence couvre et quand la charger, en moins de 300 caractères ; tools/check.py applique les budgets.
• Sur utilisation (corps d'une compétence ou d'un rôle) : la règle plus une clause de raison. Un seul échec concret uniquement là où la règle semble facultative sans lui, sans dates, comptes ou noms de projet.
• Sur demande (NOTES.md, EVIDENCE*.md) : les incidents, chiffres, dates et sources. Le corps y renvoie.

Écrivez à l'impératif. Ne reformulez pas une règle détenue par un autre fichier chargé ; pointez-la par son nom. Une exigence épinglée dans docs/REQUIREMENTS.tsv se déplace avec sa réécriture, jamais en silence.

Forme d'une procédure

Objectif → Quand l'utiliser → Avant de commencer → Étapes → Vérifier → En cas d'échec → Escalader

• N'omettez jamais Vérifier : c'est la partie la plus souvent sautée et la plus précieuse.
• Une action par étape. Nommez exactement les éléments de l'interface utilisateur. Donnez le chemin complet.
• Signalez les étapes irréversibles avant l'étape, pas après.
• Écrivez pour un étranger compétent : connaît le domaine, n'a jamais vu cet environnement.
• Les titres nomment ce que quelqu'un chercherait. Pas de dates, de versions ou de « v2 ».

Ton

• Langage simple, phrases courtes.
• N'adoucissez pas les contraintes avec des termes à dents (forclusion, résiliation, perte de données, responsabilité personnelle) : dites-le clairement.
• Liez la documentation du fournisseur plutôt que de la recopier, et documentez uniquement ce qui est spécifique à votre façon de travailler : une réimpression est obsolète dès son arrivée.