# Planning with Files — Manus-Style Persistent Planning Skill

> Claude Code skill implementing persistent markdown planning with 96.7% benchmark pass rate. Uses a 3-file pattern (task_plan.md, findings.md, progress.md) to survive context resets.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

Install the planning skill globally:

```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
```

Or manually:
1. Copy the SKILL.md content below
2. Save to `.claude/skills/planning-with-files.md` in your project
3. Claude Code loads it automatically on next conversation

---

## Intro

Planning with Files is a Claude Code skill that implements Manus-style persistent markdown planning, with 18,000+ GitHub stars and a 96.7% benchmark pass rate (29/30 assertions vs 6.7% without). It uses a 3-file pattern — `task_plan.md` for tracking phases, `findings.md` for storing research, and `progress.md` for session logs — treating the filesystem as persistent disk while the context window is volatile RAM. The skill survived 3/3 blind A/B tests and supports 16+ platforms.

Best for developers working on complex, multi-session projects where context continuity matters. Works with: Claude Code, Cursor, Codex CLI, Gemini CLI, Kiro, Copilot, Mastra Code. Setup time: under 1 minute.

---

## The 3-File Pattern

The core concept is simple but powerful:

```
Context Window = RAM (volatile)
Filesystem = Disk (persistent)
→ Anything important gets written to disk.
```

### task_plan.md — Track phases and progress
```markdown
# Task Plan

## Phase 1: Research
- [x] Investigate existing solutions
- [x] Document findings
- [ ] Choose approach

## Phase 2: Implementation
- [ ] Build core feature
- [ ] Add tests
```

### findings.md — Store research and discoveries
```markdown
# Findings

## API Options
- Option A: REST API (simpler, documented)
- Option B: GraphQL (flexible, newer)
→ Decision: Option A — better docs, team familiarity
```

### progress.md — Session log and test results
```markdown
# Progress

## Session 2026-04-04
- Completed Phase 1 research
- Found 3 API options, chose REST
- Next: Start Phase 2 implementation
```

### Key Features

- **Session Recovery**: When context resets, the skill reads planning files to restore full project context
- **2-Action Rule**: After every 2 significant actions, update planning files
- **3-Strike Error Protocol**: If the same error occurs 3 times, document it in findings.md and try a different approach
- **Security Boundaries**: Planning files never contain secrets, API keys, or credentials

### Benchmark Results

| Metric | With Skill | Without Skill |
|--------|-----------|--------------|
| Assertion Pass Rate | 96.7% (29/30) | 6.7% (2/30) |
| Blind A/B Wins | 3/3 | 0/3 |
| Context Recovery | Full | None |

### FAQ

**Q: What is Planning with Files?**
A: A Claude Code skill that implements persistent markdown planning using a 3-file pattern, achieving 96.7% benchmark pass rate for complex multi-session projects.

**Q: Is Planning with Files free?**
A: Yes, fully free and open source under the MIT license.

**Q: How do I install Planning with Files?**
A: Run `npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g` for global installation.

---

## Source & Thanks

> Created by [Ahmad Othman Ammar Adi](https://github.com/OthmanAdi). Licensed under MIT.
>
> [planning-with-files](https://github.com/OthmanAdi/planning-with-files) — ⭐ 18,000+

Thank you for bringing structured planning persistence to AI coding workflows.

---

<!-- ZH -->

## 快速使用

全局安装规划技能：

```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
```

---

## 简介

Planning with Files 是一个 Claude Code 技能，实现 Manus 风格的持久化 Markdown 规划，GitHub 星标 18,000+，基准测试通过率 96.7%（29/30 断言 vs 无技能时的 6.7%）。使用三文件模式 — `task_plan.md` 追踪阶段、`findings.md` 存储发现、`progress.md` 记录会话日志 — 将文件系统作为持久存储，对抗上下文窗口的易失性。

适合进行复杂、多会话项目的开发者。支持 Claude Code、Cursor、Codex CLI、Gemini CLI 等 16+ 平台。

---

## 三文件模式

核心概念：上下文窗口 = 内存（易失）/ 文件系统 = 磁盘（持久）→ 重要信息都写入磁盘。

- **task_plan.md** — 追踪阶段和进度
- **findings.md** — 存储研究和发现
- **progress.md** — 会话日志和测试结果

基准测试：通过率从 6.7% 提升到 96.7%，盲测 A/B 3/3 胜出。

---

## 来源与感谢

> Created by [Ahmad Othman Ammar Adi](https://github.com/OthmanAdi). Licensed under MIT.
>
> [planning-with-files](https://github.com/OthmanAdi/planning-with-files) — ⭐ 18,000+


---
Source: https://tokrepo.com/en/workflows/034be597-c361-45a2-b143-41cce0ec8ad8
Author: TokRepo精选