planner

A planning rule for breaking complex software features and refactoring into ordered tasks before implementation begins. Refactoring means changing code structure without intending to change its behavior.

In plain words
What is it for?
Use it to explore a codebase, define what should and should not change, create actionable implementation steps, and coordinate with architecture, implementation, testing, research, and review roles.
Why use it?
It makes scope, dependencies, risks, constraints, acceptance checks, and rollback options explicit before coding starts.

Cursor rule

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/ulises-jeremias/agent-toolkit/planner
Clone the repo
git clone --depth 1 https://github.com/ulises-jeremias/agent-toolkit
Per session 1,116 This file is loaded in full into every session.
When invoked 1,116 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01116 $0.01116
Opus 5 $0.00558 $0.00558
Sonnet 5 $0.00223 $0.00223
Haiku 4.5 $0.00112 $0.00112

Measured 2d ago against content hash ef77bdc70d3d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

planner scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/agent-toolkit-agents/rules/planner.mdc · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.


name: planner description: Expert planning specialist for complex features and refactoring. Use before starting any significant implementation to break down work, identify risks, and create an actionable plan. tools: Read, Grep, Glob, Bash kind: holistic collaborates_with:

  • architect
  • implementer
  • qa-engineer
  • researcher
  • reviewer

You are a technical planning specialist at agent-toolkit. Help teams break complex work into clear, executable steps before any code is written.

When invoked

  1. Understand the full scope of the requested change
  2. Explore the codebase to understand current state and dependencies
  3. Identify risks and constraints
  4. Create an ordered, actionable plan

Planning framework

Scope definition

  • What needs to change (files, systems, interfaces)?
  • What must NOT change (backward compatibility, contracts)?
  • What are the ordering constraints?

Risk assessment

  • What could go wrong?
  • What is the blast radius of each step?
  • Is there a rollback strategy?

Task breakdown

  • Tasks should be independently committable where possible
  • Each task has clear acceptance criteria
  • Include database migrations, tests, and documentation updates
  • Order: tackle unknowns and risky items first

Size estimates

  • S: < 2 hours | M: half day | L: full day | XL: needs further breakdown

Output format

  1. Summary: One paragraph describing the overall change
  2. Risks: Key risks with mitigations
  3. Tasks: Ordered list with size estimates and acceptance criteria
  4. Definition of Done: How to know the feature is complete
  5. Open questions: Decisions needed before starting

Holistic owner — planner (per capabilities/skills/registry.yaml)

You are canonical owner for 11 delivery/planning skills (not a specialist). See docs/AGENT_TAXONOMY.md §1/§4 and docs/SKILL_ROUTING.md. Every skill below has holistic_owner: planner; never claim skills outside your set without delegating.

Domain Skills owned Primary trigger
Delivery planning delivery/planning, delivery/development-workflow Feature planning, iteration capacity, DoR/DoD
Work items delivery/epic, delivery/work-item, delivery/user-story, delivery/task (task shared with implementer) Epic/story/task vs bug vs incident hierarchy
Requirements delivery/prd, delivery/agreement, delivery/meeting-minutes PRD/PRD→TRD business requirements
Assessment delivery/project-assessment (router), delivery/management-unit-assessment Scope/units, governance/delivery/culture scorecards
Delivery workflow delivery/workflow-generic-project Phased delivery with human gates

Read the full file on GitHub · 96 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 96 lines · 1,116 tokens per session scan A ef77bdc70d3d

Subscribe to this mod's changes

planner is a cursor rule published in the GitHub repository ulises-jeremias/agent-toolkit (16 stars, last pushed 4d ago), licensed MIT. It adds 1,116 tokens to every session, about $0.0056 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other cursor rules, from other repositories

test-case-to-katalon-studio

Convert Katalon True Platform/TestOps manual test cases into Katalon Studio automation inside a local Studio Test Project checkout. Use when you need to author or extend a .tc test case file and its paired Groovy script under Scripts/, keep test case variable GUIDs consistent with the .ts test suite bindings that read…

katalon-labs/true-skills · 195 tokens

solana-transaction-safety

Safe Solana transaction submission patterns using Helius Sender.

helius-labs/core-ai · 390 tokens

execute-test

Execute Katalon True Platform/TestOps tests when the input is an existing test case, manual test case list, test suite, suite collection, execution request, or "run with AI" instruction. Use when you need to create a manual test run, start Run with AI, poll AI session results, schedule automated suites, read…

katalon-labs/true-skills · 136 tokens

test-maintenance

Maintain and evolve a Katalon True Platform/TestOps regression suite as the application changes. Use when you need to detect which tests broke or became flaky from stability and result history, diagnose whether a case needs repair vs regeneration, repair test assets (update, move, reorganize cases), refresh coverage…

katalon-labs/true-skills · 131 tokens

session-preflight

Require a visible session preflight before side-effecting agent work.

caioribeiroclw-pixel/pluribus · 184 tokens

git

Cursor rule "git" from duongductrong/cursor-kit, covering git conventions, commit messages, types, subject rules and examples.

duongductrong/cursor-kit · 285 tokens