让 AI 做几分钟的小事不难，难的是让它连续忙很久：对话一清空、进程一崩溃，先前定好的计划就可能不在眼前。planning-with-files 的思路很直接——别只指望 AI“记住”，把任务状态写进工作目录里的 Markdown 文件。Markdown 是一种便于人和机器共同读写的纯文本格式，也能纳入版本控制。
据项目官方 README，它分别用 task_plan.md、findings.md 和 progress.md 保存计划、发现与进度；新会话可以读取这些文件，接着上次的工作继续。失败也要记入计划，关键决策前还要重读计划，相当于给长期任务留下一本可追溯的工作日志。
v3.0.0 还加入了可选的 autonomous 和 gated 模式。其中 completion gate 是“确定性完成门槛”：计划中的可检查条件未满足，就阻止 Agent 宣布结束，而不是让它凭感觉收工。现有安装的默认行为不变。它不保证计划本身一定正确，但能缓解上下文丢失后忘记目标、过早结束这两类常见问题。