agentic-qe 3.10.9 → 3.11.1

package/.claude/commands/agents/status.md

@@ -0,0 +1,115 @@
+---
+name: status
+description: Show detailed status of an agent
+type: command
+---
+
+# Agent Status Command
+
+Display comprehensive status information for a specific agent including metrics, configuration, and activity.
+
+## Usage
+
+```bash
+npx claude-flow agent status <agent-id>
+npx claude-flow agent status --id <agent-id>
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--id` | Agent ID (alternative to positional arg) | Required |
+| `--format` | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Get status by ID
+npx claude-flow agent status coder-lx7m9k2
+
+# Using --id flag
+npx claude-flow agent status --id researcher-abc123
+
+# JSON output
+npx claude-flow agent status coder-lx7m9k2 --format json
+```
+
+## Output
+
+```
++--------------------------------------------------+
+|              Agent: coder-lx7m9k2                |
++--------------------------------------------------+
+| Type: coder                                      |
+| Status: active                                   |
+| Created: 1/8/2026, 10:30:15 AM                   |
+| Last Activity: 1/8/2026, 10:45:23 AM             |
++--------------------------------------------------+
+
+Metrics
++-------------------------+----------+
+| Metric                  |    Value |
++-------------------------+----------+
+| Tasks Completed         |       12 |
+| Tasks In Progress       |        1 |
+| Tasks Failed            |        0 |
+| Avg Execution Time      |  245.5ms |
+| Uptime                  |   15.3m  |
++-------------------------+----------+
+```
+
+## Detailed Information
+
+The status command provides:
+
+### Basic Info
+- Agent ID and type
+- Current status (active/idle/terminated)
+- Creation timestamp
+- Last activity timestamp
+
+### Performance Metrics
+- Tasks completed successfully
+- Tasks currently in progress
+- Failed task count
+- Average execution time
+- Total uptime
+
+### Configuration (when applicable)
+- Provider and model
+- Timeout settings
+- Auto-tools enabled
+- Custom capabilities
+
+## JSON Output
+
+```json
+{
+  "id": "coder-lx7m9k2",
+  "agentType": "coder",
+  "status": "active",
+  "createdAt": "2026-01-08T10:30:15.000Z",
+  "lastActivityAt": "2026-01-08T10:45:23.000Z",
+  "config": {
+    "provider": "anthropic",
+    "model": "claude-3-5-sonnet-20241022",
+    "timeout": 300,
+    "autoTools": true
+  },
+  "metrics": {
+    "tasksCompleted": 12,
+    "tasksInProgress": 1,
+    "tasksFailed": 0,
+    "averageExecutionTime": 245.5,
+    "uptime": 918000
+  }
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent list` - Find agent IDs
+- `npx claude-flow agent metrics` - Aggregate metrics
+- `npx claude-flow agent health` - Health check
+- `npx claude-flow agent logs <id>` - Activity logs

package/.claude/commands/agents/stop.md

@@ -0,0 +1,102 @@
+---
+name: stop
+description: Stop a running agent
+aliases: [kill]
+type: command
+---
+
+# Agent Stop Command
+
+Stop a running agent with graceful or forced shutdown options.
+
+## Usage
+
+```bash
+npx claude-flow agent stop <agent-id> [options]
+npx claude-flow agent kill <agent-id> [options]  # Alias
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--force` | `-f` | Force stop without graceful shutdown | false |
+| `--timeout` | | Graceful shutdown timeout in seconds | 30 |
+
+## Examples
+
+```bash
+# Graceful stop (completes current task)
+npx claude-flow agent stop coder-lx7m9k2
+
+# Force stop (immediate termination)
+npx claude-flow agent stop coder-lx7m9k2 --force
+
+# Custom shutdown timeout
+npx claude-flow agent stop coder-lx7m9k2 --timeout 60
+
+# Using kill alias
+npx claude-flow agent kill researcher-abc123 -f
+```
+
+## Graceful vs Force Stop
+
+### Graceful Shutdown (Default)
+1. Completes current task
+2. Saves agent state to memory
+3. Releases resources cleanly
+4. Notifies swarm coordinator
+
+```bash
+npx claude-flow agent stop coder-lx7m9k2
+
+# Output:
+# Stopping agent coder-lx7m9k2...
+#   Completing current task...
+#   Saving state...
+#   Releasing resources...
+# Agent coder-lx7m9k2 stopped successfully
+```
+
+### Force Stop
+1. Immediate termination
+2. No state preservation
+3. May leave tasks incomplete
+
+```bash
+npx claude-flow agent stop coder-lx7m9k2 --force
+
+# Output:
+# Stopping agent coder-lx7m9k2...
+# Agent coder-lx7m9k2 stopped successfully
+```
+
+## Interactive Confirmation
+
+Without `--force`, you'll be prompted to confirm:
+
+```
+? Are you sure you want to stop agent coder-lx7m9k2? (y/N)
+```
+
+## Batch Operations
+
+To stop multiple agents:
+
+```bash
+# Stop all agents of a type
+npx claude-flow agent list -t coder --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx claude-flow agent stop {} -f
+
+# Stop all idle agents
+npx claude-flow agent list -s idle --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx claude-flow agent stop {}
+```
+
+## Related Commands
+
+- `npx claude-flow agent list` - Find agent IDs
+- `npx claude-flow agent status` - Check status before stopping
+- `npx claude-flow swarm destroy` - Stop all agents in swarm

package/.claude/commands/claude-flow-help.md

@@ -66,7 +66,7 @@ Claude-Flow is the ultimate multi-terminal orchestration platform that revolutio
 
 ### Initialize with SPARC:
 ```bash
-npx -y ruflo init --sparc
+npx -y claude-flow@latest init --sparc
 ```
 
 ### Start a development swarm:

package/.claude/commands/coordination/README.md

@@ -0,0 +1,9 @@
+# Coordination Commands
+
+Commands for coordination operations in Claude Flow.
+
+## Available Commands
+
+- [swarm-init](./swarm-init.md)
+- [agent-spawn](./agent-spawn.md)
+- [task-orchestrate](./task-orchestrate.md)

package/.claude/commands/coordination/agent-spawn.md

@@ -0,0 +1,25 @@
+# agent-spawn
+
+Spawn a new agent in the current swarm.
+
+## Usage
+```bash
+npx claude-flow agent spawn [options]
+```
+
+## Options
+- `--type <type>` - Agent type (coder, researcher, analyst, tester, coordinator)
+- `--name <name>` - Custom agent name
+- `--skills <list>` - Specific skills (comma-separated)
+
+## Examples
+```bash
+# Spawn coder agent
+npx claude-flow agent spawn --type coder
+
+# With custom name
+npx claude-flow agent spawn --type researcher --name "API Expert"
+
+# With specific skills
+npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"
+```

package/.claude/commands/coordination/init.md

@@ -0,0 +1,44 @@
+# Initialize Coordination Framework
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__swarm_init`
+
+## Parameters
+```json
+{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}
+```
+
+## Description
+Set up a coordination topology to guide Claude Code's approach to complex tasks
+
+## Details
+This tool creates a coordination framework that helps Claude Code:
+- Break down complex problems systematically
+- Approach tasks from multiple perspectives
+- Maintain consistency across large projects
+- Work more efficiently through structured coordination
+
+Remember: This does NOT create actual coding agents. It creates a coordination pattern for Claude Code to follow.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__swarm_init`
+2. With parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/orchestrate.md

@@ -0,0 +1,43 @@
+# Coordinate Task Execution
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__task_orchestrate`
+
+## Parameters
+```json
+{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}
+```
+
+## Description
+Break down and coordinate complex tasks for systematic execution by Claude Code
+
+## Details
+Orchestration strategies:
+- **parallel**: Claude Code works on independent components simultaneously
+- **sequential**: Step-by-step execution for dependent tasks
+- **adaptive**: Dynamically adjusts based on task complexity
+
+The orchestrator creates a plan that Claude Code follows using its native tools.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__task_orchestrate`
+2. With parameters: `{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/spawn.md

@@ -0,0 +1,45 @@
+# Create Cognitive Patterns
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__agent_spawn`
+
+## Parameters
+```json
+{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}
+```
+
+## Description
+Define cognitive patterns that represent different approaches Claude Code can take
+
+## Details
+Agent types represent thinking patterns, not actual coders:
+- **researcher**: Systematic exploration approach
+- **coder**: Implementation-focused thinking
+- **analyst**: Data-driven decision making
+- **architect**: Big-picture system design
+- **reviewer**: Quality and consistency checking
+
+These patterns guide how Claude Code approaches different aspects of your task.
+
+## Example Usage
+
+**In Claude Code:**
+1. Use the tool: `mcp__claude-flow__agent_spawn`
+2. With parameters: `{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}`
+3. Claude Code then executes the coordinated plan using its native tools
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /claude.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/.claude/commands/coordination/swarm-init.md

@@ -0,0 +1,85 @@
+# swarm init
+
+Initialize a Claude Flow swarm with specified topology and configuration.
+
+## Usage
+
+```bash
+npx claude-flow swarm init [options]
+```
+
+## Options
+
+- `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
+- `--max-agents, -m <number>` - Maximum number of agents (default: 8)
+- `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
+- `--auto-spawn` - Automatically spawn agents based on task complexity
+- `--memory` - Enable cross-session memory persistence
+- `--github` - Enable GitHub integration features
+
+## Examples
+
+### Basic initialization
+
+```bash
+npx claude-flow swarm init
+```
+
+### Mesh topology for research
+
+```bash
+npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
+```
+
+### Hierarchical for development
+
+```bash
+npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
+```
+
+### GitHub-focused swarm
+
+```bash
+npx claude-flow swarm init --topology star --github --memory
+```
+
+## Topologies
+
+### Mesh
+
+- All agents connect to all others
+- Best for: Research, exploration, brainstorming
+- Communication: High overhead, maximum information sharing
+
+### Hierarchical
+
+- Tree structure with clear command chain
+- Best for: Development, structured tasks, large projects
+- Communication: Efficient, clear responsibilities
+
+### Ring
+
+- Agents connect in a circle
+- Best for: Pipeline processing, sequential workflows
+- Communication: Low overhead, ordered processing
+
+### Star
+
+- Central coordinator with satellite agents
+- Best for: Simple tasks, centralized control
+- Communication: Minimal overhead, clear coordination
+
+## Integration with Claude Code
+
+Once initialized, use MCP tools in Claude Code:
+
+```javascript
+mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8 }
+```
+
+## See Also
+
+- `agent spawn` - Create swarm agents
+- `task orchestrate` - Coordinate task execution
+- `swarm status` - Check swarm state
+- `swarm monitor` - Real-time monitoring

package/.claude/commands/coordination/task-orchestrate.md

@@ -0,0 +1,25 @@
+# task-orchestrate
+
+Orchestrate complex tasks across the swarm.
+
+## Usage
+```bash
+npx claude-flow task orchestrate [options]
+```
+
+## Options
+- `--task <description>` - Task description
+- `--strategy <type>` - Orchestration strategy
+- `--priority <level>` - Task priority (low, medium, high, critical)
+
+## Examples
+```bash
+# Orchestrate development task
+npx claude-flow task orchestrate --task "Implement user authentication"
+
+# High priority task
+npx claude-flow task orchestrate --task "Fix production bug" --priority critical
+
+# With specific strategy
+npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel
+```

package/.claude/commands/github/code-review-swarm.md

@@ -243,7 +243,7 @@ jobs:
   swarm-review:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           

package/.claude/commands/github/issue-tracker.md

@@ -88,7 +88,7 @@ mcp__github__add_issue_comment {
   - Final validation and merge preparation
   
   ---
-  🤖 Generated with Claude Code using ruv-swarm coordination`
+  `
 }
 
 // Store progress in swarm memory
@@ -206,9 +206,10 @@ mcp__github__update_issue {
 Updates will be posted automatically by swarm agents during implementation.
 
 ---
-🤖 Generated with Claude Code
 ```
 
+<!-- last-updated: 2026-05-21 — ADR-127 -->
+
 ### Bug Report Template:
 ```markdown
 ## 🐛 Bug Report
@@ -244,7 +245,6 @@ Updates will be posted automatically by swarm agents during implementation.
 - **Tester**: Validation and testing
 
 ---
-🤖 Generated with Claude Code
 ```
 
 ## Best Practices

package/.claude/commands/github/release-manager.md

@@ -167,10 +167,12 @@ This release was coordinated using ruv-swarm agents:
 This release is production-ready with comprehensive validation and testing.
 
 ---
-🤖 Generated with Claude Code using ruv-swarm coordination`
+`
 }
 ```
 
+<!-- last-updated: 2026-05-21 — ADR-127 -->
+
 ## Batch Release Workflow
 
 ### Complete Release Pipeline:
@@ -310,9 +312,9 @@ jobs:
   release-validation:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Setup Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: '20'
       - name: Install and Test

package/.claude/commands/github/release-swarm.md

@@ -273,7 +273,7 @@ jobs:
   release-swarm:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           

package/.claude/commands/github/repo-architect.md

@@ -153,8 +153,8 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with: { node-version: '20' }
       - run: npm install && npm test`,
     message: "ci: Standardize integration workflow across repositories",

