Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Planning with Files (Arabic Edition)

An Arabic-language planning skill that splits complex work into task_plan, findings and progress Markdown files and auto-restores the plan after context is cleared.

AutomationIntermediate★ 26,060⑂ 2,177AI score 8/10Last updated: Aug 9, 2026

What it does

Brings the Manus-style "filesystem as working memory" pattern into Claude Code.

  • Creates three core files in your project root: task_plan.md (phases, progress, decisions), findings.md (research notes), progress.md (session log).
  • Automatic context recovery: UserPromptSubmit / PreToolUse / PreCompact hooks re-inject the active plan, and session-catchup.py reconciles the plan with git diff after /clear or compaction.
  • Enforces discipline: the two-step rule (save findings after every two searches), a three-strike failure protocol (diagnose → alternate approach → rethink → ask the user), and a mandatory error table.
  • Read vs. write decision matrix plus an anti-pattern table clarify when to re-read the plan and when to flush content to disk.
  • Security boundary: untrusted web/API content must go to findings.md only, since task_plan.md is re-injected on every tool call.

The instructional body is written in Arabic, making it ideal for Arabic-speaking users.

Who it's for

  • Developers running multi-step (3+ phase) tasks who keep losing state to compaction
  • Anyone doing research or documentation work spanning several sessions
  • Teams that manage project plans and logs in Arabic
  • Users who prefer durable plan files over ephemeral TodoWrite lists

Examples

  1. Large refactor: ask it to plan a TypeScript migration — it generates a phased task_plan.md, flips each phase to complete, and accumulates encountered errors in a table.
  2. Resuming after /clear: on your next prompt the hook reloads the plan files and session-catchup.py summarizes what was already done using git diff.
  3. Competitive research: every two web searches, results are written to findings.md so screenshot/PDF-derived details survive context loss.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. 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 /tmp/planning-with-files && cp -r /tmp/planning-with-files/skills/planning-with-files-ar ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/OthmanAdi/planning-with-files.git
  2. Create the skills folder if needed: mkdir -p ~/.claude/skills
  3. Copy the Arabic variant: cp -r planning-with-files/skills/planning-with-files-ar ~/.claude/skills/
  4. Make the helper scripts executable: chmod +x ~/.claude/skills/planning-with-files-ar/scripts/*.sh
  5. Confirm Python is available for session-catchup.py: python3 --version
  6. Restart Claude Code, open a project directory, and ask it to plan a multi-step task to verify task_plan.md appears.
  7. (Optional) 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 locate the scripts.
View source on GitHub ↗License: MIT