Planning With Files

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-zh ~/.claude/skills/planning-with-files-zh

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-zh/SKILL.md in OthmanAdi/planning-with-files
Installs to: ~/.claude/skills/planning-with-files-zh
Collection: One of 15 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Planning With Files does

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.

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

Excerpt

文件规划系统

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

第一步：恢复上下文（v2.2.0）

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

如果 task_plan.md 存在，立即读取 task_plan.md、progress.md 和 findings.md。
然后检查上一个会话是否有未同步的上下文：

# 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)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zh\scripts\session-catchup.py" (Get-Location)

如果恢复报告显示有未同步的上下文：

运行 git diff --stat 查看实际代码变更
读取当前规划文件
根据恢复报告和 git diff 更新规划文件
然后继续任务

重要：文件存放位置

模板在 ${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 #221 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.