othmanadi avatar

Planning With Files Zht

This is a structured file-based planning system inspired by Manus that treats your filesystem as persistent memory. It creates three markdown files in your project directory: task_plan.md for phases and progress, findings.md for research discoveries, and progress.md for session logs. The hooks automatically inject plan context before tool use and remind you to update progress after edits. There's a two-step rule: after every two browser or search operations, save key findings to disk immediately because multimodal content doesn't persist in context. It includes session recovery scripts to catch up after /clear commands. The security boundary is worth noting: task_plan.md gets auto-injected frequently, so only write trusted content there and keep external web scraping results in findings.md. Use this for any multi-step task requiring more than five tool calls.

skills.sh installs
7.9K
GitHub stars
28K
last updated
Aug 21, 2026

Install

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

Installs into .claude/skills of the current project.

Files

檔案規劃系統

像 Manus 一樣工作:用持久化的 Markdown 檔案作為你的「磁碟工作記憶」。

第一步:恢復專案狀態

繼續之前,先解析此任務所屬的計畫目錄:

  1. 使用已安裝的 scripts/resolve-plan-dir.sh(或 .ps1),配合主機的 PLAN_ID 與 PWF_PLAN_ROOT,從這一個選定目錄讀取 task_plan.md、progress.md 和 findings.md。
  2. 若明確選擇器被拒絕,或工作階段隔離已啟用且有多個計畫卻沒有 PLAN_ID,請修正釘選,不要退回另一項任務。只有沒有適用的選擇器或具名計畫時,才使用專案根目錄的舊檔案。
  3. 執行 git diff --stat,查看尚未記錄的程式碼變更。

下列所有規劃檔案名稱都指向這個選定目錄。平行任務時,請在啟動每個主機前釘選它,或使用獨立 worktree;在子程序中匯出變數不會改變主機環境。一位協調者擁有共享計畫與摘要,工作者使用指派的檔案或帳本。

自動恢復到此為止。未指定模式的 session-catchup.py 與生命週期鉤子不會檢查代理工作階段儲存區。只有在使用者明確要求查閱本機工作階段歷史時,才能選擇下列模式:

# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-zht}"
# 只顯示同一專案的項目數,不輸出逐字稿摘錄
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --metadata "$(pwd)"

# 明確要求的限量重播,以 nonce 框定同一專案的摘錄
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --replay "$(pwd)"
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zht\scripts\session-catchup.py" --metadata (Get-Location)
# 只有在使用者明確同意後,才能將 --metadata 改為 --replay。

Sponsors

Details

Repository
github.com/othmanadi/planning-with-files
Category
Productivity & Planning
First seen
Apr 16, 2026

More from othmanadi/planning-with-files

All 7
1othmanadi avatarplanning-with-files-esothmanadi/planning-with-filesSistema de planificación basado en archivos estilo Manus para organizar y rastrear el progreso de tareas complejas. Crea task_plan.md, findings.md y progress.md6.9Kskills.sh installs
2othmanadi avatarplanning-with-files-deothmanadi/planning-with-filesManus-artiges Dateiplanungssystem zur Organisation und Verfolgung des Fortschritts komplexer Aufgaben. Erstellt task_plan.md, findings.md und progress.md. Wird 6.8Kskills.sh installs
3othmanadi avatarplanning-with-files-arothmanadi/planning-with-filesنظام تخطيط الملفات بنمط Manus لتنظيم وتتبع تقدم المهام المعقدة. ينشئ ملفات task_plan.md و findings.md و progress.md. يُستخدم عند طلب التخطيط أو تحليل المهام أو 6.8Kskills.sh installs
4wondelai avatardesign-sprintwondelai/skillsRun a structured 5-day process to prototype, test, and validate product ideas with real users. Use when the user mentions "design sprint", "validate before we b5.7Kskills.sh installs
5pageai-pro avatarprd-creatorpageai-pro/ralph-loopGuides creation of comprehensive Product Requirement Documents (PRDs) for software projects through structured questioning and validation, then generates implem5.4Kskills.sh installs
6dotnet avatarplan-ui-changedotnet/skillsPlan complex Blazor UI features by decomposing them into focused components. USE FOR: building a complex Blazor page with multiple sections, planning component 3.7Kskills.sh installs