Sponsor Suno AI Music arrow_forward
Subagent

Adaptive Coordinator by spencermarx

Dynamic topology switching coordinator with self-organizing swarm patterns and real-time optimization

Type
Subagent
GitHub stars
369
License
Apache-2.0
Repo last updated
Jul 28, 2026

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

  1. Download adaptive-coordinator.md from the repository.
  2. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
  3. 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

  1. 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.
  2. 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 ENGINE

Core 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

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under Apache-2.0. This directory is independent and not affiliated with Anthropic or the resource's authors.