planning-with-files

Planning with Files

像 Manus 一样工作：使用持久化的 Markdown 文件作为“磁盘上的工作记忆”。

快速开始

在任何复杂任务开始之前：

在工作目录中创建 task_plan.md
用复选框定义各个阶段
每个阶段完成后更新——标记 [x] 并修改状态
决定前先阅读——在注意力窗口中刷新目标

三文件模式

对于每一个非平凡任务，创建三个文件：

文件	用途	更新时机
task_plan.md	跟踪阶段与进度	每个阶段之后
notes.md	存储发现与研究	研究过程中
[deliverable].md	最终输出	完成时

核心工作流

循环 1：创建包含目标与阶段的 task_plan.md
循环 2：研究 → 保存到 notes.md → 更新 task_plan.md
循环 3：阅读 notes.md → 创建交付物 → 更新 task_plan.md
循环 4：交付最终输出

循环详解

在每个主要操作之前：

Read task_plan.md  # Refresh goals in attention window

在每个阶段之后：

Edit task_plan.md  # Mark [x], update status

在存储信息时：

Write notes.md     # Don't stuff context, store in file

task_plan.md 模板

对于任何复杂任务，首先创建此文件：

# Task Plan: [Brief Description]

## Goal
[One sentence describing the end state]

## Phases
- [ ] Phase 1: Plan and setup
- [ ] Phase 2: Research/gather information
- [ ] Phase 3: Execute/build
- [ ] Phase 4: Review and deliver

## Key Questions
1. [Question to answer]
2. [Question to answer]

## Decisions Made
- [Decision]: [Rationale]

## Errors Encountered
- [Error]: [Resolution]

## Status
**Currently in Phase X** - [What I'm doing now]

notes.md 模板

用于研究与发现：

# Notes: [Topic]

## Sources

### Source 1: [Name]
- URL: [link]
- Key points:
  - [Finding]
  - [Finding]

## Synthesized Findings

### [Category]
- [Finding]
- [Finding]

关键规则

1. 始终先创建计划

没有 task_plan.md 就绝不开始复杂任务。这一点不可妥协。

2. 决定前先阅读

在任何重大决定之前，阅读计划文件。这会让目标保持在注意力窗口中。

3. 行动后更新

完成任何阶段后，立即更新计划文件：

用 [x] 标记已完成阶段
更新 Status 部分
记录遇到的任何错误

4. 存储，而不是塞入

大型输出写入文件，而不是上下文。工作记忆中只保留路径。

5. 记录所有错误

每个错误都写入“Errors Encountered”部分。这为未来任务积累知识。

何时使用此模式

对以下场景使用三文件模式：

多步骤任务（3 步以上）
研究型任务
构建/创建某物
跨越多次工具调用的任务
任何需要组织管理的任务

对以下场景跳过：

简单问题
单文件编辑
快速查询

需要避免的反模式

不要	而应这样做
用 TodoWrite 做持久化	创建 task_plan.md 文件
只陈述一次目标就遗忘	每次决定前重读计划
隐藏错误并重试	将错误记录到计划文件
把所有内容塞进上下文	将大型内容存入文件
立即开始执行	先创建计划文件

高级模式

参见 reference.md 了解：注意力操纵技巧、错误恢复模式、来自 Manus 的上下文优化
参见 examples.md 了解：真实任务示例、复杂工作流模式