planning-with-files
面向使用 Claude Code 等代理的开发者，用文件化计划与进度记录来完成可恢复的长任务执行与代码/研究产出。
工具简介
采用判断：可以关注并试用，但更适合把它当成“代理工作流技巧”而不是成熟基础设施。热度证明很强：GitHub 仓库有高星增长，知乎与 X 也有传播；但这些更多说明它被广泛讨论，不等于已经在生产环境稳定验证。好用证明主要来自官方仓库说明、源码拆解文和少量实测教程，样本仍有限，因此更适合先在个人或小团队流程中验证。
实际作用：它通过 PLAN.md、DISCOVERY.md、PROGRESS.md 这类文件，把代理的计划、发现与进度持久化到仓库中，让 Claude Code 一类 AI 编码代理在会话中断、/clear 或长链路任务中重新读取状态，减少重复试错。更准确的类比是“给代理加一层文件化记忆与执行规约”，不是完整的自动化平台，也不是通用向量数据库、RAG 系统或独立多代理框架。
门槛与成本：项目本身是官方仓库可见的开源代码，获取与使用按仓库层面可视为免费；但它不会替你承担模型调用费用，实际 API 成本仍取决于你接入的 Claude Code/底层模型，这是保守判断，不是官方价格承诺。上手门槛主要在于要理解其规则、文件结构和触发方式，且目前证据里未见图形化产品化能力，较适合能改 prompt、会看文档、愿意维护工作流的开发者。
适合/不适合与讨论质量：适合多步骤编码、重构、技术预研、跨会话代理协作；不太适合一次性短问答、纯非技术用户，或期待“装上就全自动完成项目”的人。证据源讨论质量中等偏上：官方仓库可支持功能边界判断；知乎里既有 lwl2046 这类源码级拆解、也有实测与配置教程，属于较好的好用证明；但也混有“Manus 同款”“20 亿美元”等标题化传播和榜单式热帖，这些更偏热度证明。整体共识是思路有启发、易复现，但是否显著提效仍依赖任务复杂度与使用纪律。