@claude-flow/cli 3.42.1 → 3.42.3

package/.claude/commands/agents/pool.md

@@ -1,127 +1,127 @@
----
-name: pool
-description: Manage agent pool for scaling
-type: command
----
-
-# Agent Pool Command
-
-Manage the agent pool for automatic scaling and resource optimization.
-
-## Usage
-
-```bash
-npx @claude-flow/cli@latest agent pool [options]
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--size` | `-s` | Set pool size | Current |
-| `--min` | | Minimum pool size | 1 |
-| `--max` | | Maximum pool size | 10 |
-| `--auto-scale` | | Enable auto-scaling | true |
-| `--warmup` | | Pre-warm agents | false |
-
-## Examples
-
-```bash
-# View current pool status
-npx @claude-flow/cli@latest agent pool
-
-# Set pool size
-npx @claude-flow/cli@latest agent pool --size 5
-
-# Configure auto-scaling
-npx @claude-flow/cli@latest agent pool --min 2 --max 15 --auto-scale
-
-# Pre-warm agents for fast response
-npx @claude-flow/cli@latest agent pool --warmup
-
-# Disable auto-scaling
-npx @claude-flow/cli@latest agent pool --auto-scale false
-```
-
-## Output
-
-```
-Agent Pool Configuration
-
-+----------------+----------+
-| Setting        | Value    |
-+----------------+----------+
-| Current Size   | 3        |
-| Min Size       | 1        |
-| Max Size       | 10       |
-| Auto-Scale     | enabled  |
-| Warmup         | disabled |
-+----------------+----------+
-
-Pool Status
-+------------+--------+------+-------+
-| Type       | Active | Idle | Total |
-+------------+--------+------+-------+
-| coder      | 1      | 1    | 2     |
-| researcher | 1      | 0    | 1     |
-+------------+--------+------+-------+
-
-Auto-Scale Rules
-  - Scale up when: Queue > 5 tasks
-  - Scale down when: Idle > 5 minutes
-  - Cooldown: 60 seconds
-```
-
-## Auto-Scaling Behavior
-
-### Scale Up Triggers
-- Task queue exceeds threshold
-- Response time increases
-- Error rate increases
-
-### Scale Down Triggers
-- Agents idle for extended period
-- Task queue empty
-- Resource pressure
-
-## Pre-Warming
-
-Pre-warm agents to reduce cold-start latency:
-
-```bash
-npx @claude-flow/cli@latest agent pool --warmup
-
-# Pre-warms default agent types:
-# - coder (2 instances)
-# - researcher (1 instance)
-# - tester (1 instance)
-```
-
-## Pool Configuration File
-
-Configure in `.claude-flow/config.yaml`:
-
-```yaml
-agent:
-  pool:
-    minSize: 2
-    maxSize: 15
-    autoScale: true
-    warmup:
-      enabled: true
-      types:
-        - type: coder
-          count: 2
-        - type: researcher
-          count: 1
-    scaleRules:
-      scaleUpThreshold: 5
-      scaleDownIdleTime: 300
-      cooldownPeriod: 60
-```
-
-## Related Commands
-
-- `npx @claude-flow/cli@latest agent spawn` - Manual agent spawning
-- `npx @claude-flow/cli@latest agent list` - View active agents
-- `npx @claude-flow/cli@latest swarm scale` - Swarm-level scaling
+---
+name: pool
+description: Manage agent pool for scaling
+type: command
+---
+
+# Agent Pool Command
+
+Manage the agent pool for automatic scaling and resource optimization.
+
+## Usage
+
+```bash
+npx @claude-flow/cli@latest agent pool [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--size` | `-s` | Set pool size | Current |
+| `--min` | | Minimum pool size | 1 |
+| `--max` | | Maximum pool size | 10 |
+| `--auto-scale` | | Enable auto-scaling | true |
+| `--warmup` | | Pre-warm agents | false |
+
+## Examples
+
+```bash
+# View current pool status
+npx @claude-flow/cli@latest agent pool
+
+# Set pool size
+npx @claude-flow/cli@latest agent pool --size 5
+
+# Configure auto-scaling
+npx @claude-flow/cli@latest agent pool --min 2 --max 15 --auto-scale
+
+# Pre-warm agents for fast response
+npx @claude-flow/cli@latest agent pool --warmup
+
+# Disable auto-scaling
+npx @claude-flow/cli@latest agent pool --auto-scale false
+```
+
+## Output
+
+```
+Agent Pool Configuration
+
++----------------+----------+
+| Setting        | Value    |
++----------------+----------+
+| Current Size   | 3        |
+| Min Size       | 1        |
+| Max Size       | 10       |
+| Auto-Scale     | enabled  |
+| Warmup         | disabled |
++----------------+----------+
+
+Pool Status
++------------+--------+------+-------+
+| Type       | Active | Idle | Total |
++------------+--------+------+-------+
+| coder      | 1      | 1    | 2     |
+| researcher | 1      | 0    | 1     |
++------------+--------+------+-------+
+
+Auto-Scale Rules
+  - Scale up when: Queue > 5 tasks
+  - Scale down when: Idle > 5 minutes
+  - Cooldown: 60 seconds
+```
+
+## Auto-Scaling Behavior
+
+### Scale Up Triggers
+- Task queue exceeds threshold
+- Response time increases
+- Error rate increases
+
+### Scale Down Triggers
+- Agents idle for extended period
+- Task queue empty
+- Resource pressure
+
+## Pre-Warming
+
+Pre-warm agents to reduce cold-start latency:
+
+```bash
+npx @claude-flow/cli@latest agent pool --warmup
+
+# Pre-warms default agent types:
+# - coder (2 instances)
+# - researcher (1 instance)
+# - tester (1 instance)
+```
+
+## Pool Configuration File
+
+Configure in `.claude-flow/config.yaml`:
+
+```yaml
+agent:
+  pool:
+    minSize: 2
+    maxSize: 15
+    autoScale: true
+    warmup:
+      enabled: true
+      types:
+        - type: coder
+          count: 2
+        - type: researcher
+          count: 1
+    scaleRules:
+      scaleUpThreshold: 5
+      scaleDownIdleTime: 300
+      cooldownPeriod: 60
+```
+
+## Related Commands
+
+- `npx @claude-flow/cli@latest agent spawn` - Manual agent spawning
+- `npx @claude-flow/cli@latest agent list` - View active agents
+- `npx @claude-flow/cli@latest swarm scale` - Swarm-level scaling

