OthmanAdi/planning-with-files
Keeps the plan, findings and progress as three markdown files in the project and re-injects the current phase every turn, so an agent resumes after /clear, compaction or a crash.
Three files on disk carry the plan: task_plan.md holds phases and checkboxes, findings.md collects research notes and decisions, progress.md logs the session and test results — all plain markdown and gitignored by default. Parallel tasks get isolated .planning/YYYY-MM-DD-slug/ directories selected through an .active_plan pointer. Because the plan is re-injected from the filesystem instead of living in the context window, it survives /clear, compaction and crashes; the project's own measurement reports a 13.3-turn re-orientation dropping to 5.0 turns, with 3 of 3 blind A/B wins.
Install
dsh plugin --profile web add dsh-planning-with-filesThe DSH line from the README's host install block; it says the same command works for the headless, sdk and acp profiles, then restart dsh web. npm package dsh-planning-with-files, latest 1.0.1, registry repository resolves to this repo. The README also documents the host-neutral npx skills add route, which installs the skill into ~/.agents/skills — a directory DSH reads.
Compatibility
DeepSeek Harness became a first-class host in v3.20.0 per the changelog: the native Cordis plugin injects the plan on every prompt and after compaction, reminds after writes, holds the turn boundary in gated mode, and registers /pwf, /pwf-status and the pwf_* tools. Two named plans in one project require PLAN_ID.
Details
- Repo: OthmanAdi/planning-with-files
- Category: Agent Capabilities
- Stars: 27534
- Version: 1.0.1 (npm); MIT
Alternatives
HuanLinOTO/dsh-plugin-interpreters · YYTbit/dsh-plugin-pi-bridge · HuanLinOTO/dsh-plugin-sleep