plan · othmanadi, hermes — Claude Code command: what it does, how to install
Loads the planning-with-files skill and starts planning in the current project. Handy when you want to begin a new plan or continue an existing one.
MIT ★ 28,179 updated 2026-10-24
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesWhat plan does
The plan command starts the planning-with-files workflow in whatever project you are working in. It pulls in the planning-with-files skill first and hands control to it.
The agent finds the real project root for the task, calls planning_with_files_init with cwd pointing at that root, then reads task_plan.md, findings.md and progress.md from the same folder. After that it either starts a fresh plan or picks up the one already there.
The root matters. If the agent picks the wrong folder, initialization and file reads happen in that folder. In Codex the command file is ~/.codex/prompts/plan.md.
What it helps with
- start a plan for a new task in a project
- resume an earlier plan from
progress.md - load
task_plan.mdandfindings.mdinto the agent's context - tie plan initialization to the project root instead of a subfolder
- launch the
planning-with-filesskill with one command
Example prompts for the agent
/planning-with-files:plan- Run
/planning-with-files:planand continue the plan for the current task - Start planning-with-files in this project and read
task_plan.mdfirst
How to install plan
1Plugin marketplace
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Manually: put the files in place
.claude/commands/planning-with-files-plan.mdThe built-in /plan overrides a file with the same name, so the file is renamed. Call it with /planning-with-files-plan. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/plan.mdCall it with /prompts:plan. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/plan.prompt.mdManually: put the files in place
.gemini/commands/plan.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about plan
How do I install plan in Claude Code?
Add the marketplace with /plugin marketplace add OthmanAdi/planning-with-files, then run /plugin install planning-with-files@planning-with-files.
What does the plan command do?
It loads the planning-with-files skill, finds the project root and runs planning_with_files_init with cwd set to it. The agent then reads the plan files and starts or continues the work.
Which files does plan read, and from where?
task_plan.md, findings.md and progress.md. The agent reads them from the same directory it passed to planning_with_files_init as cwd.
Source text
plan.md · MIT
--- description: "Start Hermes planning-with-files workflow in the current project." --- Load the `planning-with-files` skill and follow it. 1. Determine the actual project root for the current task. 2. Run `planning_with_files_init` with `cwd` set to that project root. 3. Read `task_plan.md`, `findings.md`, and `progress.md` from that same directory. 4. Begin or continue the planning workflow.
© OthmanAdi · MIT · OthmanAdi/planning-with-files
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →plan by other authors comes first.