@swarmdo/cli 1.4.8

package/.claude/commands/sDo/analysis/performance-bottlenecks.md

@@ -0,0 +1,59 @@
+# Performance Bottleneck Analysis
+
+## Purpose
+Identify and resolve performance bottlenecks in your development workflow.
+
+## Automated Analysis
+
+### 1. Real-time Detection
+The post-task hook automatically analyzes:
+- Execution time vs. complexity
+- Agent utilization rates
+- Resource constraints
+- Operation patterns
+
+### 2. Common Bottlenecks
+
+**Time Bottlenecks:**
+- Tasks taking > 5 minutes
+- Sequential operations that could parallelize
+- Redundant file operations
+
+**Coordination Bottlenecks:**
+- Single agent for complex tasks
+- Unbalanced agent workloads
+- Poor topology selection
+
+**Resource Bottlenecks:**
+- High operation count (> 100)
+- Memory constraints
+- I/O limitations
+
+### 3. Improvement Suggestions
+
+```
+Tool: mcp__swarmdo__task_results
+Parameters: {"taskId": "task-123", "format": "detailed"}
+
+Result includes:
+{
+  "bottlenecks": [
+    {
+      "type": "coordination",
+      "severity": "high",
+      "description": "Single agent used for complex task",
+      "recommendation": "Spawn specialized agents for parallel work"
+    }
+  ],
+  "improvements": [
+    {
+      "area": "execution_time",
+      "suggestion": "Use parallel task execution",
+      "expectedImprovement": "30-50% time reduction"
+    }
+  ]
+}
+```
+
+## Continuous Optimization
+The system learns from each task to prevent future bottlenecks!

package/.claude/commands/sDo/analysis/performance-report.md

@@ -0,0 +1,25 @@
+# performance-report
+
+Generate comprehensive performance reports for swarm operations.
+
+## Usage
+```bash
+npx swarmdo analysis performance-report [options]
+```
+
+## Options
+- `--format <type>` - Report format (json, html, markdown)
+- `--include-metrics` - Include detailed metrics
+- `--compare <id>` - Compare with previous swarm
+
+## Examples
+```bash
+# Generate HTML report
+npx swarmdo analysis performance-report --format html
+
+# Compare swarms
+npx swarmdo analysis performance-report --compare swarm-123
+
+# Full metrics report
+npx swarmdo analysis performance-report --include-metrics --format markdown
+```

package/.claude/commands/sDo/analysis/token-efficiency.md

@@ -0,0 +1,45 @@
+# Token Usage Optimization
+
+## Purpose
+Reduce token consumption while maintaining quality through intelligent coordination.
+
+## Optimization Strategies
+
+### 1. Smart Caching
+- Search results cached for 5 minutes
+- File content cached during session
+- Pattern recognition reduces redundant searches
+
+### 2. Efficient Coordination
+- Agents share context automatically
+- Avoid duplicate file reads
+- Batch related operations
+
+### 3. Measurement & Tracking
+
+```bash
+# Check token savings after session
+Tool: mcp__swarmdo__token_usage
+Parameters: {"operation": "session", "timeframe": "24h"}
+
+# Result shows:
+{
+  "metrics": {
+    "tokensSaved": 15420,
+    "operations": 45,
+    "efficiency": "343 tokens/operation"
+  }
+}
+```
+
+## Best Practices
+1. **Use Task tool** for complex searches
+2. **Enable caching** in pre-search hooks
+3. **Batch operations** when possible
+4. **Review session summaries** for insights
+
+## Token Reduction Results
+- 📉 32.3% average token reduction
+- 🎯 More focused operations
+- 🔄 Intelligent result reuse
+- 📊 Cumulative improvements

package/.claude/commands/sDo/analysis/token-usage.md

