# code-goal-planner

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/goal/code-goal-planner.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/code-goal-planner

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/code-goal-planner.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/code-goal-planner.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/code-goal-planner.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/goal/code-goal-planner.md

## When to use it
- 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
- 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.

## Similar
- [sparc-refine](https://affpapa.org/en/nevibecode/skills/sparc-refine.md) — skill · 730 installs
- [financial-goal-planner](https://affpapa.org/en/nevibecode/skills/financial-goal-planner.md) — skill · 373 installs
- [define-goal](https://affpapa.org/en/nevibecode/skills/define-goal.md) — skill · 3100 installs
- [MantleKit Launch Planner](https://affpapa.org/en/nevibecode/mcp/mantlekit-launch-planner.md) — MCP server · 632 installs
- [work-planner](https://affpapa.org/en/nevibecode/agents/work-planner.md) — subagent · ★ 720 repo stars
- [qa-test-planner](https://affpapa.org/en/nevibecode/skills/qa-test-planner.md) — skill · 4400 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