package/.claude/commands/github/swarm-issue.md

@@ -259,9 +259,12 @@ jobs:
         uses: ruvnet/swarm-action@v1
         with:
           command: |
-            if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then
+            LABEL_NAME_FILE=$(mktemp)
+            printf '%s' "${{ github.event.label.name }}" > "$LABEL_NAME_FILE"
+            if grep -qx 'swarm-ready' "$LABEL_NAME_FILE"; then
               npx ruv-swarm github issue-init ${{ github.event.issue.number }}
             fi
+            rm -f "$LABEL_NAME_FILE"
 ```
 
 ### Issue Board Integration

package/.claude/commands/github/swarm-pr.md

@@ -44,14 +44,17 @@ jobs:
   swarm-handler:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Handle Swarm Command
         run: |
-          if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
+          COMMENT_BODY_FILE=$(mktemp)
+          printf '%s' "${{ github.event.comment.body }}" > "$COMMENT_BODY_FILE"
+          if grep -q '^/swarm' "$COMMENT_BODY_FILE"; then
             npx ruv-swarm github handle-comment \
               --pr ${{ github.event.pull_request.number }} \
-              --comment "${{ github.event.comment.body }}"
+              --comment-file "$COMMENT_BODY_FILE"
           fi
+          rm -f "$COMMENT_BODY_FILE"
 ```
 
 ## PR Label Integration