@@ -0,0 +1,25 @@
+# token-usage
+
+Analyze token usage patterns and optimize for efficiency.
+
+## Usage
+```bash
+npx swarmdo analysis token-usage [options]
+```
+
+## Options
+- `--period <time>` - Analysis period (1h, 24h, 7d, 30d)
+- `--by-agent` - Break down by agent
+- `--by-operation` - Break down by operation type
+
+## Examples
+```bash
+# Last 24 hours token usage
+npx swarmdo analysis token-usage --period 24h
+
+# By agent breakdown
+npx swarmdo analysis token-usage --by-agent
+
+# Export detailed report
+npx swarmdo analysis token-usage --period 7d --export tokens.csv
+```

package/.claude/commands/sDo/automation/README.md

@@ -0,0 +1,9 @@
+# Automation Commands
+
+Commands for automation operations in Swarmdo.
+
+## Available Commands
+
+- [auto-agent](./auto-agent.md)
+- [smart-spawn](./smart-spawn.md)
+- [workflow-select](./workflow-select.md)

package/.claude/commands/sDo/automation/auto-agent.md

@@ -0,0 +1,122 @@
+# auto agent
+
+Automatically spawn and manage agents based on task requirements.
+
+## Usage
+
+```bash
+npx swarmdo auto agent [options]
+```
+
+## Options
+
+- `--task, -t <description>` - Task description for agent analysis
+- `--max-agents, -m <number>` - Maximum agents to spawn (default: auto)
+- `--min-agents <number>` - Minimum agents required (default: 1)
+- `--strategy, -s <type>` - Selection strategy: optimal, minimal, balanced
+- `--no-spawn` - Analyze only, don't spawn agents
+
+## Examples
+
+### Basic auto-spawning
+
+```bash
+npx swarmdo auto agent --task "Build a REST API with authentication"
+```
+
+### Constrained spawning
+
+```bash
+npx swarmdo auto agent -t "Debug performance issue" --max-agents 3
+```
+
+### Analysis only
+
+```bash
+npx swarmdo auto agent -t "Refactor codebase" --no-spawn
+```
+
+### Minimal strategy
+
+```bash
+npx swarmdo auto agent -t "Fix bug in login" -s minimal
+```
+
+## How It Works
+
+1. **Task Analysis**
+
+   - Parses task description
+   - Identifies required skills
+   - Estimates complexity
+   - Determines parallelization opportunities
+
+2. **Agent Selection**
+
+   - Matches skills to agent types
+   - Considers task dependencies
+   - Optimizes for efficiency
+   - Respects constraints
+
+3. **Topology Selection**
+
+   - Chooses optimal swarm structure
+   - Configures communication patterns
+   - Sets up coordination rules
+   - Enables monitoring
+
+4. **Automatic Spawning**
+   - Creates selected agents
+   - Assigns specific roles
+   - Distributes subtasks
+   - Initiates coordination
+
+## Agent Types Selected
+
+- **Architect**: System design, architecture decisions
+- **Coder**: Implementation, code generation
+- **Tester**: Test creation, quality assurance
+- **Analyst**: Performance, optimization
+- **Researcher**: Documentation, best practices
+- **Coordinator**: Task management, progress tracking
+
+## Strategies
+
+### Optimal
+
+- Maximum efficiency
+- May spawn more agents
+- Best for complex tasks
+- Highest resource usage
+
+### Minimal
+
+- Minimum viable agents
+- Conservative approach
+- Good for simple tasks
+- Lowest resource usage
+
+### Balanced
+
+- Middle ground
+- Adaptive to complexity
+- Default strategy
+- Good performance/resource ratio
+
+## Integration with Claude Code
+
+```javascript
+// In Claude Code after auto-spawning
+mcp__swarmdo__auto_agent {
+  task: "Build authentication system",
+  strategy: "balanced",
+  maxAgents: 6
+}
+```
+
+## See Also
+
+- `agent spawn` - Manual agent creation
+- `swarm init` - Initialize swarm manually
+- `smart spawn` - Intelligent agent spawning
+- `workflow select` - Choose predefined workflows

package/.claude/commands/sDo/automation/self-healing.md

