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.

Agent Capabilities ★ 27.5k
View on GitHub ↗

Install

dsh plugin --profile web add dsh-planning-with-files

The 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

Alternatives

HuanLinOTO/dsh-plugin-interpreters · YYTbit/dsh-plugin-pi-bridge · HuanLinOTO/dsh-plugin-sleep

More plugins in Agent Capabilities

Browse more in Agent Capabilities

Guides for Agent Capabilities plugins