Files
Nexus/.claude/commands/automation/smart-agents.md
T
HartmutandClaude Sonnet 4.6 f80808482d chore: restore .claude commands, agents, helpers & skills (lost in 1df208d)
Restores the entire .claude/ infrastructure that was accidentally deleted
in commit 1df208d ('feat(timeline): add pulse animation for in-flight drag
mutations'). Recovered via git checkout 1df208d^.

Restored:
- .claude/commands/ (gitlooper, sparc/, github/, automation/, monitoring/,
  optimization/, hooks/, plan, implement, research, review, perf, visualaudit)
- .claude/agents/ (core/, github/, sparc/, v3/, swarm/, templates/, ...)
- .claude/helpers/ (41 scripts incl. hook-handler.cjs, statusline.cjs)
- .claude/skills/ (20 skills incl. sparc-methodology, github-*, v3-*)
- .claude/settings.json (hooks configuration)

Also updated all CapaKraken → Nexus references in affected command files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-08-15 11:43:52 +02:00

1.6 KiB

Smart Agent Auto-Spawning

Purpose

Automatically spawn the right agents at the right time without manual intervention.

Auto-Spawning Triggers

1. File Type Detection

When editing files, agents auto-spawn:

  • JavaScript/TypeScript: Coder agent
  • Markdown: Researcher agent
  • JSON/YAML: Analyst agent
  • Multiple files: Coordinator agent

2. Task Complexity

Simple task: "Fix typo"
→ Single coordinator agent

Complex task: "Implement OAuth with Google"
→ Architect + Coder + Tester + Researcher

3. Dynamic Scaling

The system monitors workload and spawns additional agents when:

  • Task queue grows
  • Complexity increases
  • Parallel opportunities exist

Status Monitoring:

// Check swarm health
mcp__claude -
  flow__swarm_status({
    swarmId: "current",
  });

// Monitor agent performance
mcp__claude -
  flow__agent_metrics({
    agentId: "agent-123",
  });

Configuration

MCP Tool Integration

Uses Claude Flow MCP tools for agent coordination:

// Initialize swarm with appropriate topology
mcp__claude -
  flow__swarm_init({
    topology: "mesh",
    maxAgents: 8,
    strategy: "auto",
  });

// Spawn agents based on file type
mcp__claude -
  flow__agent_spawn({
    type: "coder",
    name: "JavaScript Handler",
    capabilities: ["javascript", "typescript"],
  });

Fallback Configuration

If MCP tools are unavailable:

npx claude-flow hook pre-task --auto-spawn-agents

Benefits

  • 🤖 Zero manual agent management
  • 🎯 Perfect agent selection
  • 📈 Dynamic scaling
  • 💾 Resource efficiency