Skip to main content
subagent CX Codex

planner · rohitg00 — Claude Code subagent: planning and setup

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.

MIT ★ 2,966 updated 2026-09-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Open on GitHub

What planner does

planner explores a project before code is written. It uses Read, Glob, and Grep to inspect relevant files, locate matching paths, and map the work that may need changes.

Its output covers the goal, files to modify, ordered steps, dependencies, complexity, risks, and open questions. The subagent must present the plan for approval and does not edit the repository. When requirements are unclear, it asks for clarification instead of choosing an interpretation.

In Claude Code, add the marketplace, install the plugin, then add .claude/agents/planner.md. The trigger covers work touching more than 5 files, architecture decisions, unclear requirements, or more than 10 expected tool calls. Because exploration is read-only, the agent will not change code during planning.

What it helps with

  • break a complex task into implementation steps
  • identify every file that may need changes
  • order dependencies before coding
  • surface risks and unresolved requirements

Example prompts for the agent

  • Ask the planner subagent to map this feature before any code changes.
  • Have planner inspect the repository and list the files and dependencies for this task.
  • Run planner first, then wait for plan approval before implementing the architecture change.

How to install planner

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Manually: 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 do I install planner in Claude Code?

Run /plugin marketplace add rohitg00/pro-workflow, then /plugin install pro-workflow@pro-workflow, and add .claude/agents/planner.md.

What does planner do?

It inspects the repository in read-only mode, identifies files, dependencies, work order, and risks, then presents a plan for approval before implementation.

Which tools does planner use?

The agent is configured with Read, Glob, and Grep. They let it inspect files and search the project without writing changes.

Source text

planner.md · MIT
---
name: planner
description: Break down complex tasks into implementation plans before writing code. Use when task touches >5 files, requires architecture decisions, or has unclear requirements.
tools: ["Read", "Glob", "Grep"]
omitClaudeMd: true
---

# Planner

Read-only task planner for complex work.

## Trigger

Use when multi-file changes, architecture decisions, unclear requirements, or >10 tool calls expected.

## Workflow

1. Understand the goal
2. Explore relevant code (read-only)
3. Identify all files to change
4. List dependencies and ordering
5. Estimate complexity
6. Present plan for approval

## Output

```
## Plan: [Task Name]

### Goal
[One sentence]

### Files to Modify
1. path/to/file.ts - [what changes]

### Approach
[Step by step]

### Risks
- [Potential issues]

### Questions
- [Clarifications needed]
```

## Rules

- Never make changes. Read-only exploration.
- Never skip approval step.
- Never assume requirements. Ask when unclear.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

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 ruvnet planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory. CX Codex ★ 850repo 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 negotiation-concession-planner Maya-Beth Finotti negotiation-concession-planner builds a pre-call concession plan: every lever priced by cost to you and value to the buyer, each give tied to a reciprocal get. CX Codex +1 33,400installs travel-planner ailabs-393 travel-planner — a skill that collects your travel preferences, then builds a day-by-day itinerary, budget breakdown, packing list and cultural notes for a destination. CX Codex +1 4,200installs breakout-trade-planner tradermonty breakout-trade-planner turns VCP screener output into Minervini-style trade plans with entry, stop and target levels, position sizing and Alpaca order templates. CX Codex +1 3,500installs liquidity-planner uniswap liquidity-planner plans Uniswap v2, v3, and v4 liquidity positions and creates pre-filled deep links for the web interface. CX Codex +1 1,300installs 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 swap-planner uniswap swap-planner gathers swap parameters, verifies token contracts on-chain and returns a deep link that opens Uniswap with the fields pre-filled. CX Codex +1 1,200installs

From the same set83

The whole set →
mcp-audit Audits active MCP servers, estimates token overhead from tool schemas, and flags unused integrations to disable. CX Codex +1 ★ 2,966repo stars auto-setup auto-setup detects a project’s stack and configures quality gates, permission rules, and hooks. Useful when bringing a new codebase into Claude Code. CX Codex +1 ★ 2,966repo stars compact-guard compact-guard is a Claude Code command that saves working state before context compaction and restores critical data afterward. Run it before manual compaction or when auto-compaction warnings appear. CX Codex +1 ★ 2,966repo stars wrap-up wrap-up audits git diffs, runs test suites, records lessons learned, and prepares context before closing a Claude Code session. CX Codex +1 ★ 2,966repo stars permission-tuner permission-tuner analyzes why Claude Code keeps prompting for permissions or denying operations, then generates rules to reduce confirmation fatigue. CX Codex +1 ★ 2,966repo stars list list displays stored patterns and rules from the pro-workflow database by recency, category, or project. CX Codex +1 ★ 2,966repo stars context-discipline The context-discipline rule sets limits for file reads, tool calls, and test-driven edits. It helps keep Claude Code from reopening unchanged files or polishing code after tests pass. CX Codex +1 ★ 2,966repo stars communication-style communication-style sets how Claude replies: short, no openers or praise, code before prose. Useful when agent answers drown in politeness. CX Codex +1 ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open