plan · trailofbits — Claude Code command: what it does, how to install
Creates task_plan.md, findings.md and progress.md in the project root, so the goal, research and session log sit next to the code.
CC-BY-SA-4.0 ★ 540 updated 2026-07-14
/plugin marketplace add trailofbits/skills-curated
/plugin install planning-with-files@skills-curatedWhat plan does
First it checks the project root for task_plan.md, findings.md and progress.md. If any of the three is already there, the command lists what it found and waits for a yes before starting over. Then it asks what the task is for and puts that answer into the Goal section of task_plan.md.
Templates come from {baseDir}/skills/planning-with-files/references/templates.md. The session date lands in progress.md, and phase titles appear only when your description of the goal is detailed enough to split into steps. The run ends with a summary of the created files and the current phase, Phase 1 - Requirements & Discovery.
Three tools are allowed: Read, Write and Glob. Nothing runs, no source file is edited, so the plan stays a text you keep working in. Give a fuller answer about the goal, because the phases you get back depend on it.
What it helps with
- keep the task goal, research notes and session log in separate files
- start a new task without silently losing the old plan
- sketch the phases before writing any code
- record decisions while the research is still fresh
- log each session with its date and current phase
Example prompts for the agent
/planThe goal is OAuth login for the API, split it into phases.- Run
/planfor the parser rewrite and keep the research notes infindings.md. /planfor the payments module: the goal is test coverage.
How to install plan
1Plugin marketplace
/plugin marketplace add trailofbits/skills-curated/plugin install planning-with-files@skills-curated2Manually: 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?
Run /plugin marketplace add trailofbits/skills-curated to add the marketplace, then /plugin install planning-with-files@skills-curated.
What does the plan command do?
It creates task_plan.md, findings.md and progress.md in the project root after asking for the task goal, then prints a summary with the current phase.
Will it overwrite planning files I already have?
Not without asking. It checks the root first and shows which of the three files exist before you confirm a fresh start.
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →plan by other authors comes first.