Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Planning with Files (Traditional Chinese edition)

Turns complex multi-step work into three persistent Markdown files — task_plan.md, findings.md, progress.md — so context survives compaction and /clear.

AutomationIntermediate★ 26,060⑂ 2,177AI score 10/10Last updated: Aug 9, 2026

What it does

Brings the Manus-style "files as disk working memory" pattern into Claude Code.

  • Creates task_plan.md (phases, status, decisions), findings.md (research) and progress.md (session log) before any complex task.
  • UserPromptSubmit, PreToolUse and PreCompact hooks re-inject the current plan on every tool call and before compaction.
  • After /clear, session-catchup.py plus git diff --stat reconstruct what happened in the previous session.
  • Ships concrete operating rules: two-operation save rule, three-strike failure protocol, error log table, read-vs-write decision matrix, anti-pattern table.
  • Security boundary: external web content goes only into findings.md, never into the hook-amplified task_plan.md.

Who it's for

  • Anyone running research or build tasks that span more than a handful of tool calls.
  • Users who lose their goal thread in long sessions or after context compaction.
  • Teams tracking multi-session projects in a repo.
  • Traditional Chinese speaking users (the instructions are in zh-Hant).

Examples

  1. "Analyze this repo and plan the migration" → generates a five-phase task_plan.md and flips phase status as work proceeds.
  2. During competitor research, findings are flushed to findings.md every two searches so nothing is lost when the window compacts.
  3. After /clear, asking to continue triggers the catch-up script, which reports unsynced changes and refreshes the plan files.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/OthmanAdi/planning-with-files/HEAD/skills/planning-with-files-zht/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/planning-with-files-zht folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/planning-with-files-zht/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf && cp -r /tmp/pwf/skills/planning-with-files-zht ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf
  3. Copy the skill: mkdir -p ~/.claude/skills && cp -r /tmp/pwf/skills/planning-with-files-zht ~/.claude/skills/
  4. Make the scripts executable: chmod +x ~/.claude/skills/planning-with-files-zht/scripts/*.sh
  5. Verify Python is available with python3 --version (needed by the session catch-up script).
  6. If you installed to a non-standard path, add export PWF_SCRIPT_DIR=<skill-path>/scripts to your shell profile so the hooks resolve.
  7. Restart Claude Code and ask it to "plan this task" to confirm the plan files are created in your project root.
View source on GitHub ↗License: MIT