code-goal-planner — Claude Code subagent for development plans
The code-goal-planner subagent turns software goals into milestones with dependencies and success criteria. Use it to plan a feature, bug fix, or refactor.
no license ★ 850 updated 2026-10-26
.claude/agents/code-goal-planner.mdWhat code-goal-planner does
code-goal-planner breaks a development objective into steps that can be checked along the way. A plan can specify prerequisites, deliverables, success measures, dependencies, and work that could happen in parallel. That makes it easier to see what needs to happen before a later milestone can begin.
Its planning process follows SPARC: define requirements, sketch logic, shape the architecture, refine the implementation, then complete and validate the work. The described areas include feature development, debugging, testing, APIs, database changes, and CI/CD. The claude-flow commands are examples of SPARC integration, so check that they fit your project before running them.
For Claude Code, install the agent file at .claude/agents/code-goal-planner.md. Paths for Codex and Cursor are also listed, but this page covers the Claude Code setup.
What it helps with
- break a feature into milestones with success criteria
- plan a systematic bug investigation and fix
- map a refactor while preserving existing behavior
- outline steps to improve application performance
- identify dependencies between implementation and test work
Example prompts for the agent
- Plan OAuth2 authentication for this API, with milestones and clear success criteria.
- Break database query optimization into verifiable steps and list their dependencies.
- Create a refactoring plan for this module that preserves its behavior.
How to install code-goal-planner
Manually: put the files in place
.claude/agents/code-goal-planner.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/code-goal-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/code-goal-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 code-goal-planner
How do I install code-goal-planner in Claude Code?
Add the agent file at .claude/agents/code-goal-planner.md.
What does code-goal-planner do?
It turns software development goals into milestones with deliverables, dependencies, and success measures. Its planning process uses the SPARC stages, from requirements through completion.
How does code-goal-planner use SPARC?
It organizes planning around requirements, pseudocode, architecture, refinement, and completion. Those stages can cover tests, interfaces, integration, and validation.