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>
90 lines
1.6 KiB
Markdown
90 lines
1.6 KiB
Markdown
# 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:**
|
|
|
|
```javascript
|
|
// 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:
|
|
|
|
```javascript
|
|
// 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:
|
|
|
|
```bash
|
|
npx claude-flow hook pre-task --auto-spawn-agents
|
|
```
|
|
|
|
## Benefits
|
|
|
|
- 🤖 Zero manual agent management
|
|
- 🎯 Perfect agent selection
|
|
- 📈 Dynamic scaling
|
|
- 💾 Resource efficiency
|