Planning with Files (Arabic edition)

A Manus-style workflow that keeps task_plan.md, findings.md and progress.md on disk as durable working memory for multi-step tasks, with Arabic-language instructions.

AutomationIntermediate★ 26,167⑂ 2,188AI score 10/10Last updated: Aug 9, 2026

What it does

Requires creating task_plan.md (phases, decisions), findings.md (research), progress.md (session log) in your project root before starting any complex task.
Hooks (UserPromptSubmit, PreToolUse, PreCompact) re-inject the active plan into context on prompts and tool calls, so goals stay in the attention window during long sessions.
After /clear or an interrupted session, scripts/session-catchup.py plus git diff --stat reveal work that never made it into the plan files, then the docs are reconciled.
Ships explicit operating rules: two-step save rule, triple-failure protocol (diagnose → alternate approach → question assumptions → ask the user), an error log table, a read-vs-write decision matrix, and a five-question restart test.
Security boundary: external web/API content goes only into findings.md, never task_plan.md, because that file is auto-re-read by hooks and would amplify injected instructions.

Who it's for

Anyone running tasks longer than three steps — migrations, research, project builds — across multiple sessions.
Users tired of the assistant losing the objective mid-task or retrying the same failing action.
Arabic-speaking teams that want their planning artifacts written in Arabic.

Examples

"Migrate this legacy API to v2" → a phased task_plan.md is generated and each phase is flipped to complete as work lands.
Competitive research → after every two searches, key discoveries are written straight into findings.md so multimodal/browser output isn't lost.
Resuming after /clear → run session-catchup.py, refresh progress.md from the real git diff, then continue with the remaining phases.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/OthmanAdi/planning-with-files/HEAD/skills/planning-with-files-ar/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

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.

↓ Download 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-ar folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/planning-with-files-ar/.
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 && mkdir -p ~/.claude/skills && cp -r planning-with-files/skills/planning-with-files-ar ~/.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
Create the skills folder: mkdir -p ~/.claude/skills
Copy the Arabic variant: cp -r planning-with-files/skills/planning-with-files-ar ~/.claude/skills/
Make the helper scripts executable: chmod +x ~/.claude/skills/planning-with-files-ar/scripts/*.sh
Verify Python is available with python3 --version (needed by session-catchup.py).
Restart Claude Code, then ask it to "plan this task" and confirm task_plan.md appears in your project.
If you installed to a non-standard path, add export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files-ar/scripts to your shell profile so the hooks can find the scripts.

View source on GitHub ↗License: MIT