planner · ruvnet — Claude Code subagent: what it does, how to install
planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory.
no license ★ 850 updated 2026-10-26
.claude/agents/planner.mdWhat planner 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.
What it helps with
- 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 for the agent
- 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
How to install planner
Manually: put the files in place
.claude/agents/planner.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/planner.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/planner.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about planner
How to install planner in Claude Code?
Add the agent definition file to .claude/agents/planner.md in your workspace.
What is planner used for?
It orchestrates projects by decomposing complex tasks, mapping dependencies, and generating actionable YAML execution plans.
What dependencies do the planner hooks require?
Both pre- and post-hooks rely on the npx claude-flow command-line utility to record patterns and train coordinator models.
Similar subagents
All subagents for Agent setup: memory, context, orchestration →planner by other authors comes first.