# sublinear-goal-planner

sublinear-goal-planner — a Claude subagent that breaks a big goal into actions with dependencies and looks for the cheapest route through the action graph.

- 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/agent.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/sublinear-goal-planner

## What it does

Hand it a goal and it returns a graph: subgoals, what blocks what, and the actions that carry the world state from where it sits now to where you want it. Every action has a cost, and the route is priced through matrix work on the `sublinear-time-solver` MCP server.

Five things happen inside. Goal decomposition, sequence optimisation, ranking by PageRank, prediction of future states, and coordination of several agents through `flow-nexus` (`swarm_init`, `task_orchestrate`, `agent_spawn`, `workflow_create`, `sandbox_create`). The description models state as flags such as `code_written` and `tests_passing`, with transitions weighted by inverse cost.

Both MCP servers have to be connected first. The tool list is `mcp__sublinear-time-solver__*` and `mcp__flow-nexus__*` calls, so with the servers absent there is nothing to run the plan on.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/agent.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/agent.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/agent.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/agent.md

## When to use it
- break a large goal into steps with real dependencies
- rank work when there is more of it than time
- price alternative routes to the same result
- split one objective across several agents
- replan when conditions shift mid-flight

## Example prompts
- Use sublinear-goal-planner to plan the `v2.0` release: steps, order, and what blocks what.
- Model the move to PostgreSQL as actions with costs and preconditions, then find the cheapest path.
- Build the action graph for the launch and rank the steps with PageRank.

## Similar
- [goal-plan](https://affpapa.org/en/nevibecode/skills/goal-plan.md) — skill · 771 installs
- [financial-goal-planner](https://affpapa.org/en/nevibecode/skills/financial-goal-planner.md) — skill · 373 installs
- [plannotator-setup-goal](https://affpapa.org/en/nevibecode/skills/plannotator-setup-goal.md) — skill · 13600 installs
- [plan-goal](https://affpapa.org/en/nevibecode/commands/plan-goal.md) — command · ★ 28179 repo stars
- [goal-setting-okrs](https://affpapa.org/en/nevibecode/skills/goal-setting-okrs.md) — skill · 538 installs
- [swarm-planner](https://affpapa.org/en/nevibecode/skills/swarm-planner.md) — skill · 1200 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
