# plan

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 540 repo stars
- Author: OthmanAdi
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills-curated/tree/HEAD/plugins/planning-with-files/commands/plan.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/plan-2

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add trailofbits/skills-curated
```
In the agent chat (not a shell):
```text
/plugin install planning-with-files@skills-curated
```

2. **Manually: put the files in place**
- File: `.claude/commands/planning-with-files-plan.md` — The 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/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/plan.md` — Call it with /prompts:plan. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/plan.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/plan.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/trailofbits/skills-curated/tree/HEAD/plugins/planning-with-files/commands/plan.md

## When to use it
- 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
- \`/plan` The goal is OAuth login for the API, split it into phases.
- Run `/plan` for the parser rewrite and keep the research notes in `findings.md`.
- \`/plan` for the payments module: the goal is test coverage.

## Similar
- [planning](https://affpapa.org/en/nevibecode/skills/planning.md) — skill · 712 installs
- [plan-goal](https://affpapa.org/en/nevibecode/commands/plan-goal.md) — command · ★ 28179 repo stars
- [alan-plan](https://affpapa.org/en/nevibecode/skills/alan-plan.md) — skill · 1800 installs
- [plan-harder](https://affpapa.org/en/nevibecode/skills/plan-harder.md) — skill · 1200 installs
- [log](https://affpapa.org/en/nevibecode/commands/log.md) — command · 351 installs
- [exec-plan](https://affpapa.org/en/nevibecode/skills/exec-plan.md) — skill · 239 installs

## Other versions with the same name
- [plan · othmanadi](https://affpapa.org/en/nevibecode/commands/othmanadi-plan.md) — ★ 28179 repo stars
- [plan · othmanadi](https://affpapa.org/en/nevibecode/commands/plan.md) — ★ 28179 repo stars
- [plan · worldflowai](https://affpapa.org/en/nevibecode/commands/affaan-mustafa-plan.md) — ★ 6739 repo stars
- [plan · disler](https://affpapa.org/en/nevibecode/commands/disler-plan.md) — ★ 3990 repo stars
- [plan · cloudai-x](https://affpapa.org/en/nevibecode/commands/cloudai-x-plan.md) — ★ 1424 repo stars

From the same set: [trailofbits/skills-curated](https://affpapa.org/en/nevibecode/by/trailofbits/skills-curated.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
