pi-planning-with-files

Installation
Summary

Persistent file-based planning system for organizing complex multi-step tasks and maintaining context across sessions.

  • Creates three markdown files (task_plan.md, findings.md, progress.md) in your project directory to serve as persistent working memory
  • Includes session recovery via script to sync context after /clear commands and resume interrupted work
  • Enforces structured workflows: plan first, update after each phase, log all errors, and never repeat failed actions
  • Provides templates, helper scripts, and a 3-strike error protocol to prevent silent failures and guide systematic troubleshooting
SKILL.md

Planning with Files

Work like Manus: Use persistent markdown files as your "working memory on disk."

FIRST: Check for Previous Session

Before starting work, check for unsynced context from a previous session:

Note: The scripts/ directory is inside this skill's installation folder.

# Linux/macOS
python scripts/session-catchup.py "$(pwd)"
# Windows PowerShell
python "scripts\session-catchup.py" (Get-Location)
Related skills

More from othmanadi/planning-with-files

Installs
5.4K
GitHub Stars
21.4K
First Seen
Feb 4, 2026