Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/planner.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Planner microsoft Planner explores requirements and the codebase, then drafts an implementation plan without changing files. Use it when you want to map the work before coding starts. CX Codex +1 406installs planner Affaan Mustafa planner generates structured implementation plans and refactoring roadmaps for Claude Code projects. CX Codex ★ 6,739repo stars planner Rohit Ghumare planner — a read-only subagent turns complex coding work into an implementation plan. Use it when several files, architecture choices, or unclear requirements are involved. CX Codex ★ 2,966repo stars planner NYCU-Chung planner is a Claude Code subagent that reads project code and breaks tasks into parallel subtasks with clear contracts. It does not write code; it prepares prompts for other subagents. CX Codex ★ 267repo stars gem-planner official github gem-planner is a GitHub Copilot and Claude Code subagent that creates structured development plans with assigned owners and acceptance criteria. It initializes during complex task planning to organize work into verifiable waves. CX Codex +1 ★ 41,430repo stars planner-identity-base microsoft planner-identity-base is a Claude Code rule that provides a shared scaffold for planning agents, with six sequential phases and persistent project state in JSON. CX Codex +1 ★ 1,627repo stars Orchestration Planner daffy0208 The Orchestration Planner skill turns a high-level goal into a checked workflow with ranked paths and fallbacks. It fits projects that keep capabilities in a graph. CX Codex +1 134installs screen-planner Microsoft screen-planner is a Microsoft subagent for Claude Code that designs mobile Power Apps structure, including screen graphs, navigation, components and specs. An orchestrator invokes it, not users directly. CX Codex ★ 1,167repo stars swarm-planner am-will swarm-planner is a Claude Code skill that maps implementation work into tasks with explicit dependencies for parallel agents. It runs only on direct invocation. CX Codex +1 1,200installs travel-planner travisjneuman travel-planner turns a trip idea into a day-by-day route with a budget breakdown and a packing list. Handy when you would otherwise build the spreadsheet yourself. CX Codex +1 526installs

From the same set76

The whole set →
project-board-sync project-board-sync — a command that keeps a GitHub Projects board in step with agent-swarm tasks: states, agent labels and priorities land in the right columns. CX Codex +1 ★ 850repo stars api-docs api-docs — a Claude Code subagent that inspects application endpoints to produce and maintain OpenAPI 3.0 specifications. CX Codex ★ 850repo stars examples The examples command presents pair-programming sessions for JWT auth, Node.js debugging, TDD, refactoring, React performance, and Express APIs. CX Codex +1 ★ 850repo stars base-template-generator base-template-generator writes the starting file set for a new component, endpoint or project config, then reuses templates that worked before. CX Codex ★ 850repo stars researcher The researcher subagent examines code, documentation, and module relationships, then organizes findings into a research summary. Use it to map an unfamiliar project or spot gaps in its docs. CX Codex ★ 850repo stars v3-integration-architect v3-integration-architect — a Claude subagent that carries out ADR-001: folding claude-flow into agentic-flow@alpha as an extension and cutting 10,000+ duplicated lines. CX Codex ★ 850repo stars sync-coordinator sync-coordinator aligns versions, dependencies, and docs across linked repositories. It orchestrates agent swarms using GitHub CLI and MCP tools. CX Codex +1 ★ 850repo stars architecture architecture designs system structure from specifications and pseudocode, covering components, interfaces, technology choices, and deployment. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open