package/.claude/commands/agents/spawn.md

@@ -1,140 +1,140 @@
----
-name: spawn
-description: Spawn a new agent with V3 capabilities
-type: command
----
-
-# Agent Spawn Command
-
-Spawn a new agent with full V3 capabilities including neural patterns, memory integration, and swarm coordination.
-
-## Usage
-
-```bash
-npx @claude-flow/cli@latest agent spawn [options]
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--type` | `-t` | Agent type to spawn | Required |
-| `--name` | `-n` | Agent name/identifier | Auto-generated |
-| `--provider` | `-p` | AI provider (anthropic, openrouter, ollama) | anthropic |
-| `--model` | `-m` | Model to use | Provider default |
-| `--task` | | Initial task for the agent | None |
-| `--timeout` | | Agent timeout in seconds | 300 |
-| `--auto-tools` | | Enable automatic tool usage | true |
-
-## Agent Types (87 Available)
-
-### Core Development
-```bash
-npx @claude-flow/cli@latest agent spawn -t coder      # Code implementation
-npx @claude-flow/cli@latest agent spawn -t reviewer   # Code review
-npx @claude-flow/cli@latest agent spawn -t tester     # Testing
-npx @claude-flow/cli@latest agent spawn -t planner    # Planning
-npx @claude-flow/cli@latest agent spawn -t researcher # Research
-```
-
-### V3 Specialized
-```bash
-npx @claude-flow/cli@latest agent spawn -t security-architect     # Security design
-npx @claude-flow/cli@latest agent spawn -t security-auditor       # CVE remediation
-npx @claude-flow/cli@latest agent spawn -t memory-specialist      # AgentDB (150x-12,500x faster)
-npx @claude-flow/cli@latest agent spawn -t performance-engineer   # 2.49x-7.47x optimization
-npx @claude-flow/cli@latest agent spawn -t core-architect         # DDD design
-```
-
-### Swarm Coordination
-```bash
-npx @claude-flow/cli@latest agent spawn -t hierarchical-coordinator  # Queen-led
-npx @claude-flow/cli@latest agent spawn -t mesh-coordinator          # P2P network
-npx @claude-flow/cli@latest agent spawn -t adaptive-coordinator      # Dynamic topology
-npx @claude-flow/cli@latest agent spawn -t collective-intelligence-coordinator
-```
-
-### Consensus Agents
-```bash
-npx @claude-flow/cli@latest agent spawn -t byzantine-coordinator  # BFT consensus
-npx @claude-flow/cli@latest agent spawn -t raft-manager          # Leader-based
-npx @claude-flow/cli@latest agent spawn -t gossip-coordinator    # Eventual consistency
-npx @claude-flow/cli@latest agent spawn -t crdt-synchronizer     # CRDT replication
-npx @claude-flow/cli@latest agent spawn -t quorum-manager        # Quorum-based
-```
-
-### GitHub Integration
-```bash
-npx @claude-flow/cli@latest agent spawn -t pr-manager           # PR lifecycle
-npx @claude-flow/cli@latest agent spawn -t code-review-swarm    # Multi-agent review
-npx @claude-flow/cli@latest agent spawn -t issue-tracker        # Issue management
-npx @claude-flow/cli@latest agent spawn -t release-manager      # Release coordination
-npx @claude-flow/cli@latest agent spawn -t workflow-automation  # CI/CD automation
-```
-
-### SPARC Methodology
-```bash
-npx @claude-flow/cli@latest agent spawn -t sparc-coordinator    # SPARC orchestration
-npx @claude-flow/cli@latest agent spawn -t specification        # Requirements
-npx @claude-flow/cli@latest agent spawn -t pseudocode          # Algorithm design
-npx @claude-flow/cli@latest agent spawn -t architecture        # System design
-npx @claude-flow/cli@latest agent spawn -t refinement          # Iterative improvement
-```
-
-## Examples
-
-```bash
-# Spawn with custom name
-npx @claude-flow/cli@latest agent spawn -t coder --name feature-bot
-
-# Spawn with initial task
-npx @claude-flow/cli@latest agent spawn -t researcher --task "Research React 19 features"
-
-# Spawn with specific model
-npx @claude-flow/cli@latest agent spawn -t architect -m claude-3-opus-20240229
-
-# Spawn with custom timeout
-npx @claude-flow/cli@latest agent spawn -t tester --timeout 600
-
-# Spawn using OpenRouter
-npx @claude-flow/cli@latest agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
-```
-
-## Using Claude Code's Task Tool
-
-For actual execution, always use Claude Code's Task tool:
-
-```javascript
-// Spawn ALL agents in ONE message for parallel execution
-Task("Coder", "Implement authentication feature", "coder")
-Task("Tester", "Write unit tests for auth", "tester")
-Task("Reviewer", "Review auth implementation", "reviewer")
-```
-
-## MCP Coordination (Optional)
-
-Use MCP tools only for swarm coordination setup:
-
-```javascript
-mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 15 })
-mcp__claude-flow__agent_spawn({ type: "coordinator", name: "queen" })
-```
-
-## Output
-
-```
-Spawning coder agent: feature-bot
-
-+-----------+----------------------------------+
-| Property  | Value                            |
-+-----------+----------------------------------+
-| ID        | coder-lx7m9k2                    |
-| Type      | coder                            |
-| Name      | feature-bot                      |
-| Status    | active                           |
-| Created   | 2026-01-08T03:30:00.000Z         |
-| Capabilities | code, debug, refactor, test   |
-+-----------+----------------------------------+
-
-Agent feature-bot spawned successfully
-```
+---
+name: spawn
+description: Spawn a new agent with V3 capabilities
+type: command
+---
+
+# Agent Spawn Command
+
+Spawn a new agent with full V3 capabilities including neural patterns, memory integration, and swarm coordination.
+
+## Usage
+
+```bash
+npx @claude-flow/cli@latest agent spawn [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--type` | `-t` | Agent type to spawn | Required |
+| `--name` | `-n` | Agent name/identifier | Auto-generated |
+| `--provider` | `-p` | AI provider (anthropic, openrouter, ollama) | anthropic |
+| `--model` | `-m` | Model to use | Provider default |
+| `--task` | | Initial task for the agent | None |
+| `--timeout` | | Agent timeout in seconds | 300 |
+| `--auto-tools` | | Enable automatic tool usage | true |
+
+## Agent Types (87 Available)
+
+### Core Development
+```bash
+npx @claude-flow/cli@latest agent spawn -t coder      # Code implementation
+npx @claude-flow/cli@latest agent spawn -t reviewer   # Code review
+npx @claude-flow/cli@latest agent spawn -t tester     # Testing
+npx @claude-flow/cli@latest agent spawn -t planner    # Planning
+npx @claude-flow/cli@latest agent spawn -t researcher # Research
+```
+
+### V3 Specialized
+```bash
+npx @claude-flow/cli@latest agent spawn -t security-architect     # Security design
+npx @claude-flow/cli@latest agent spawn -t security-auditor       # CVE remediation
+npx @claude-flow/cli@latest agent spawn -t memory-specialist      # AgentDB (150x-12,500x faster)
+npx @claude-flow/cli@latest agent spawn -t performance-engineer   # 2.49x-7.47x optimization
+npx @claude-flow/cli@latest agent spawn -t core-architect         # DDD design
+```
+
+### Swarm Coordination
+```bash
+npx @claude-flow/cli@latest agent spawn -t hierarchical-coordinator  # Queen-led
+npx @claude-flow/cli@latest agent spawn -t mesh-coordinator          # P2P network
+npx @claude-flow/cli@latest agent spawn -t adaptive-coordinator      # Dynamic topology
+npx @claude-flow/cli@latest agent spawn -t collective-intelligence-coordinator
+```
+
+### Consensus Agents
+```bash
+npx @claude-flow/cli@latest agent spawn -t byzantine-coordinator  # BFT consensus
+npx @claude-flow/cli@latest agent spawn -t raft-manager          # Leader-based
+npx @claude-flow/cli@latest agent spawn -t gossip-coordinator    # Eventual consistency
+npx @claude-flow/cli@latest agent spawn -t crdt-synchronizer     # CRDT replication
+npx @claude-flow/cli@latest agent spawn -t quorum-manager        # Quorum-based
+```
+
+### GitHub Integration
+```bash
+npx @claude-flow/cli@latest agent spawn -t pr-manager           # PR lifecycle
+npx @claude-flow/cli@latest agent spawn -t code-review-swarm    # Multi-agent review
+npx @claude-flow/cli@latest agent spawn -t issue-tracker        # Issue management
+npx @claude-flow/cli@latest agent spawn -t release-manager      # Release coordination
+npx @claude-flow/cli@latest agent spawn -t workflow-automation  # CI/CD automation
+```
+
+### SPARC Methodology
+```bash
+npx @claude-flow/cli@latest agent spawn -t sparc-coordinator    # SPARC orchestration
+npx @claude-flow/cli@latest agent spawn -t specification        # Requirements
+npx @claude-flow/cli@latest agent spawn -t pseudocode          # Algorithm design
+npx @claude-flow/cli@latest agent spawn -t architecture        # System design
+npx @claude-flow/cli@latest agent spawn -t refinement          # Iterative improvement
+```
+
+## Examples
+
+```bash
+# Spawn with custom name
+npx @claude-flow/cli@latest agent spawn -t coder --name feature-bot
+
+# Spawn with initial task
+npx @claude-flow/cli@latest agent spawn -t researcher --task "Research React 19 features"
+
+# Spawn with specific model
+npx @claude-flow/cli@latest agent spawn -t architect -m claude-3-opus-20240229
+
+# Spawn with custom timeout
+npx @claude-flow/cli@latest agent spawn -t tester --timeout 600
+
+# Spawn using OpenRouter
+npx @claude-flow/cli@latest agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
+```
+
+## Using Claude Code's Task Tool
+
+For actual execution, always use Claude Code's Task tool:
+
+```javascript
+// Spawn ALL agents in ONE message for parallel execution
+Task("Coder", "Implement authentication feature", "coder")
+Task("Tester", "Write unit tests for auth", "tester")
+Task("Reviewer", "Review auth implementation", "reviewer")
+```
+
+## MCP Coordination (Optional)
+
+Use MCP tools only for swarm coordination setup:
+
+```javascript
+mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 15 })
+mcp__claude-flow__agent_spawn({ type: "coordinator", name: "queen" })
+```
+
+## Output
+
+```
+Spawning coder agent: feature-bot
+
++-----------+----------------------------------+
+| Property  | Value                            |
++-----------+----------------------------------+
+| ID        | coder-lx7m9k2                    |
+| Type      | coder                            |
+| Name      | feature-bot                      |
+| Status    | active                           |
+| Created   | 2026-01-08T03:30:00.000Z         |
+| Capabilities | code, debug, refactor, test   |
++-----------+----------------------------------+
+
+Agent feature-bot spawned successfully
+```