agentic-qe 1.9.1 → 1.9.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/.claude/helpers/checkpoint-manager.sh +251 -0
  2. package/.claude/helpers/github-safe.js +106 -0
  3. package/.claude/helpers/github-setup.sh +28 -0
  4. package/.claude/helpers/quick-start.sh +19 -0
  5. package/.claude/helpers/setup-mcp.sh +18 -0
  6. package/.claude/helpers/standard-checkpoint-hooks.sh +179 -0
  7. package/CHANGELOG.md +36 -0
  8. package/README.md +33 -1
  9. package/dist/core/memory/SwarmMemoryManager.d.ts.map +1 -1
  10. package/dist/core/memory/SwarmMemoryManager.js +45 -5
  11. package/dist/core/memory/SwarmMemoryManager.js.map +1 -1
  12. package/dist/mcp/handlers/memory/memory-store.d.ts +6 -2
  13. package/dist/mcp/handlers/memory/memory-store.d.ts.map +1 -1
  14. package/dist/mcp/handlers/memory/memory-store.js +26 -4
  15. package/dist/mcp/handlers/memory/memory-store.js.map +1 -1
  16. package/dist/mcp/server.d.ts.map +1 -1
  17. package/dist/mcp/server.js +2 -1
  18. package/dist/mcp/server.js.map +1 -1
  19. package/docs/README.md +839 -0
  20. package/docs/reference/agents.md +412 -0
  21. package/docs/reference/skills.md +796 -0
  22. package/docs/reference/usage.md +512 -0
  23. package/package.json +4 -1
  24. package/templates/agent-code-execution-template.md +619 -0
  25. package/templates/aqe.sh +20 -0
  26. package/.claude/commands/github/code-review-swarm.md +0 -514
  27. package/.claude/commands/github/github-modes.md +0 -147
  28. package/.claude/commands/github/issue-tracker.md +0 -292
  29. package/.claude/commands/github/multi-repo-swarm.md +0 -519
  30. package/.claude/commands/github/pr-manager.md +0 -170
  31. package/.claude/commands/github/project-board-sync.md +0 -471
  32. package/.claude/commands/github/release-manager.md +0 -338
  33. package/.claude/commands/github/release-swarm.md +0 -544
  34. package/.claude/commands/github/repo-architect.md +0 -367
  35. package/.claude/commands/github/swarm-issue.md +0 -482
  36. package/.claude/commands/github/swarm-pr.md +0 -285
  37. package/.claude/commands/github/sync-coordinator.md +0 -301
  38. package/.claude/commands/github/workflow-automation.md +0 -442
  39. package/.claude/commands/hooks/overview.md +0 -132
  40. package/.claude/commands/pair/commands.md +0 -546
  41. package/.claude/commands/pair/config.md +0 -510
  42. package/.claude/commands/pair/examples.md +0 -512
  43. package/.claude/commands/pair/modes.md +0 -348
  44. package/.claude/commands/pair/session.md +0 -407
  45. package/.claude/commands/pair/start.md +0 -209
  46. package/.claude/commands/sparc/orchestrator.md +0 -132
  47. package/.claude/commands/sparc/sparc-modes.md +0 -174
  48. package/.claude/commands/stream-chain/pipeline.md +0 -121
  49. package/.claude/commands/stream-chain/run.md +0 -70
  50. package/.claude/commands/swarm/analysis.md +0 -95
  51. package/.claude/commands/swarm/development.md +0 -96
  52. package/.claude/commands/swarm/examples.md +0 -168
  53. package/.claude/commands/swarm/maintenance.md +0 -102
  54. package/.claude/commands/swarm/optimization.md +0 -117
  55. package/.claude/commands/swarm/research.md +0 -136
  56. package/.claude/commands/swarm/testing.md +0 -131
  57. package/.claude/commands/truth/start.md +0 -143
  58. package/.claude/commands/verify/check.md +0 -50
  59. package/.claude/commands/verify/start.md +0 -128
