pi-planning-with-files

# Planning with Files Work like Manus: Use persistent markdown files as your "working memory on disk." ## FIRST: Restore Project State **Before continuing**, resolve the plan this task owns: 1. Use the installed `scripts/resolve-plan-dir.sh` (or `.ps1`) with the task's `PLAN_ID` and `PWF_PLAN_ROOT`. Read `task_plan.md`, `progress.md`, and `findings.md` from that one selected directory. A root `task_plan.md` must not override a selected `.planning/<id>/` plan. 2. If an explicit selector is rejected, or multiple named plans exist without `PLAN_ID`, stop plan recovery and correct the pin. Do not fall back to another task. Use the legacy project-root files only when no selector or named plan applies. 3. Run `git diff --stat` to see code changes that may not yet be recorded in the planning files. All planning filenames below refer to this selected directory, even when the shell runs elsewhere. For parallel tasks, pin each host before starting it or use separate worktrees. A worker joining an existing task uses its assigned plan; it must not create or overwrite a competing root plan. Automatic recovery stops there. Bare `session-catchup.py` and lifecycle hooks do not inspect agent session stores. Only when the user explicitly asks to consult local session history, choose one of these modes: ```bash # Linux/macOS — auto-detects skill directory (plugin env or default install path) SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files}" # Same-project counts...