@@ -0,0 +1,106 @@
+# Self-Healing Workflows
+
+## Purpose
+Automatically detect and recover from errors without interrupting your flow.
+
+## Self-Healing Features
+
+### 1. Error Detection
+Monitors for:
+- Failed commands
+- Syntax errors
+- Missing dependencies
+- Broken tests
+
+### 2. Automatic Recovery
+
+**Missing Dependencies:**
+```
+Error: Cannot find module 'express'
+→ Automatically runs: npm install express
+→ Retries original command
+```
+
+**Syntax Errors:**
+```
+Error: Unexpected token
+→ Analyzes error location
+→ Suggests fix through analyzer agent
+→ Applies fix with confirmation
+```
+
+**Test Failures:**
+```
+Test failed: "user authentication"
+→ Spawns debugger agent
+→ Analyzes failure cause
+→ Implements fix
+→ Re-runs tests
+```
+
+### 3. Learning from Failures
+Each recovery improves future prevention:
+- Patterns saved to knowledge base
+- Similar errors prevented proactively
+- Recovery strategies optimized
+
+**Pattern Storage:**
+```javascript
+// Store error patterns
+mcp__swarmdo__memory_usage({
+  "action": "store",
+  "key": "error-pattern-" + Date.now(),
+  "value": JSON.stringify(errorData),
+  "namespace": "error-patterns",
+  "ttl": 2592000 // 30 days
+})
+
+// Analyze patterns
+mcp__swarmdo__neural_patterns({
+  "action": "analyze",
+  "operation": "error-recovery",
+  "outcome": "success"
+})
+```
+
+## Self-Healing Integration
+
+### MCP Tool Coordination
+```javascript
+// Initialize self-healing swarm
+mcp__swarmdo__swarm_init({
+  "topology": "star",
+  "maxAgents": 4,
+  "strategy": "adaptive"
+})
+
+// Spawn recovery agents
+mcp__swarmdo__agent_spawn({
+  "type": "monitor",
+  "name": "Error Monitor",
+  "capabilities": ["error-detection", "recovery"]
+})
+
+// Orchestrate recovery
+mcp__swarmdo__task_orchestrate({
+  "task": "recover from error",
+  "strategy": "sequential",
+  "priority": "critical"
+})
+```
+
+### Fallback Hook Configuration
+```json
+{
+  "PostToolUse": [{
+    "matcher": "^Bash$",
+    "command": "npx swarmdo hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"
+  }]
+}
+```
+
+## Benefits
+- 🛡️ Resilient workflows
+- 🔄 Automatic recovery
+- 📚 Learns from errors
+- ⏱️ Saves debugging time

package/.claude/commands/sDo/automation/session-memory.md

@@ -0,0 +1,90 @@
+# Cross-Session Memory
+
+## Purpose
+Maintain context and learnings across Claude Code sessions for continuous improvement.
+
+## Memory Features
+
+### 1. Automatic State Persistence
+At session end, automatically saves:
+- Active agents and specializations
+- Task history and patterns
+- Performance metrics
+- Neural network weights
+- Knowledge base updates
+
+### 2. Session Restoration
+```javascript
+// Using MCP tools for memory operations
+mcp__swarmdo__memory_usage({
+  "action": "retrieve",
+  "key": "session-state",
+  "namespace": "sessions"
+})
+
+// Restore swarm state
+mcp__swarmdo__context_restore({
+  "snapshotId": "sess-123"
+})
+```
+
+**Fallback with npx:**
+```bash
+npx swarmdo hook session-restore --session-id "sess-123"
+```
+
+### 3. Memory Types
+
+**Project Memory:**
+- File relationships
+- Common edit patterns
+- Testing approaches
+- Build configurations
+
+**Agent Memory:**
+- Specialization levels
+- Task success rates
+- Optimization strategies
+- Error patterns
+
+**Performance Memory:**
+- Bottleneck history
+- Optimization results
+- Token usage patterns
+- Efficiency trends
+
+### 4. Privacy & Control
+```javascript
+// List memory contents
+mcp__swarmdo__memory_usage({
+  "action": "list",
+  "namespace": "sessions"
+})
+
+// Delete specific memory
+mcp__swarmdo__memory_usage({
+  "action": "delete",
+  "key": "session-123",
+  "namespace": "sessions"
+})
+
+// Backup memory
+mcp__swarmdo__memory_backup({
+  "path": "./backups/memory-backup.json"
+})
+```
+
+**Manual control:**
+```bash
+# View stored memory
+ls .swarmdo/memory/
+
+# Disable memory
+export SWARMDO_MEMORY_PERSIST=false
+```
+
+## Benefits
+- 🧠 Contextual awareness
+- 📈 Cumulative learning
+- ⚡ Faster task completion
+- 🎯 Personalized optimization