@@ -1,132 +0,0 @@
1
- # SPARC Orchestrator Mode
2
-
3
- ## Purpose
4
- Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory using MCP tools.
5
-
6
- ## Activation
7
-
8
- ### Option 1: Using MCP Tools (Preferred in Claude Code)
9
- ```javascript
10
- mcp__claude-flow__sparc_mode {
11
- mode: "orchestrator",
12
- task_description: "coordinate feature development"
13
- }
14
- ```
15
-
16
- ### Option 2: Using NPX CLI (Fallback when MCP not available)
17
- ```bash
18
- # Use when running from terminal or MCP tools unavailable
19
- npx claude-flow sparc run orchestrator "coordinate feature development"
20
-
21
- # For alpha features
22
- npx claude-flow@alpha sparc run orchestrator "coordinate feature development"
23
- ```
24
-
25
- ### Option 3: Local Installation
26
- ```bash
27
- # If claude-flow is installed locally
28
- ./claude-flow sparc run orchestrator "coordinate feature development"
29
- ```
30
-
31
- ## Core Capabilities
32
- - Task decomposition
33
- - Agent coordination
34
- - Resource allocation
35
- - Progress tracking
36
- - Result synthesis
37
-
38
- ## Integration Examples
39
-
40
- ### Using MCP Tools (Preferred)
41
- ```javascript
42
- // Initialize orchestration swarm
43
- mcp__claude-flow__swarm_init {
44
- topology: "hierarchical",
45
- strategy: "auto",
46
- maxAgents: 8
47
- }
48
-
49
- // Spawn coordinator agent
50
- mcp__claude-flow__agent_spawn {
51
- type: "coordinator",
52
- capabilities: ["task-planning", "resource-management"]
53
- }
54
-
55
- // Orchestrate tasks
56
- mcp__claude-flow__task_orchestrate {
57
- task: "feature development",
58
- strategy: "parallel",
59
- dependencies: ["auth", "ui", "api"]
60
- }
61
- ```
62
-
63
- ### Using NPX CLI (Fallback)
64
- ```bash
65
- # Initialize orchestration swarm
66
- npx claude-flow swarm init --topology hierarchical --strategy auto --max-agents 8
67
-
68
- # Spawn coordinator agent
69
- npx claude-flow agent spawn --type coordinator --capabilities "task-planning,resource-management"
70
-
71
- # Orchestrate tasks
72
- npx claude-flow task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"
73
- ```
74
-
75
- ## Orchestration Patterns
76
- - Hierarchical coordination
77
- - Parallel execution
78
- - Sequential pipelines
79
- - Event-driven flows
80
- - Adaptive strategies
81
-
82
- ## Coordination Tools
83
- - TodoWrite for planning
84
- - Task for agent launch
85
- - Memory for sharing
86
- - Progress monitoring
87
- - Result aggregation
88
-
89
- ## Workflow Example
90
-
91
- ### Using MCP Tools (Preferred)
92
- ```javascript
93
- // 1. Initialize orchestration swarm
94
- mcp__claude-flow__swarm_init {
95
- topology: "hierarchical",
96
- maxAgents: 10
97
- }
98
-
99
- // 2. Create workflow
100
- mcp__claude-flow__workflow_create {
101
- name: "feature-development",
102
- steps: ["design", "implement", "test", "deploy"]
103
- }
104
-
105
- // 3. Execute orchestration
106
- mcp__claude-flow__sparc_mode {
107
- mode: "orchestrator",
108
- options: {parallel: true, monitor: true},
109
- task_description: "develop user management system"
110
- }
111
-
112
- // 4. Monitor progress
113
- mcp__claude-flow__swarm_monitor {
114
- swarmId: "current",
115
- interval: 5000
116
- }
117
- ```
118
-
119
- ### Using NPX CLI (Fallback)
120
- ```bash
121
- # 1. Initialize orchestration swarm
122
- npx claude-flow swarm init --topology hierarchical --max-agents 10
123
-
124
- # 2. Create workflow
125
- npx claude-flow workflow create --name "feature-development" --steps "design,implement,test,deploy"
126
-
127
- # 3. Execute orchestration
128
- npx claude-flow sparc run orchestrator "develop user management system" --parallel --monitor
129
-
130
- # 4. Monitor progress
131
- npx claude-flow swarm monitor --interval 5000
132
- ```
@@ -1,174 +0,0 @@
1
- # SPARC Modes Overview
2
-
3
- SPARC (Specification, Planning, Architecture, Review, Code) is a comprehensive development methodology with 17 specialized modes, all integrated with MCP tools for enhanced coordination and execution.
4
-
5
- ## Available Modes
6
-
7
- ### Core Orchestration Modes
8
- - **orchestrator**: Multi-agent task orchestration
9
- - **swarm-coordinator**: Specialized swarm management
10
- - **workflow-manager**: Process automation
11
- - **batch-executor**: Parallel task execution
12
-
13
- ### Development Modes
14
- - **coder**: Autonomous code generation
15
- - **architect**: System design
16
- - **reviewer**: Code review
17
- - **tdd**: Test-driven development
18
-
19
- ### Analysis and Research Modes
20
- - **researcher**: Deep research capabilities
21
- - **analyzer**: Code and data analysis
22
- - **optimizer**: Performance optimization
23
-
24
- ### Creative and Support Modes
25
- - **designer**: UI/UX design
26
- - **innovator**: Creative problem solving
27
- - **documenter**: Documentation generation
28
- - **debugger**: Systematic debugging
29
- - **tester**: Comprehensive testing
30
- - **memory-manager**: Knowledge management
31
-
32
- ## Usage
33
-
34
- ### Option 1: Using MCP Tools (Preferred in Claude Code)
35
- ```javascript
36
- // Execute SPARC mode directly
37
- mcp__claude-flow__sparc_mode {
38
- mode: "<mode>",
39
- task_description: "<task>",
40
- options: {
41
- // mode-specific options
42
- }
43
- }
44
-
45
- // Initialize swarm for advanced coordination
46
- mcp__claude-flow__swarm_init {
47
- topology: "hierarchical",
48
- strategy: "auto",
49
- maxAgents: 8
50
- }
51
-
52
- // Spawn specialized agents
53
- mcp__claude-flow__agent_spawn {
54
- type: "<agent-type>",
55
- capabilities: ["<capability1>", "<capability2>"]
56
- }
57
-
58
- // Monitor execution
59
- mcp__claude-flow__swarm_monitor {
60
- swarmId: "current",
61
- interval: 5000
62
- }
63
- ```
64
-
65
- ### Option 2: Using NPX CLI (Fallback when MCP not available)
66
- ```bash
67
- # Use when running from terminal or MCP tools unavailable
68
- npx claude-flow sparc run <mode> "task description"
69
-
70
- # For alpha features
71
- npx claude-flow@alpha sparc run <mode> "task description"
72
-
73
- # List all modes
74
- npx claude-flow sparc modes
75
-
76
- # Get help for a mode
77
- npx claude-flow sparc help <mode>
78
-
79
- # Run with options
80
- npx claude-flow sparc run <mode> "task" --parallel --monitor
81
- ```
82
-
83
- ### Option 3: Local Installation
84
- ```bash
85
- # If claude-flow is installed locally
86
- ./claude-flow sparc run <mode> "task description"
87
- ```
88
-
89
- ## Common Workflows
90
-
91
- ### Full Development Cycle
92
-
93
- #### Using MCP Tools (Preferred)
94
- ```javascript
95
- // 1. Initialize development swarm
96
- mcp__claude-flow__swarm_init {
97
- topology: "hierarchical",
98
- maxAgents: 12
99
- }
100
-
101
- // 2. Architecture design
102
- mcp__claude-flow__sparc_mode {
103
- mode: "architect",
104
- task_description: "design microservices"
105
- }
106
-
107
- // 3. Implementation
108
- mcp__claude-flow__sparc_mode {
109
- mode: "coder",
110
- task_description: "implement services"
111
- }
112
-
113
- // 4. Testing
114
- mcp__claude-flow__sparc_mode {
115
- mode: "tdd",
116
- task_description: "test all services"
117
- }
118
-
119
- // 5. Review
120
- mcp__claude-flow__sparc_mode {
121
- mode: "reviewer",
122
- task_description: "review implementation"
123
- }
124
- ```
125
-
126
- #### Using NPX CLI (Fallback)
127
- ```bash
128
- # 1. Architecture design
129
- npx claude-flow sparc run architect "design microservices"
130
-
131
- # 2. Implementation
132
- npx claude-flow sparc run coder "implement services"
133
-
134
- # 3. Testing
135
- npx claude-flow sparc run tdd "test all services"
136
-
137
- # 4. Review
138
- npx claude-flow sparc run reviewer "review implementation"
139
- ```
140
-
141
- ### Research and Innovation
142
-
143
- #### Using MCP Tools (Preferred)
144
- ```javascript
145
- // 1. Research phase
146
- mcp__claude-flow__sparc_mode {
147
- mode: "researcher",
148
- task_description: "research best practices"
149
- }
150
-
151
- // 2. Innovation
152
- mcp__claude-flow__sparc_mode {
153
- mode: "innovator",
154
- task_description: "propose novel solutions"
155
- }
156
-
157
- // 3. Documentation
158
- mcp__claude-flow__sparc_mode {
159
- mode: "documenter",
160
- task_description: "document findings"
161
- }
162
- ```
163
-
164
- #### Using NPX CLI (Fallback)
165
- ```bash
166
- # 1. Research phase
167
- npx claude-flow sparc run researcher "research best practices"
168
-
169
- # 2. Innovation
170
- npx claude-flow sparc run innovator "propose novel solutions"
171
-
172
- # 3. Documentation
173
- npx claude-flow sparc run documenter "document findings"
174
- ```
@@ -1,121 +0,0 @@
1
- # stream-chain pipeline
2
-
3
- Execute predefined pipelines for common development workflows.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- claude-flow stream-chain pipeline <type> [options]
9
- ```
10
-
11
- ## Available Pipelines
12
-
13
- ### analysis
14
- Code analysis and improvement pipeline.
15
-
16
- ```bash
17
- claude-flow stream-chain pipeline analysis
18
- ```
19
-
20
- **Steps:**
21
- 1. Analyze current directory structure and identify main components
22
- 2. Based on analysis, identify potential improvements and issues
23
- 3. Generate detailed report with actionable recommendations
24
-
25
- ### refactor
26
- Automated refactoring workflow.
27
-
28
- ```bash
29
- claude-flow stream-chain pipeline refactor
30
- ```
31
-
32
- **Steps:**
33
- 1. Identify code that could benefit from refactoring
34
- 2. Create prioritized refactoring plan with specific changes
35
- 3. Provide refactored code examples for top 3 priorities
36
-
37
- ### test
38
- Comprehensive test generation.
39
-
40
- ```bash
41
- claude-flow stream-chain pipeline test
42
- ```
43
-
44
- **Steps:**
45
- 1. Analyze codebase and identify areas lacking test coverage
46
- 2. Design comprehensive test cases for critical functions
47
- 3. Generate unit test implementations with assertions
48
-
49
- ### optimize
50
- Performance optimization pipeline.
51
-
52
- ```bash
53
- claude-flow stream-chain pipeline optimize
54
- ```
55
-
56
- **Steps:**
57
- 1. Profile codebase and identify performance bottlenecks
58
- 2. Analyze bottlenecks and suggest optimization strategies
59
- 3. Provide optimized implementations for main issues
60
-
61
- ## Options
62
-
63
- - `--verbose` - Show detailed execution
64
- - `--timeout <seconds>` - Timeout per step (default: 30)
65
- - `--debug` - Enable debug mode
66
-
67
- ## Examples
68
-
69
- ### Run Analysis Pipeline
70
- ```bash
71
- claude-flow stream-chain pipeline analysis
72
- ```
73
-
74
- ### Refactor with Extended Timeout
75
- ```bash
76
- claude-flow stream-chain pipeline refactor --timeout 60
77
- ```
78
-
79
- ### Verbose Test Generation
80
- ```bash
81
- claude-flow stream-chain pipeline test --verbose
82
- ```
83
-
84
- ### Performance Optimization
85
- ```bash
86
- claude-flow stream-chain pipeline optimize --debug
87
- ```
88
-
89
- ## Output
90
-
91
- Each pipeline generates:
92
- - Step-by-step execution progress
93
- - Success/failure status per step
94
- - Total execution time
95
- - Summary of results
96
-
97
- ## Custom Pipelines
98
-
99
- Define custom pipelines in `.claude-flow/config.json`:
100
-
101
- ```json
102
- {
103
- "streamChain": {
104
- "pipelines": {
105
- "security": {
106
- "name": "Security Audit Pipeline",
107
- "prompts": [
108
- "Scan for security vulnerabilities",
109
- "Prioritize by severity",
110
- "Generate fixes"
111
- ]
112
- }
113
- }
114
- }
115
- }
116
- ```
117
-
118
- Then run:
119
- ```bash
120
- claude-flow stream-chain pipeline security
121
- ```
@@ -1,70 +0,0 @@
1
- # stream-chain run
2
-
3
- Execute a custom stream chain with your own prompts.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- claude-flow stream-chain run <prompt1> <prompt2> [...] [options]
9
- ```
10
-
11
- Minimum 2 prompts required for chaining.
12
-
13
- ## Options
14
-
15
- - `--verbose` - Show detailed execution information
16
- - `--timeout <seconds>` - Timeout per step (default: 30)
17
- - `--debug` - Enable debug mode
18
-
19
- ## How It Works
20
-
21
- Each prompt in the chain receives the complete output from the previous step as context, enabling complex multi-step workflows.
22
-
23
- ## Examples
24
-
25
- ### Basic Chain
26
- ```bash
27
- claude-flow stream-chain run \
28
- "Write a function" \
29
- "Add tests for it"
30
- ```
31
-
32
- ### Complex Workflow
33
- ```bash
34
- claude-flow stream-chain run \
35
- "Analyze the authentication system" \
36
- "Identify security vulnerabilities" \
37
- "Propose fixes with priority levels" \
38
- "Implement the critical fixes" \
39
- "Generate tests for the fixes"
40
- ```
41
-
42
- ### With Options
43
- ```bash
44
- claude-flow stream-chain run \
45
- "Complex analysis task" \
46
- "Detailed implementation" \
47
- --timeout 60 \
48
- --verbose
49
- ```
50
-
51
- ## Context Preservation
52
-
53
- The output from each step is injected into the next prompt:
54
-
55
- ```
56
- Step 1: "Write a sorting function"
57
- Output: [function code]
58
-
59
- Step 2 receives: "Previous step output:
60
- [function code]
61
-
62
- Next step: Optimize for performance"
63
- ```
64
-
65
- ## Best Practices
66
-
67
- 1. **Clear Instructions**: Make each prompt specific
68
- 2. **Logical Flow**: Order prompts in logical sequence
69
- 3. **Appropriate Timeouts**: Increase for complex tasks
70
- 4. **Verification**: Add verification steps in chain
@@ -1,95 +0,0 @@
1
- # Analysis Swarm Strategy
2
-
3
- ## Purpose
4
- Comprehensive analysis through distributed agent coordination.
5
-
6
- ## Activation
7
-
8
- ### Using MCP Tools
9
- ```javascript
10
- // Initialize analysis swarm
11
- mcp__claude-flow__swarm_init({
12
- "topology": "mesh",
13
- "maxAgents": 6,
14
- "strategy": "adaptive"
15
- })
16
-
17
- // Orchestrate analysis task
18
- mcp__claude-flow__task_orchestrate({
19
- "task": "analyze system performance",
20
- "strategy": "parallel",
21
- "priority": "medium"
22
- })
23
- ```
24
-
25
- ### Using CLI (Fallback)
26
- `npx claude-flow swarm "analyze system performance" --strategy analysis`
27
-
28
- ## Agent Roles
29
-
30
- ### Agent Spawning with MCP
31
- ```javascript
32
- // Spawn analysis agents
33
- mcp__claude-flow__agent_spawn({
34
- "type": "analyst",
35
- "name": "Data Collector",
36
- "capabilities": ["metrics", "logging", "monitoring"]
37
- })
38
-
39
- mcp__claude-flow__agent_spawn({
40
- "type": "analyst",
41
- "name": "Pattern Analyzer",
42
- "capabilities": ["pattern-recognition", "anomaly-detection"]
43
- })
44
-
45
- mcp__claude-flow__agent_spawn({
46
- "type": "documenter",
47
- "name": "Report Generator",
48
- "capabilities": ["reporting", "visualization"]
49
- })
50
-
51
- mcp__claude-flow__agent_spawn({
52
- "type": "coordinator",
53
- "name": "Insight Synthesizer",
54
- "capabilities": ["synthesis", "correlation"]
55
- })
56
- ```
57
-
58
- ## Coordination Modes
59
- - Mesh: For exploratory analysis
60
- - Pipeline: For sequential processing
61
- - Hierarchical: For complex systems
62
-
63
- ## Analysis Operations
64
- ```javascript
65
- // Run performance analysis
66
- mcp__claude-flow__performance_report({
67
- "format": "detailed",
68
- "timeframe": "24h"
69
- })
70
-
71
- // Identify bottlenecks
72
- mcp__claude-flow__bottleneck_analyze({
73
- "component": "api",
74
- "metrics": ["response-time", "throughput"]
75
- })
76
-
77
- // Pattern recognition
78
- mcp__claude-flow__pattern_recognize({
79
- "data": performanceData,
80
- "patterns": ["anomaly", "trend", "cycle"]
81
- })
82
- ```
83
-
84
- ## Status Monitoring
85
- ```javascript
86
- // Monitor analysis progress
87
- mcp__claude-flow__task_status({
88
- "taskId": "analysis-task-001"
89
- })
90
-
91
- // Get analysis results
92
- mcp__claude-flow__task_results({
93
- "taskId": "analysis-task-001"
94
- })
95
- ```
@@ -1,96 +0,0 @@
1
- # Development Swarm Strategy
2
-
3
- ## Purpose
4
- Coordinated development through specialized agent teams.
5
-
6
- ## Activation
7
-
8
- ### Using MCP Tools
9
- ```javascript
10
- // Initialize development swarm
11
- mcp__claude-flow__swarm_init({
12
- "topology": "hierarchical",
13
- "maxAgents": 8,
14
- "strategy": "balanced"
15
- })
16
-
17
- // Orchestrate development task
18
- mcp__claude-flow__task_orchestrate({
19
- "task": "build feature X",
20
- "strategy": "parallel",
21
- "priority": "high"
22
- })
23
- ```
24
-
25
- ### Using CLI (Fallback)
26
- `npx claude-flow swarm "build feature X" --strategy development`
27
-
28
- ## Agent Roles
29
-
30
- ### Agent Spawning with MCP
31
- ```javascript
32
- // Spawn development agents
33
- mcp__claude-flow__agent_spawn({
34
- "type": "architect",
35
- "name": "System Designer",
36
- "capabilities": ["system-design", "api-design"]
37
- })
38
-
39
- mcp__claude-flow__agent_spawn({
40
- "type": "coder",
41
- "name": "Frontend Developer",
42
- "capabilities": ["react", "typescript", "ui"]
43
- })
44
-
45
- mcp__claude-flow__agent_spawn({
46
- "type": "coder",
47
- "name": "Backend Developer",
48
- "capabilities": ["nodejs", "api", "database"]
49
- })
50
-
51
- mcp__claude-flow__agent_spawn({
52
- "type": "specialist",
53
- "name": "Database Expert",
54
- "capabilities": ["sql", "nosql", "optimization"]
55
- })
56
-
57
- mcp__claude-flow__agent_spawn({
58
- "type": "tester",
59
- "name": "Integration Tester",
60
- "capabilities": ["integration", "e2e", "api-testing"]
61
- })
62
- ```
63
-
64
- ## Best Practices
65
- - Use hierarchical mode for large projects
66
- - Enable parallel execution
67
- - Implement continuous testing
68
- - Monitor swarm health regularly
69
-
70
- ## Status Monitoring
71
- ```javascript
72
- // Check swarm status
73
- mcp__claude-flow__swarm_status({
74
- "swarmId": "development-swarm"
75
- })
76
-
77
- // Monitor agent performance
78
- mcp__claude-flow__agent_metrics({
79
- "agentId": "architect-001"
80
- })
81
-
82
- // Real-time monitoring
83
- mcp__claude-flow__swarm_monitor({
84
- "swarmId": "development-swarm",
85
- "interval": 5000
86
- })
87
- ```
88
-
89
- ## Error Handling
90
- ```javascript
91
- // Enable fault tolerance
92
- mcp__claude-flow__daa_fault_tolerance({
93
- "agentId": "all",
94
- "strategy": "auto-recovery"
95
- })
96
- ```