🗂️
AI EngineeringShell

Planning With Files

by OthmanAdi

Planning With Files is an AI Engineering skill for Claude Code, published by OthmanAdi in planning-with-files.

26.2K stars2.2K forkson OthmanAdi/planning-with-filesAdded 2026/08/14Repository updated 2026/08/09
agent-skillsautonomous-agentsclaudeclaude-codeclaude-code-skillsclaude-skillscodexcoding-agentcontext-engineeringcontext-rotcursorgithub-copilothermes-pluginhermes-skillllm-agentslong-running-agentsmanusmulti-agent-systemsplanningsession-recovery
Install in seconds
Install Planning With Files
Copy Planning With Files into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/OthmanAdi/planning-with-files/tree/master/skills/planning-with-files-zht ~/.claude/skills/planning-with-files-zht

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/OthmanAdi/planning-with-files.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/planning-with-files-zht/SKILL.md in OthmanAdi/planning-with-files
Installs to
~/.claude/skills/planning-with-files-zht
Collection
One of 15 skills cataloged from this repository
Category
AI Engineering2451 skills

What Planning With Files does

Planning With Files organizes complex tasks using persistent Markdown files for task plans, findings, and progress. Use it for multi-step projects, research, or any work requiring more than five tool calls, with session recovery support.

Planning With Files is cataloged under AI Engineering on DirSkills. Planning With Files comes from a repository tagged agent-skills, autonomous-agents, claude, claude-code and claude-code-skills.

Documentation

README

檔案規劃系統

像 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-zht}"
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)"
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zht\scripts\session-catchup.py" (Get-Location)

如果恢復報告顯示有未同步的上下文:

  1. 執行 git diff --stat 查看實際程式碼變更
  2. 讀取目前規劃檔案
  3. 根據恢復報告和 git diff 更新規劃檔案
  4. 然後繼續任務

重要:檔案存放位置

  • 範本${CLAUDE_PLUGIN_ROOT}/templates/
  • 你的規劃檔案放在你的專案目錄

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Planning With Files

  • What else does OthmanAdi publish alongside Planning With Files?

    Planning With Files is one of 15 skills that DirSkills catalogs from OthmanAdi/planning-with-files, the repository it ships in. Its siblings there include Planning With Files, Planning With Files and Planning with Files. Each one is a separate skill with its own page in this directory, installs the same way Planning With Files does, and is maintained by OthmanAdi in that same repository. The rest of the collection is listed on the OthmanAdi/planning-with-files page.

  • How does Planning With Files compare to other AI Engineering skills?

    Planning With Files ranks #222 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Planning With Files against them. Open each page to compare what they document and how they install.

More from OthmanAdi/planning-with-files

Planning With Files is one of 15 skills cataloged on DirSkills from OthmanAdi/planning-with-files.

See all 15 skills
📋
2w ago

Planning With Files

Planning With Files creates task_plan.md, findings.md, and progress.md files to organize and track progress on complex multi-step tasks. Use it when planning, analyzing tasks, organizing projects, or tracking progress.
AI Engineering
26.2K2.2K
📋
2w ago

Planning With Files

Planning With Files organizes multi-step tasks using three Markdown files — task_plan.md, findings.md, and progress.md — to persist progress, findings, and session logs. Use it before starting a complex project or when you need to resume work after a context reset.
AI Engineering
26.2K2.2K
🗂️
2w ago

Planning with Files

Planning with Files keeps task_plan.md, findings.md, and progress.md on disk so an AI coding agent can persist context and recover after /clear or context loss. Use it for multi-step projects, research tasks, or any work requiring 5+ tool calls.
AI Engineering
26.2K2.2K
🗂️
2w ago

Planning with Files

Planning with Files keeps task_plan.md, findings.md, and progress.md on disk so an agent's work survives context loss and /clear. Use it to plan, break down, or organize multi-step projects, research tasks, or any work requiring five or more tool calls.
Automation
26.2K2.2K
🗂️
2w ago

Planning with Files

Planning with Files keeps task plans, findings, and progress in persistent markdown files so an AI coding agent can retain context across sessions and /clear. Use it for multi-step projects, research, or any task requiring 5+ tool calls; supports session recovery.
AI Engineering
26.2K2.2K
🗂️
2w ago

Planning with Files

Planning with Files keeps task_plan.md, findings.md, and progress.md on disk so an AI coding agent's plan and findings survive context loss and /clear. Use it to plan, break down, or organize multi-step projects, research tasks, or any work requiring 5+ tool calls, with automatic session recovery.
AI Engineering
26.2K2.2K