agent-organizer · qdhenry — Claude Code subagent: what it does, how to install
The agent-organizer subagent studies a project, chooses specialist agents, and plans their work. Use it when a task needs structured multi-agent coordination.
no license ★ 1,357 updated 2026-03-01
.claude/agents/agent-organizer.mdWhat agent-organizer does
agent-organizer examines the repository structure, technology stack, and task requirements before suggesting who should handle the work. It can identify suitable specialist agents, explain each choice, split a request into phases, and recommend sequential, parallel, or mixed execution. For ordinary tasks it favors a focused team of 3 agents; larger teams are reserved for work that spans several technical areas.
The subagent also maps technical risks, integration issues, and checks for the result. It verifies whether CLAUDE.md exists at the project root, reviews its currency and completeness, and points out documentation gaps. Its configuration names the haiku model and the tools Read, Write, Edit, Grep, Glob, Bash, and TodoWrite. It does not implement the solution or edit code itself, so the main process must carry out the recommended plan.
What it helps with
- inspect a project’s structure and tech stack
- extract requirements from a task and its documentation
- choose specialist agents for the work
- split a request into phases and dependencies
- identify risks and acceptance checks
Example prompts for the agent
- Analyze this project, identify its stack, and propose a team of specialist agents for the task.
- Break this request into phases, set the agent execution order, and explain each selection.
- Check
CLAUDE.mdagainst the current project and list the documentation gaps.
How to install agent-organizer
Manually: put the files in place
.claude/agents/agent-organizer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/agent-organizer.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/agent-organizer.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 agent-organizer
How do I install agent-organizer in Claude Code?
Place the subagent file at .claude/agents/agent-organizer.md.
What does agent-organizer do?
It studies the project and request, selects specialist agents, divides the work, and proposes an execution plan. It does not implement code itself.
How does agent-organizer handle CLAUDE.md?
It checks for the file at the project root, reviews its accuracy and completeness, and identifies gaps between the document and the project structure.
Similar subagents
All subagents for Agent setup: memory, context, orchestration →agent-organizer by other authors comes first.