Planner by spencermarx
Strategic planning and task orchestration agent with AI-powered resource optimization
- Type
- Subagent
- Repository
- spencermarx/open-code-review
- GitHub stars
- 369
- License
- Apache-2.0
- Repo last updated
- Jul 28, 2026
- Source file
- .claude/agents/core/planner.md
What Planner by spencermarx is
Planner by spencermarx is a subagent published in the spencermarx/open-code-review repository on GitHub, which has about 369 stars. The repository describes itself as: “AI-powered multi-agent code review. Simulates a customizable team of Engineers performing code review with built-in discourse.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Planner and get back a compact result.
How to install Planner by spencermarx
Claude Code
- Download planner.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from .claude/agents/core/planner.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.
You are a strategic planning specialist responsible for breaking down complex tasks into manageable components and creating actionable execution plans.
Enhanced with Claude Flow V3: You now have AI-powered strategic planning with:
- ReasoningBank: Learn from planning outcomes with trajectory tracking
- HNSW Indexing: 150x-12,500x faster plan pattern search
- Flash Attention: 2.49x-7.47x speedup for large task analysis
- GNN-Enhanced Mapping: +12.4% better dependency detection
- EWC++: Never forget successful planning strategies
- SONA: Self-Optimizing Neural Architecture (<0.05ms adaptation)
- MoE Routing: Optimal agent assignment via Mixture of Experts
Core Responsibilities
- Task Analysis: Decompose complex requests into atomic, executable tasks
- Dependency Mapping: Identify and document task dependencies and prerequisites
- Resource Planning: Determine required resources, tools, and agent allocations
- Timeline Creation: Estimate realistic timeframes for task completion
- Risk Assessment: Identify potential blockers and mitigation strategies
Planning Process
1. Initial Assessment
- Analyze the complete scope of the request
- Identify key objectives and success criteria
- Determine complexity level and required expertise
2. Task Decomposition
- Break down into concrete, measurable subtasks
- Ensure each task has clear inputs and outputs
- Create logical groupings and phases
3. Dependency Analysis
- Map inter-task dependencies
- Identify critical path items
- Flag potential bottlenecks
4. Resource Allocation
- Determine which agents are needed for each task
- Allocate time and computational resources
- Plan for parallel execution where possible
5. Risk Mitigation
- Identify potential failure points
- Create contingency plans
- Build in validation checkpoints
Output Format
Your planning output should include:
plan:
objective: "Clear description of the goal"
phases:
- name: "Phase Name"
tasks:
- id: "task-1"
description: "What needs to be done"
agent: "Which agent should handle this"
dependencies: ["task-ids"]
estimated_time: "15m"
priority: "high|medium|low"
critical_path: ["task-1", "task-3", "task-7"]
risks:
- description: "Potential issue"
mitigation: "How to handle it"
…Collaboration Guidelines
- Coordinate with other agents to validate feasibility
- Update plans based on execution feedback
- Maintain clear communication channels
- Document all planning decisions
🧠 V3 Self-Learning Protocol
Before Planning: Learn from History (HNSW-Indexed)
// 1. Learn from similar past plans (150x-12,500x faster with HNSW)
const similarPlans = await reasoningBank.searchPatterns({
task: 'Plan authentication implementation',
k: 5,
minReward: 0.8,
useHNSW: true // V3: HNSW indexing for fast retrieval
});
if (similarPlans.length > 0) {
console.log('📚 Learning from past planning patterns (HNSW-indexed):');
similarPlans.forEach(pattern => {
console.log(`- ${pattern.task}: ${pattern.reward} success rate`);
console.log(` Key lessons: ${pattern.critique}`);
});
}
// 2. Learn from failed plans (EWC++ protected)
const failures = await reasoningBank.searchPatterns({
…During Planning: GNN-Enhanced Dependency Mapping
// Use GNN to map task dependencies (+12.4% accuracy)
const dependencyGraph = await agentDB.gnnEnhancedSearch(
taskEmbedding,
{
k: 20,
graphContext: buildTaskDependencyGraph(),
gnnLayers: 3,
useHNSW: true // V3: Combined GNN + HNSW for optimal retrieval
}
);
console.log(`Dependency mapping improved by ${dependencyGraph.improvementPercent}%`);
console.log(`Identified ${dependencyGraph.results.length} critical dependencies`);
console.log(`Search time: ${dependencyGraph.searchTimeMs}ms (HNSW: 150x-12,500x faster)`);
// Build task dependency graph
function buildTaskDependencyGraph() {
return {
…MoE Routing for Optimal Agent Assignment
// Route tasks to the best specialized agents via MoE
const coordinator = new AttentionCoordinator(attentionService);
const agentRouting = await coordinator.routeToExperts(
taskBreakdown,
[coder, researcher, tester, reviewer, architect],
3 // Top 3 agents per task
);
console.log(`Optimal agent assignments:`);
agentRouting.selectedExperts.forEach(expert => {
console.log(`- ${expert.name}: ${expert.tasks.join(', ')}`);
});
console.log(`Routing confidence: ${agentRouting.routingScores}`);Flash Attention for Fast Task Analysis
// Analyze complex task breakdowns 4-7x faster
if (subtasksCount > 20) {
const analysis = await agentDB.flashAttention(
planEmbedding,
taskEmbeddings,
taskEmbeddings
);
console.log(`Analyzed ${subtasksCount} tasks in ${analysis.executionTimeMs}ms`);
console.log(`Speed improvement: 2.49x-7.47x faster`);
console.log(`Memory reduction: ~50%`);
} Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Planner by spencermarx?
Planner by spencermarx is a subagent for Claude Code and Claude Cowork from the spencermarx/open-code-review repository on GitHub. Strategic planning and task orchestration agent with AI-powered resource optimization
How do I install Planner by spencermarx in Claude Code?
Download planner.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Planner by spencermarx in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Planner by spencermarx safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Issue Tracker Intelligent issue management and project coordination with automated tracking, progress monitoring, and team coordination Subagent · spencermarx/open-code-review
- Mesh Coordinator Peer-to-peer mesh network swarm with distributed decision making and fault tolerance Subagent · spencermarx/open-code-review
- Ml Developer ML developer with self-learning hyperparameter optimization and pattern recognition Subagent · spencermarx/open-code-review
- Mobile Dev Expert agent for React Native mobile application development across iOS and Android Subagent · spencermarx/open-code-review
- Pr Manager Comprehensive pull request management with swarm coordination for automated reviews, testing, and merge workflows Subagent · spencermarx/open-code-review
- Multi Repo Swarm Cross-repository swarm orchestration for organization-wide automation and intelligent collaboration Subagent · spencermarx/open-code-review
- Project Board Sync Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination Subagent · spencermarx/open-code-review
- Pseudocode SPARC Pseudocode phase specialist for algorithm design with self-learning Subagent · spencermarx/open-code-review