文件式任务规划

要解决的具体问题

AI编程助手最大的痛点是每次新会话都要重新交代项目背景。你花15分钟解释需求、描述架构、指定约束，然后会话结束——下次开始，一切归零。更糟糕的是，那些散落在聊天中的决策和约束，随着会话被压缩或遗忘，最终只剩下模糊的回忆。

Plan With Files用最朴素却最有效的方式解决了这个问题：把计划写成Markdown文件，存放在项目目录中。

核心能力与工作方式

持久化规划文件：主计划文件.planning/plan.md，子任务模板.planning/tasks/2.3-token-blacklist.md。WorkBuddy启动时自动读取规划文件，瞬间恢复完整上下文——任务目标、子任务进度、决策记录、已知约束，一目了然。

结构化子任务管理：每个子任务都是独立的Markdown文件，包含$plan task add、$plan task start、$plan task complete等命令。这种结构让复杂的大型项目可以被分解成可管理的小单元。

决策记录与追溯：$plan decide命令记录技术决策，$plan decisions查看所有决策。这不仅是为了记录，更是为了在后续开发中能够快速理解"为什么这样做"。

Git集成与团队协作：规划文件存放在.planning/目录，纳入版本控制。这意味着团队中的每个人都可以查看、review和贡献项目计划。冲突处理通过$plan resolve-conflict辅助解决。

适用边界与注意点

计划粒度控制：最佳实践是保持计划粒度适中。"实现用户系统"太粗，"在models.py第15行添加email字段"太细。推荐的粒度是"实现用户注册API"，3-5个子任务。

与自动记忆系统的互补：Plan With Files是显式的、结构化的；而ECC Toolkit的记忆系统是自动的、隐式的。两者可以互补——ECC自动捕获会话上下文，Plan With Files手动管理任务规划。

团队协作中的冲突处理：建议采用"任务认领"模式，每个开发者认领不同的子任务，减少同一文件的编辑冲突。

非代码项目的适用性：Plan With Files是一个通用的任务规划系统，可以用于技术方案调研、系统架构设计、项目管理工作分解等任何需要结构化规划的领域。