package/.claude/commands/sDo/automation/smart-agents.md

@@ -0,0 +1,73 @@
+# 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__swarmdo__swarm_status({
+  "swarmId": "current"
+})
+
+// Monitor agent performance
+mcp__swarmdo__agent_metrics({
+  "agentId": "agent-123"
+})
+```
+
+## Configuration
+
+### MCP Tool Integration
+Uses Swarmdo MCP tools for agent coordination:
+```javascript
+// Initialize swarm with appropriate topology
+mcp__swarmdo__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 8,
+  "strategy": "auto"
+})
+
+// Spawn agents based on file type
+mcp__swarmdo__agent_spawn({
+  "type": "coder",
+  "name": "JavaScript Handler",
+  "capabilities": ["javascript", "typescript"]
+})
+```
+
+### Fallback Configuration
+If MCP tools are unavailable:
+```bash
+npx swarmdo hook pre-task --auto-spawn-agents
+```
+
+## Benefits
+- 🤖 Zero manual agent management
+- 🎯 Perfect agent selection
+- 📈 Dynamic scaling
+- 💾 Resource efficiency

package/.claude/commands/sDo/automation/smart-spawn.md

@@ -0,0 +1,25 @@
+# smart-spawn
+
+Intelligently spawn agents based on workload analysis.
+
+## Usage
+```bash
+npx swarmdo automation smart-spawn [options]
+```
+
+## Options
+- `--analyze` - Analyze before spawning
+- `--threshold <n>` - Spawn threshold
+- `--topology <type>` - Preferred topology
+
+## Examples
+```bash
+# Smart spawn with analysis
+npx swarmdo automation smart-spawn --analyze
+
+# Set spawn threshold
+npx swarmdo automation smart-spawn --threshold 5
+
+# Force topology
+npx swarmdo automation smart-spawn --topology hierarchical
+```

package/.claude/commands/sDo/automation/workflow-select.md

@@ -0,0 +1,25 @@
+# workflow-select
+
+Automatically select optimal workflow based on task type.
+
+## Usage
+```bash
+npx swarmdo automation workflow-select [options]
+```
+
+## Options
+- `--task <description>` - Task description
+- `--constraints <list>` - Workflow constraints
+- `--preview` - Preview without executing
+
+## Examples
+```bash
+# Select workflow for task
+npx swarmdo automation workflow-select --task "Deploy to production"
+
+# With constraints
+npx swarmdo automation workflow-select --constraints "no-downtime,rollback"
+
+# Preview mode
+npx swarmdo automation workflow-select --task "Database migration" --preview
+```

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

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

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

@@ -0,0 +1,25 @@
+# agent-spawn
+
+Spawn a new agent in the current swarm.
+
+## Usage
+```bash
+npx swarmdo 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 swarmdo agent spawn --type coder
+
+# With custom name
+npx swarmdo agent spawn --type researcher --name "API Expert"
+
+# With specific skills
+npx swarmdo agent spawn --type coder --skills "python,fastapi,testing"
+```

package/.claude/commands/sDo/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__swarmdo__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__swarmdo__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/