pwf · othmanadi, opencode — Claude Code command: starts planning-with-files
The pwf command sets up the planning-with-files workflow, generating a task plan, findings log and progress file for the current project.
MIT ★ 28,179 updated 2026-10-24
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesWhat pwf does
Running /pwf calls the pwf_init tool, which writes three files: task_plan.md, findings.md and progress.md. Leave out a name and the tool targets the project root; add a name after the flags and it builds a separate plan folder under .planning/YYYY-MM-DD-<slug>/, setting it as the active plan.
Flags pick the mode and template before the name is parsed: --gated switches to gated mode, --autonomous to autonomous mode, and --template analytics loads an analytics-specific template. Whatever words remain become the plan's name.
Once the files exist, the agent is expected to read them and fill in the goal, the next step and the task phases before touching anything else. From there it keeps following the planning-with-files skill: logging progress after each action, recording errors in the plan, and marking phases done as work finishes.
What it helps with
- kick off a structured task plan backed by three state files
- lock a task into a gated or autonomous working mode
- keep a plan isolated under its own dated folder in
.planning/ - track errors and progress outside the chat transcript
- load a ready-made template for analytics work
Example prompts for the agent
- Run /pwf --gated database-migration
- Start /pwf --autonomous --template analytics sales-report
- Kick off /pwf with no name to use the project root
How to install pwf
1Plugin marketplace
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Manually: put the files in place
.claude/commands/pwf.mdCall it with /pwf. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/pwf.mdCall it with /prompts:pwf. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/pwf.prompt.mdManually: put the files in place
.gemini/commands/pwf.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about pwf
How do you install pwf in Claude Code?
Run /plugin marketplace add OthmanAdi/planning-with-files, then /plugin install planning-with-files@planning-with-files.
What does the pwf command do?
It starts the planning-with-files workflow, creating task_plan.md, findings.md and progress.md, then requires the goal, next step and phases to be filled in before any other work begins.
What's the difference between naming a plan and leaving it unnamed?
Supplying a name after the flags makes the tool create a separate plan folder under .planning/YYYY-MM-DD-<slug>/ and set it active; without a name it uses the project root instead.
Source text
pwf.md · MIT
--- description: Start planning-with-files (task_plan.md, findings.md, progress.md); flags --gated, --autonomous, --template analytics, then an optional plan name --- Start the planning-with-files workflow for this project. Arguments given: "$ARGUMENTS" 1. Call the `pwf_init` tool. Map the arguments: `--gated` sets mode "gated", `--autonomous` sets mode "autonomous", `--template analytics` sets template "analytics"; every remaining word forms the plan name. A name creates an isolated `.planning/YYYY-MM-DD-<slug>/` plan and makes it the active plan; no name uses the project root. 2. Read the created `task_plan.md`, `findings.md` and `progress.md` from the directory the tool reports, then fill in the goal, the next step and the phases for the task at hand before any other work. 3. Follow the planning-with-files skill from then on: update `progress.md` after every action, log errors in the plan, and mark phases complete as they finish.
© OthmanAdi · MIT · OthmanAdi/planning-with-files
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →pwf by other authors comes first.