Bonnes pratiques CLAUDE.md : Sirène pour les flux de travail

Mon image vaut mille mots. Je voulais voir mon système.

Pas le code. Je voulais voir les flux de travail. Que se passe-t-il lorsqu'une règle est validée. Que se passe-t-il lorsqu'une session démarre. Que se passe-t-il lorsque le compactage se déclenche ? Les systèmes sont des flux de travail et je ne pouvais pas voir le mien.

Je les ai fait écrire, bien sûr. Prosez des paragraphes dans CLAUDE.md/SKILL.md ou RULES décrivant chaque processus étape par étape. Mais au-delà de quatre ou cinq étapes avec ramifications, la prose devenait illisible. Je l'écrirais, je reviendrais une semaine plus tard et j'aurais besoin de réanalyser le tout pour comprendre ce que j'avais écrit. Surcharge mentale, à chaque fois.

Mon agent de codage a eu le même problème. La recherche appelle cela « perdu au milieu » : les LLM fonctionnent mieux avec les informations au début et à la fin de leur contexte, et bien moins bien avec les informations enfouies au milieu. Mes flux de travail en prose étaient exactement cela : une logique de branchement critique enfouie dans des paragraphes, prise en sandwich entre d'autres instructions. Claude manquerait des marches. Sautez les branches. S'éloigner du processus prévu.

Et les flux de travail eux-mêmes ont également dérivé. Je supprimerais une phase de pipeline et mettrais à jour un paragraphe, mais j'en manquerais un autre. La prose rend ce...
[Courte citation de 8% de l'article original]