planning-with-files

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Planning with Files

基于文件的规划

"Work like Manus" — Uses persistent markdown files for planning, progress tracking, and knowledge storage.

“像Manus一样工作” —— 使用持久化Markdown文件进行规划、进度跟踪和知识存储。

Description

说明

A Claude Code skill that transforms your workflow to use persistent markdown files for planning and progress tracking — the pattern that made Manus AI worth billions.

这是一个Claude Code skill，可将你的工作流转换为使用持久化Markdown文件进行规划和进度跟踪——正是这种模式让Manus AI价值数十亿美元。

The Problem

现存问题

Claude Code (and most AI agents) suffer from:

Volatile memory — TodoWrite tool disappears on context reset
Goal drift — Original goals get forgotten after many tool calls
Hidden errors — Failures aren't tracked, mistakes repeat
Context stuffing — Everything crammed into context instead of stored

Claude Code（以及大多数AI Agent）存在以下痛点：

易失性内存 —— 上下文重置后TodoWrite工具内容会消失
目标偏离 —— 经过多次工具调用后，最初的目标会被遗忘
隐藏错误 —— 失败未被跟踪，错误会重复出现
上下文过载 —— 所有内容都被塞进上下文而非存储到外部

The Solution: 3-File Pattern

解决方案：三文件模式

For every complex task, create THREE files:

text

task_plan.md      → Track phases and progress
notes.md          → Store research and findings
[deliverable].md  → Final output

对于每个复杂任务，创建三个文件：

text

task_plan.md      → 跟踪阶段和进度
notes.md          → 存储研究内容和发现
[deliverable].md  → 最终输出

The Workflow Loop

工作流循环

text

1. Create task_plan.md with goal and phases
2. Research → save to notes.md → update task_plan.md
3. Read notes.md → create deliverable → update task_plan.md
4. Deliver final output

text

1. 创建包含目标和阶段的task_plan.md
2. 开展研究 → 保存到notes.md → 更新task_plan.md
3. 读取notes.md → 创建交付物 → 更新task_plan.md
4. 交付最终输出

When to Use

使用场景

Use this pattern for:

Multi-step tasks (3+ steps)
Research tasks
Building/creating projects
Tasks spanning many tool calls
Anything requiring organization

Skip for:

Simple questions
Single-file edits
Quick lookups

适用场景：

多步骤任务（3步及以上）
研究类任务
项目构建/创建
需要多次调用工具的任务
任何需要组织管理的工作

不适用场景：

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

Installation

安装

This skill is typically installed globally at

~/.claude/skills/planning-with-files/

From this repository:

bash

ln -s /path/to/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files

If you prefer the standalone workflow, see the upstream repository in the Links section.

该skill通常全局安装在

~/.claude/skills/planning-with-files/

路径下。

从本仓库安装：

bash

ln -s /path/to/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files

如果你偏好独立工作流，请查看链接部分的上游仓库。

The Manus Principles

Manus原则

Principle	Implementation
Filesystem as memory	Store in files, not context
Attention manipulation	Re-read plan before decisions
Error persistence	Log failures in plan file
Goal tracking	Checkboxes show progress
Append-only context	Never modify history

原则	实现方式
文件系统作为内存	存储在文件中，而非上下文
注意力管理	做决策前重新阅读计划
错误持久化	在计划文件中记录失败情况
目标跟踪	用复选框显示进度
仅追加上下文	绝不修改历史内容

Example

示例

You: "Research the benefits of TypeScript and write a summary"

Claude creates:

markdown

undefined

你： "研究TypeScript的优势并撰写摘要"

Claude创建了以下文件：

markdown

undefined

Task Plan: TypeScript Benefits Research

任务计划：TypeScript优势研究

Goal

目标

Create a research summary on TypeScript benefits.

撰写一份关于TypeScript优势的研究摘要。

Phases

阶段

Phase 1: Create plan ✓
Phase 2: Research and gather sources (CURRENT)
Phase 3: Synthesize findings
Phase 4: Deliver summary

阶段1：创建计划 ✓
阶段2：研究并收集资料（当前进行中）
阶段3：整合研究发现
阶段4：交付摘要

Status

状态

Currently in Phase 2 - Searching for sources

undefined

当前处于阶段2 - 正在搜索资料

undefined