# planner

planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/core/planner.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/ruvnet-planner

## What it does

\`planner` acts as a coordination agent for complex engineering requests. It splits work into atomic steps, detects potential bottlenecks, and identifies the critical path. The output is structured as a clear YAML plan with milestones, assigned agents, time estimates, and validation criteria.

Pre-execution hooks inspect prior successes and failures through `claude-flow memory search-patterns`. Once the plan is ready, a post-hook computes quality metrics and initiates neural training for 50 epochs if the plan contains over 10 tasks. Running these automated hooks requires `npx claude-flow` in your environment.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/planner.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/planner.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/planner.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/core/planner.md

## When to use it
- break complex technical initiatives into atomic subtasks
- identify critical path dependencies before starting implementation
- assign distinct task phases to specialized agents
- adjust planning choices based on recorded historical failures

## Example prompts
- Plan the database migration to PostgreSQL with dependency ordering
- Break down the authentication refactor into stages with time estimates
- Assess delivery risks and allocate agents for payment gateway integration

## Similar
- [gem-planner](https://affpapa.org/en/nevibecode/agents/gem-planner.md) — subagent · ★ 41430 repo stars
- [planner-identity-base](https://affpapa.org/en/nevibecode/rules/planner-identity-base.md) — rule · ★ 1627 repo stars
- [Orchestration Planner](https://affpapa.org/en/nevibecode/skills/orchestration-planner.md) — skill · 134 installs
- [screen-planner](https://affpapa.org/en/nevibecode/agents/screen-planner.md) — subagent · ★ 1167 repo stars
- [swarm-planner](https://affpapa.org/en/nevibecode/skills/swarm-planner.md) — skill · 1200 installs
- [travel-planner](https://affpapa.org/en/nevibecode/skills/travisjneuman-travel-planner.md) — skill · 526 installs

## Other versions with the same name
- [Planner · microsoft](https://affpapa.org/en/nevibecode/agents/planner.md) — 406 installs
- [planner · worldflowai](https://affpapa.org/en/nevibecode/agents/affaan-mustafa-planner.md) — ★ 6739 repo stars
- [planner · rohitg00](https://affpapa.org/en/nevibecode/agents/rohit-ghumare-planner.md) — ★ 2966 repo stars
- [planner · nycu-chung](https://affpapa.org/en/nevibecode/agents/nycu-chung-planner.md) — ★ 267 repo stars

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 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
