Des dossiers pour les gouverner tous
claude_notes/
├── current/SHOP-451-fix-cart-total/
│ ├── main.md
│ ├── plan.html
│ ├── investigation.html
│ ├── runbook.html
│ └── pr_description.md
├── todo/
└── done/
Un ticket = un dossier = (une branche)
Le contexte est toujours scopé.
J'écris les instructions dans
main.md, pas dans le prompt.
Le nom du dossier est l'identifiant unique
SHOP-451-fix-cart-total
1 Retrouver le nom du dossier
2 Ouvrir ce dossier
3 Scanner ses fichiers et l'état de la branche associée
On sait toujours où on en est
Un skill pour "reprendre"
Avant
« On reprend la branche SHOP-451-fix-cart-total. Pour rappel, le correctif va dans le service, pas dans le modèle. Et respecte nos conventions de tests. »
Aujourd'hui
/current
Exemple de réponse de /current
Plan 3 / 4 étapes livrées ✅ Normaliser le service ✅ Garde sur le total ✅ Refus de recalcul sur un panier vide ⬜ Rendre l'échec visible ← next app/services/cart_total.rb:170 Fichiers modifiés staging...HEAD, 4 commits app/services/cart_total.rb, test/services/cart_total_test.rb +204 / −16
Où j'en suis, ce qui vient ensuite, et à quelle ligne.
Trois sujets ouverts, trois contextes
SHOP-451-fix-cart-total
je code
lenteur-du-checkout
j'investigue
doublons-de-commande
j'investigue
Un agent par dossier. Aucun ne voit le contexte des autres.
Le nom du dossier est la machine à états
mv todo/SHOP-451-fix-cart-total current/
C'est le système de fichiers qui porte l'état — pas une base de données, pas une application.
Une convention, N outils
claude_notes/current/<branche>/
work
une CLI qui prend le ticket jira et crée le dossier
/current
Claude lit le dossier, et écrit dedans
work-dashboard
un Sinatra local qui lit les tickets Jira et fait toutes les actions sur les dossiers.
/plan
écrit plan.html dans le dossier, que /current relit ensuite
Le système de fichiers est l'interface. Mon ordinateur sait s'en servir.
Une app custom
todo/
SHOP-462
Export CSV des commandes
SHOP-462-export-orders
current/
SHOP-451
Total du panier faux quand une remise expire
SHOP-451-fix-cart-total
done/
SHOP-437
Doublons à la validation du panier
SHOP-437-fix-order-dedup
Une page locale qui ne fait que lire les dossiers. Elle ne stocke rien.
Les LLM ont été entraînés sur des fichiers texte.
Faites-en un avantage.
La présentation
Maxime Souillat