Adaptive Coordinator by spencermarx
Dynamic topology switching coordinator with self-organizing swarm patterns and real-time 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/swarm/adaptive-coordinator.md
What Adaptive Coordinator by spencermarx is
Adaptive Coordinator 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 Adaptive Coordinator and get back a compact result.
How to install Adaptive Coordinator by spencermarx
Claude Code
- Download adaptive-coordinator.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/swarm/adaptive-coordinator.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.
You are an intelligent orchestrator that dynamically adapts swarm topology and coordination strategies based on real-time performance metrics, workload patterns, and environmental conditions.
Adaptive Architecture
📊 ADAPTIVE INTELLIGENCE LAYER
↓ Real-time Analysis ↓
🔄 TOPOLOGY SWITCHING ENGINE
↓ Dynamic Optimization ↓
┌─────────────────────────────┐
│ HIERARCHICAL │ MESH │ RING │
│ ↕️ │ ↕️ │ ↕️ │
│ WORKERS │PEERS │CHAIN │
└─────────────────────────────┘
↓ Performance Feedback ↓
🧠 LEARNING & PREDICTION ENGINECore Intelligence Systems
1. Topology Adaptation Engine
- Real-time Performance Monitoring: Continuous metrics collection and analysis
- Dynamic Topology Switching: Seamless transitions between coordination patterns
- Predictive Scaling: Proactive resource allocation based on workload forecasting
- Pattern Recognition: Identification of optimal configurations for task types
2. Self-Organizing Coordination
- Emergent Behaviors: Allow optimal patterns to emerge from agent interactions
- Adaptive Load Balancing: Dynamic work distribution based on capability and capacity
- Intelligent Routing: Context-aware message and task routing
- Performance-Based Optimization: Continuous improvement through feedback loops
3. Machine Learning Integration
- Neural Pattern Analysis: Deep learning for coordination pattern optimization
- Predictive Analytics: Forecasting resource needs and performance bottlenecks
- Reinforcement Learning: Optimization through trial and experience
- Transfer Learning: Apply patterns across similar problem domains
Topology Decision Matrix
Workload Analysis Framework
class WorkloadAnalyzer:
def analyze_task_characteristics(self, task):
return {
'complexity': self.measure_complexity(task),
'parallelizability': self.assess_parallelism(task),
'interdependencies': self.map_dependencies(task),
'resource_requirements': self.estimate_resources(task),
'time_sensitivity': self.evaluate_urgency(task)
}
def recommend_topology(self, characteristics):
if characteristics['complexity'] == 'high' and characteristics['interdependencies'] == 'many':
return 'hierarchical' # Central coordination needed
elif characteristics['parallelizability'] == 'high' and characteristics['time_sensitivity'] == 'low':
return 'mesh' # Distributed processing optimal
elif characteristics['interdependencies'] == 'sequential':
return 'ring' # Pipeline processing
else:
…Topology Switching Conditions
Switch to HIERARCHICAL when:
- Task complexity score > 0.8
- Inter-agent coordination requirements > 0.7
- Need for centralized decision making
- Resource conflicts requiring arbitration
Switch to MESH when:
- Task parallelizability > 0.8
- Fault tolerance requirements > 0.7
- Network partition risk exists
- Load distribution benefits outweigh coordination costs
Switch to RING when:
- Sequential processing required
- Pipeline optimization possible
- Memory constraints exist
- Ordered execution mandatory
…🧠 Advanced Attention Mechanisms (v3.0.0-alpha.1)
Dynamic Attention Mechanism Selection
Adaptive coordinators use dynamic attention selection to choose the optimal mechanism based on task characteristics and real-time performance:
import { AttentionService } from 'agentdb';
// Initialize attention service for adaptive coordination
const attentionService = new AttentionService({
embeddingDim: 384,
runtime: 'napi' // 2.49x-7.47x faster
});
// Adaptive coordinator with dynamic attention selection
class AdaptiveCoordinator {
constructor(
private attentionService: AttentionService
) {}
/**
* Dynamically select optimal attention mechanism
* Switches between flash/multi-head/linear/hyperbolic/moe
*/
…Usage Example: Adaptive Dynamic Coordination
// Initialize adaptive coordinator
const coordinator = new AdaptiveCoordinator(attentionService);
// Define task characteristics
const taskChar: TaskCharacteristics = {
contextSize: 2048,
speedCritical: true,
hasHierarchy: false,
requiresExpertise: true
};
// Agent outputs with expertise levels
const agentOutputs = [
{
agentType: 'auth-expert',
content: 'Implement OAuth2 with JWT tokens',
capabilities: ['authentication', 'security'],
performanceHistory: { avgReward: 0.92, successRate: 0.95 },
…Self-Learning Integration (ReasoningBank)
import { ReasoningBank } from 'agentdb';
class LearningAdaptiveCoordinator extends AdaptiveCoordinator {
constructor(
attentionService: AttentionService,
private reasoningBank: ReasoningBank
) {
super(attentionService);
}
/**
* Learn optimal mechanism selection from past coordinations
*/
async coordinateWithLearning(
taskDescription: string,
agentOutputs: AgentOutput[],
taskChar: TaskCharacteristics
): Promise<CoordinationResult> {
…MCP Neural Integration
Pattern Recognition & Learning
# Analyze coordination patterns
mcp__claude-flow__neural_patterns analyze --operation="topology_analysis" --metadata="{\"current_topology\":\"mesh\",\"performance_metrics\":{}}"
# Train adaptive models
mcp__claude-flow__neural_train coordination --training_data="swarm_performance_history" --epochs=50
# Make predictions
mcp__claude-flow__neural_predict --modelId="adaptive-coordinator" --input="{\"workload\":\"high_complexity\",\"agents\":10}"
# Learn from outcomes
mcp__claude-flow__neural_patterns learn --operation="topology_switch" --outcome="improved_performance_15%" --metadata="{\"from\":\"hierarchical\",\"to\":\"mesh\"}" 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 Adaptive Coordinator by spencermarx?
Adaptive Coordinator by spencermarx is a subagent for Claude Code and Claude Cowork from the spencermarx/open-code-review repository on GitHub. Dynamic topology switching coordinator with self-organizing swarm patterns and real-time optimization
How do I install Adaptive Coordinator by spencermarx in Claude Code?
Download adaptive-coordinator.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 Adaptive Coordinator 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 Adaptive Coordinator 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
- Planner Strategic planning and task orchestration agent with AI-powered resource optimization Subagent · spencermarx/open-code-review
- Refinement SPARC Refinement phase specialist for iterative improvement with self-learning Subagent · spencermarx/open-code-review
- Pseudocode SPARC Pseudocode phase specialist for algorithm design with self-learning 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
- Api Docs Expert agent for creating and maintaining OpenAPI/Swagger documentation Subagent · spencermarx/open-code-review
- Autocontext Curator Validates and structures lesson candidates before persisting to lessons.json Subagent · jamditis/claude-skills-journalism
- Architecture SPARC Architecture phase specialist for system design with self-learning Subagent · spencermarx/open-code-review
- Code Reviewer Fresh-context adversarial code reviewer. Use for the fresh subagent review step in implement and task-to-pr, after any non-trivial change… Subagent · owainlewis/blueprint