Planning with Files (Spanish Edition)
A Manus-style skill that keeps complex, multi-step work on track using persistent task_plan.md, findings.md and progress.md files.
What it does
Before starting any complex task, this skill creates three Markdown files in your project root and treats the filesystem as durable working memory:
task_plan.md— phases, status, key decisionsfindings.md— research and discoveriesprogress.md— session log, test results, changed files
Hooks re-inject the plan on every tool call and before context compaction, and session-catchup.py restores context after /clear by comparing plan files with git diff --stat. It also codifies practical rules: save findings after every 2 lookups, a three-strike failure protocol (change approach, then ask the user), and a security boundary that untrusted web content must go into findings.md only, never into the auto-injected task_plan.md.
Who it's for
- Developers running long tasks that span many tool calls (migrations, refactors, audits)
- Anyone frustrated by Claude drifting from the original goal in long sessions
- Teams that want a file-based handoff trail between sessions
- Spanish-speaking users; the English variant lives in the
planning-with-filesfolder
Examples
- API migration: ask it to move a project to v2 — it writes a 6-phase plan, flips each phase to
complete, and logs every error with the fix in a table. - Comparative research: while evaluating libraries, key notes land in
findings.mdevery two searches, so evidence survives context compaction. - Session recovery: after
/clear, it reads the plan files plus the git diff, reconciles what actually shipped, and resumes from the right phase.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/planning-with-files-es folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/planning-with-files-es/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf && mkdir -p ~/.claude/skills && cp -r /tmp/pwf/skills/planning-with-files-es ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the Spanish variant:
cp -r /tmp/pwf/skills/planning-with-files-es ~/.claude/skills/ - Make the helper scripts executable:
chmod +x ~/.claude/skills/planning-with-files-es/scripts/*.sh - Verify Python is available (
python3 --version) sosession-catchup.pycan run. - Restart Claude Code, open your project folder, and ask it to plan a multi-step task.
- If you installed to a non-standard path, export
PWF_SCRIPT_DIRpointing at the skill'sscriptsdirectory so the hooks resolve.