package/.claude/commands/github/sync-coordinator.md

@@ -137,10 +137,12 @@ This integration uses ruv-swarm agents for:
 - Memory-based state management
 
 ---
-🤖 Generated with Claude Code using ruv-swarm coordination`
+`
 }
 ```
 
+<!-- last-updated: 2026-05-21 — ADR-127 -->
+
 ## Batch Synchronization Example
 
 ### Complete Package Sync Workflow:

package/.claude/commands/github/workflow-automation.md

@@ -15,7 +15,7 @@ jobs:
   swarm-analysis:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       
       - name: Initialize Swarm
         uses: ruvnet/swarm-action@v1
@@ -63,7 +63,7 @@ jobs:
   detect-and-build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       
       - name: Detect Languages
         id: detect

package/.claude/commands/hive-mind/README.md

@@ -0,0 +1,17 @@
+# Hive-mind Commands
+
+Commands for hive-mind operations in Claude Flow.
+
+## Available Commands
+
+- [hive-mind](./hive-mind.md)
+- [hive-mind-init](./hive-mind-init.md)
+- [hive-mind-spawn](./hive-mind-spawn.md)
+- [hive-mind-status](./hive-mind-status.md)
+- [hive-mind-resume](./hive-mind-resume.md)
+- [hive-mind-stop](./hive-mind-stop.md)
+- [hive-mind-sessions](./hive-mind-sessions.md)
+- [hive-mind-consensus](./hive-mind-consensus.md)
+- [hive-mind-memory](./hive-mind-memory.md)
+- [hive-mind-metrics](./hive-mind-metrics.md)
+- [hive-mind-wizard](./hive-mind-wizard.md)