OthmanAdi/planning-with-files : guide éditorial fondé sur le README
Un guide fondé sur le README, les métadonnées et la licence de OthmanAdi/planning-with-files.
Périmètre du projet
Le README décrit OthmanAdi/planning-with-files comme « Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. ». Cette page reste limitée aux faits vérifiables dans le dépôt. Les étoiles, forks et badges indiquent une attention, pas une preuve de qualité. Sous « README », la source indique : Persistent file-based planning for AI coding agents and long-running agent tasks: the skill keeps taskplan.md , findings.md , and progress.md on disk and re-injects them every turn, so the plan survives context loss, /clear , crashes, and. Cela fixe un périmètre déclaré, pas un test en production.
Cas d'usage adaptés
La section « The Problem » aide à vérifier si le projet répond au besoin : Goal drift: after 50+ tool calls, the original goals get crowded out. Si ce besoin ne correspond pas au vôtre, la popularité ne suffit pas. Les noms, commandes et composants sont conservés pour permettre une comparaison directe avec la source primaire. Le README fournit aussi ce point vérifiable : Volatile memory: the TodoWrite list disappears on context reset. Il peut guider le premier test, sans remplacer une vérification dans l'environnement prévu.
Fonctionnement
Le fonctionnement est réparti dans des sections comme « Before and after /clear ». La source fournit notamment : > you: continue > > agent: I don't have context from an earlier session. Can you describe the task and where you left off?. Les détails absents sur l'architecture, les performances ou la sécurité ne sont pas inventés. Avant une mise en service, vérifiez l'arborescence, la configuration et l'historique des releases.
Installation et premier lancement
Commencez l'installation avec l'entrée documentée dans le README. La commande vérifiable est : your-project/ ├── task_plan.md ← phases + checkboxes; the resume point after /clear ├── findings.md ← research notes and decisions, appended as you go └── progress.md ← session log and test results Si aucune commande n'est fournie, cette page n'en fabrique pas. Consultez « The Problem » pour les dépendances, les ports par défaut et l'initialisation du premier lancement.