othmanadi avatar

Pi Planning With Files

If you're working on anything that takes more than a handful of steps, this gives Claude persistent memory through three markdown files: task_plan.md for your roadmap, findings.md for discoveries, and progress.md for tracking what's done. The standout feature is session recovery. Run a Python script after you `/clear` the conversation and Claude picks up right where it left off by reading those files back in. It enforces a workflow: plan first, update after each phase, log errors, and never retry the same failed action twice. There's a three-strike protocol for debugging and templates to keep things structured. Basically turns your project directory into Claude's external brain so context survives across sessions.

skills.sh installs
10.5K
GitHub stars
28.1K
last updated
Aug 21, 2026

Install

$ npx -y skills add othmanadi/planning-with-files --skill pi-planning-with-files --agent claude-code

Installs into .claude/skills of the current project.

Files

If you're working on anything that takes more than a handful of steps, this gives Claude persistent memory through three markdown files: task_plan.md for your roadmap, findings.md for discoveries, and progress.md for tracking what's done. The standout feature is session recovery. Run a Python script after you `/clear` the conversation and Claude picks up right where it left off by reading those files back in. It enforces a workflow: plan first, update after each phase, log errors, and never retry the same failed action twice. There's a three-strike protocol for debugging and templates to keep things structured. Basically turns your project directory into Claude's external brain so context survives across sessions.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/othmanadi/planning-with-files
Categories
Code Review & Quality, Data Science & ML, Productivity & Planning

More from othmanadi/planning-with-files

All 7
1agricidaniel avatarseoagricidaniel/claude-seoComprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals 10.4Kskills.sh installs
2github avataragentic-evalgithub/awesome-copilotPatterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluat10.3Kskills.sh installs
3ljagiello avatarctf-pwnljagiello/ctf-skillsProvides binary exploitation techniques for CTF challenges. Use when you already have a vulnerable native target or service and need to turn memory corruption o10.2Kskills.sh installs
4wshobson avatarteam-communication-protocolswshobson/agentsStructured messaging protocols for agent team communication including message type selection, plan approval, shutdown procedures, and anti-patterns to avoid. Us10.2Kskills.sh installs
5nomadamas avatarkorean-middle-koreannomadamas/k-skillConvert incoming Korean text into a deterministic Korean Middle Korean-style rewrite with archaic particles, endings, Hanja hints, and tone-mark flavor.10.1Kskills.sh installs
6clickhouse avatarchdb-sqlclickhouse/agent-skillsUse when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoD10.1Kskills.sh installs