Planning with Files : un plan qui survit à la fenêtre de contexte
Quand la fenêtre de contexte se vide, l'agent oublie à quelle étape il en était. planning-with-files conserve l'état du travail dans trois fichiers du projet : task_plan.md, findings.md et progress.md. Des hooks réinjectent des extraits du plan à chaque tour, si bien qu'après un /clear, un plantage ou une compaction l'agent repart de la phase en cours.
Trois fichiers : task_plan.md avec phases et cases à cocher, findings.md pour les notes de recherche, progress.md pour le journal et les tests.
Des hooks à l'envoi du message, à l'usage des outils, à l'arrêt et avant compaction réinjectent le plan et rappellent de noter l'avancement.
Les tâches parallèles ont leurs propres dossiers .planning/ datés, et .active_plan désigne celui que suit chaque agent.
Règle des deux actions : après deux lectures, recherches ou étapes de navigation, l'agent écrit ce qu'il a appris dans un fichier.
Selon les mesures du projet, le plan sur disque a ramené la réorientation de 13,3 à 5 tours et gagné 3 comparaisons A/B à l'aveugle sur 3.
Quand s’en servir
Une tâche dépasse des dizaines d'appels d'outils et se heurte souvent à /clear ou à la compaction automatique.
Vous reprenez le travail le lendemain et voulez voir d'un coup d'œil quelle phase est terminée.
Plusieurs agents ou worktrees tournent en parallèle et chaque tâche doit garder son propre plan.
Demandez à l’agent
Commence la migration vers l'API v2 en écrivant un plan par phases dans task_plan.md
Lis task_plan.md et progress.md, puis reprends à la phase en cours
Note dans findings.md ce qu'on a trouvé sur l'erreur de connexion
Questions
Comment installer planning-with-files ?
La commande npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g l'installe globalement. Dans Claude Code, il existe aussi en plugin avec ses hooks.
Existe-t-il une version française de planning-with-files ?
Non. En plus de l'original anglais, le dépôt propose l'arabe, l'allemand, l'espagnol et deux variantes du chinois.
Mes plans sont-ils envoyés quelque part ?
Non. Le skill n'a aucun chemin d'envoi réseau, et les fichiers de planification restent en Markdown dans votre projet, ignorés par git par défaut.
