planning-with-files-zh

Installation
Summary

Manus-style file-based planning system for organizing and tracking multi-step project progress.

  • Creates three persistent markdown files—task_plan.md, findings.md, and progress.md—that serve as disk-based working memory across sessions
  • Automatically detects and loads active plans on each prompt, with tamper detection and attestation to prevent injection attacks
  • Includes session recovery via catchup script to restore context from previous interrupted work and sync untracked changes
  • Supports scoped plans (nested in .planning/ directories) and root-level plans, with clear rules for when to read, write, and update each file
  • Provides templates, error tracking matrices, and a three-failure protocol to prevent repeated mistakes and guide decision-making before major actions
SKILL.md
Contains Hooks

This skill uses Claude hooks which can execute code automatically in response to events. Review carefully before installing.

文件规划系统

像 Manus 一样工作:用持久化的 Markdown 文件作为你的「磁盘工作记忆」。

第一步:恢复上下文(v2.2.0)

在做任何事之前,检查规划文件是否存在并读取它们:

  1. 如果 task_plan.md 存在,立即读取 task_plan.mdprogress.mdfindings.md
  2. 然后检查上一个会话是否有未同步的上下文:
# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-zh}"
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)"
Installs
14.4K
GitHub Stars
24.4K
First Seen
Mar 19, 2026
planning-with-files-zh — othmanadi/planning-with-files