Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts.
安装
npx skills add OthmanAdi/planning-with-files --skill pi-planning-with-filesnpx skills add OthmanAdi/planning-with-files --skill pi-planning-with-files -a claude-code -gnpx skills add OthmanAdi/planning-with-files --skill pi-planning-with-files -a codex -ggemini skills install https://github.com/OthmanAdi/planning-with-files.git --path .pi/skills/planning-with-filesgh skill install OthmanAdi/planning-with-files pi-planning-with-filesgit clone --depth 1 https://github.com/OthmanAdi/planning-with-files /tmp/OthmanAdi__planning-with-files
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/OthmanAdi__planning-with-files/.pi/skills/planning-with-files ~/.claude/skills/pi-planning-with-files # Claude Code
cp -R /tmp/OthmanAdi__planning-with-files/.pi/skills/planning-with-files ~/.agents/skills/pi-planning-with-files # Codex, Cursor, Gemini CLI, Copilot, OpenCode