claude-flow 2.0.0-alpha.64 → 2.0.0-alpha.65

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 (105) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/bin/claude-flow +1 -1
  3. package/dist/api/claude-api-errors.d.ts +115 -0
  4. package/dist/api/claude-api-errors.d.ts.map +1 -0
  5. package/dist/api/claude-api-errors.js +198 -0
  6. package/dist/api/claude-api-errors.js.map +1 -0
  7. package/dist/api/claude-client-enhanced.d.ts +109 -0
  8. package/dist/api/claude-client-enhanced.d.ts.map +1 -0
  9. package/dist/api/claude-client-enhanced.js +479 -0
  10. package/dist/api/claude-client-enhanced.js.map +1 -0
  11. package/dist/api/claude-client.d.ts +42 -0
  12. package/dist/api/claude-client.d.ts.map +1 -1
  13. package/dist/api/claude-client.js +217 -14
  14. package/dist/api/claude-client.js.map +1 -1
  15. package/dist/cli/commands/hive-mind/pause.d.ts.map +1 -1
  16. package/dist/cli/commands/hive-mind/pause.js +6 -5
  17. package/dist/cli/commands/hive-mind/pause.js.map +1 -1
  18. package/dist/cli/commands/hive-mind/ps.js.map +1 -1
  19. package/dist/cli/commands/hive-mind/resume.d.ts.map +1 -1
  20. package/dist/cli/commands/hive-mind/resume.js +4 -3
  21. package/dist/cli/commands/hive-mind/resume.js.map +1 -1
  22. package/dist/cli/commands/hive-mind/stop.js.map +1 -1
  23. package/dist/cli/repl.d.ts.map +1 -1
  24. package/dist/cli/repl.js +44 -22
  25. package/dist/cli/repl.js.map +1 -1
  26. package/dist/cli/simple-cli.js +4 -3
  27. package/dist/cli/simple-cli.js.map +1 -1
  28. package/dist/cli/simple-commands/coordination.js +60 -40
  29. package/dist/cli/simple-commands/coordination.js.map +1 -1
  30. package/dist/cli/simple-commands/hive-mind/auto-save-middleware.d.ts +3 -4
  31. package/dist/cli/simple-commands/hive-mind/auto-save-middleware.d.ts.map +1 -1
  32. package/dist/cli/simple-commands/hive-mind/auto-save-middleware.js +6 -6
  33. package/dist/cli/simple-commands/hive-mind/auto-save-middleware.js.map +1 -1
  34. package/dist/cli/simple-commands/hive-mind/mcp-wrapper.d.ts +1 -1
  35. package/dist/cli/simple-commands/hive-mind/mcp-wrapper.d.ts.map +1 -1
  36. package/dist/cli/simple-commands/hive-mind/mcp-wrapper.js +64 -7
  37. package/dist/cli/simple-commands/hive-mind/mcp-wrapper.js.map +1 -1
  38. package/dist/cli/simple-commands/hive-mind/session-manager.d.ts +139 -0
  39. package/dist/cli/simple-commands/hive-mind/session-manager.d.ts.map +1 -0
  40. package/dist/cli/simple-commands/hive-mind/session-manager.js +308 -95
  41. package/dist/cli/simple-commands/hive-mind/session-manager.js.map +1 -1
  42. package/dist/cli/simple-commands/hive-mind.d.ts.map +1 -1
  43. package/dist/cli/simple-commands/hive-mind.js +88 -10
  44. package/dist/cli/simple-commands/hive-mind.js.map +1 -1
  45. package/dist/cli/simple-commands/init/claude-commands/optimized-slash-commands.d.ts.map +1 -1
  46. package/dist/cli/simple-commands/init/claude-commands/optimized-slash-commands.js +45 -22
  47. package/dist/cli/simple-commands/init/claude-commands/optimized-slash-commands.js.map +1 -1
  48. package/dist/cli/simple-commands/init/claude-commands/slash-commands.d.ts.map +1 -1
  49. package/dist/cli/simple-commands/init/claude-commands/slash-commands.js +34 -13
  50. package/dist/cli/simple-commands/init/claude-commands/slash-commands.js.map +1 -1
  51. package/dist/cli/simple-commands/init/claude-commands/sparc-commands.d.ts.map +1 -1
  52. package/dist/cli/simple-commands/init/claude-commands/sparc-commands.js +107 -30
  53. package/dist/cli/simple-commands/init/claude-commands/sparc-commands.js.map +1 -1
  54. package/dist/cli/simple-commands/init/copy-revised-templates.d.ts +29 -0
  55. package/dist/cli/simple-commands/init/copy-revised-templates.d.ts.map +1 -0
  56. package/dist/cli/simple-commands/init/copy-revised-templates.js +159 -0
  57. package/dist/cli/simple-commands/init/copy-revised-templates.js.map +1 -0
  58. package/dist/cli/simple-commands/init/index.d.ts.map +1 -1
  59. package/dist/cli/simple-commands/init/index.js +139 -196
  60. package/dist/cli/simple-commands/init/index.js.map +1 -1
  61. package/dist/cli/simple-commands/init/template-copier.d.ts +27 -0
  62. package/dist/cli/simple-commands/init/template-copier.d.ts.map +1 -0
  63. package/dist/cli/simple-commands/init/template-copier.js +510 -0
  64. package/dist/cli/simple-commands/init/template-copier.js.map +1 -0
  65. package/dist/cli/simple-commands/init/templates/sparc-modes.d.ts.map +1 -1
  66. package/dist/cli/simple-commands/init/templates/sparc-modes.js +634 -23
  67. package/dist/cli/simple-commands/init/templates/sparc-modes.js.map +1 -1
  68. package/dist/cli/simple-orchestrator.d.ts.map +1 -1
  69. package/dist/cli/simple-orchestrator.js +2 -1
  70. package/dist/cli/simple-orchestrator.js.map +1 -1
  71. package/dist/cli/ui/compatible-ui.js +1 -1
  72. package/dist/cli/ui/compatible-ui.js.map +1 -1
  73. package/dist/cli/ui/index.d.ts.map +1 -1
  74. package/dist/cli/ui/index.js +4 -2
  75. package/dist/cli/ui/index.js.map +1 -1
  76. package/dist/cli/utils/environment-detector.d.ts +5 -0
  77. package/dist/cli/utils/environment-detector.d.ts.map +1 -1
  78. package/dist/cli/utils/environment-detector.js.map +1 -1
  79. package/dist/core/logger.d.ts +2 -0
  80. package/dist/core/logger.d.ts.map +1 -1
  81. package/dist/core/logger.js +3 -0
  82. package/dist/core/logger.js.map +1 -1
  83. package/dist/hive-mind/core/DatabaseManager.d.ts +6 -0
  84. package/dist/hive-mind/core/DatabaseManager.d.ts.map +1 -1
  85. package/dist/hive-mind/core/DatabaseManager.js +66 -15
  86. package/dist/hive-mind/core/DatabaseManager.js.map +1 -1
  87. package/dist/memory/backends/sqlite.d.ts +1 -0
  88. package/dist/memory/backends/sqlite.d.ts.map +1 -1
  89. package/dist/memory/backends/sqlite.js +17 -2
  90. package/dist/memory/backends/sqlite.js.map +1 -1
  91. package/package.json +1 -1
  92. package/src/cli/commands/hive-mind/pause.ts +6 -5
  93. package/src/cli/commands/hive-mind/ps.ts +4 -4
  94. package/src/cli/commands/hive-mind/resume.ts +4 -3
  95. package/src/cli/commands/hive-mind/stop.ts +1 -1
  96. package/src/cli/help-text.js +1 -1
  97. package/src/cli/repl.ts +44 -22
  98. package/src/cli/simple-cli.js +1 -1
  99. package/src/cli/simple-cli.ts +11 -10
  100. package/src/cli/simple-commands/init/index.js +1 -0
  101. package/src/cli/simple-orchestrator.ts +2 -1
  102. package/src/cli/ui/compatible-ui.ts +1 -1
  103. package/src/cli/ui/index.ts +4 -2
  104. package/src/cli/utils/environment-detector.ts +2 -2
  105. package/src/core/logger.ts +5 -0
@@ -62,7 +62,35 @@ function createAnalysisStrategy() {
62
62
  Comprehensive analysis through distributed agent coordination.
63
63
 
64
64
  ## Activation
65
- \`./claude-flow swarm "analyze system performance" --strategy analysis\`
65
+
66
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
67
+ \`\`\`javascript
68
+ mcp__claude-flow__swarm_init {
69
+ topology: "mesh",
70
+ strategy: "analysis",
71
+ maxAgents: 6
72
+ }
73
+
74
+ mcp__claude-flow__task_orchestrate {
75
+ task: "analyze system performance",
76
+ strategy: "distributed"
77
+ }
78
+ \`\`\`
79
+
80
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
81
+ \`\`\`bash
82
+ # Use when running from terminal or MCP tools unavailable
83
+ npx claude-flow swarm "analyze system performance" --strategy analysis
84
+
85
+ # For alpha features
86
+ npx claude-flow@alpha swarm "analyze system performance" --strategy analysis
87
+ \`\`\`
88
+
89
+ ### Option 3: Local Installation
90
+ \`\`\`bash
91
+ # If claude-flow is installed locally
92
+ ./claude-flow swarm "analyze system performance" --strategy analysis
93
+ \`\`\`
66
94
 
67
95
  ## Agent Roles
68
96
  - Data Collector: Gathers metrics and logs
@@ -83,7 +111,35 @@ function createDevelopmentStrategy() {
83
111
  Coordinated development through specialized agent teams.
84
112
 
85
113
  ## Activation
86
- \`./claude-flow swarm "build feature X" --strategy development\`
114
+
115
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
116
+ \`\`\`javascript
117
+ mcp__claude-flow__swarm_init {
118
+ topology: "hierarchical",
119
+ strategy: "development",
120
+ maxAgents: 8
121
+ }
122
+
123
+ mcp__claude-flow__task_orchestrate {
124
+ task: "build feature X",
125
+ strategy: "parallel"
126
+ }
127
+ \`\`\`
128
+
129
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
130
+ \`\`\`bash
131
+ # Use when running from terminal or MCP tools unavailable
132
+ npx claude-flow swarm "build feature X" --strategy development
133
+
134
+ # For alpha features
135
+ npx claude-flow@alpha swarm "build feature X" --strategy development
136
+ \`\`\`
137
+
138
+ ### Option 3: Local Installation
139
+ \`\`\`bash
140
+ # If claude-flow is installed locally
141
+ ./claude-flow swarm "build feature X" --strategy development
142
+ \`\`\`
87
143
 
88
144
  ## Agent Roles
89
145
  - Architect: Designs system structure
@@ -138,7 +194,36 @@ function createMaintenanceStrategy() {
138
194
  System maintenance and updates through coordinated agents.
139
195
 
140
196
  ## Activation
141
- \`./claude-flow swarm "update dependencies" --strategy maintenance\`
197
+
198
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
199
+ \`\`\`javascript
200
+ mcp__claude-flow__swarm_init {
201
+ topology: "hierarchical",
202
+ strategy: "maintenance",
203
+ maxAgents: 5
204
+ }
205
+
206
+ mcp__claude-flow__task_orchestrate {
207
+ task: "update dependencies",
208
+ strategy: "sequential",
209
+ priority: "high"
210
+ }
211
+ \`\`\`
212
+
213
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
214
+ \`\`\`bash
215
+ # Use when running from terminal or MCP tools unavailable
216
+ npx claude-flow swarm "update dependencies" --strategy maintenance
217
+
218
+ # For alpha features
219
+ npx claude-flow@alpha swarm "update dependencies" --strategy maintenance
220
+ \`\`\`
221
+
222
+ ### Option 3: Local Installation
223
+ \`\`\`bash
224
+ # If claude-flow is installed locally
225
+ ./claude-flow swarm "update dependencies" --strategy maintenance
226
+ \`\`\`
142
227
 
143
228
  ## Agent Roles
144
229
  - Dependency Analyzer: Checks for updates
@@ -159,7 +244,35 @@ function createOptimizationStrategy() {
159
244
  Performance optimization through specialized analysis.
160
245
 
161
246
  ## Activation
162
- \`./claude-flow swarm "optimize performance" --strategy optimization\`
247
+
248
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
249
+ \`\`\`javascript
250
+ mcp__claude-flow__swarm_init {
251
+ topology: "mesh",
252
+ strategy: "optimization",
253
+ maxAgents: 6
254
+ }
255
+
256
+ mcp__claude-flow__task_orchestrate {
257
+ task: "optimize performance",
258
+ strategy: "parallel"
259
+ }
260
+ \`\`\`
261
+
262
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
263
+ \`\`\`bash
264
+ # Use when running from terminal or MCP tools unavailable
265
+ npx claude-flow swarm "optimize performance" --strategy optimization
266
+
267
+ # For alpha features
268
+ npx claude-flow@alpha swarm "optimize performance" --strategy optimization
269
+ \`\`\`
270
+
271
+ ### Option 3: Local Installation
272
+ \`\`\`bash
273
+ # If claude-flow is installed locally
274
+ ./claude-flow swarm "optimize performance" --strategy optimization
275
+ \`\`\`
163
276
 
164
277
  ## Agent Roles
165
278
  - Performance Profiler: Identifies bottlenecks
@@ -181,7 +294,35 @@ function createResearchStrategy() {
181
294
  Deep research through parallel information gathering.
182
295
 
183
296
  ## Activation
184
- \`./claude-flow swarm "research topic X" --strategy research\`
297
+
298
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
299
+ \`\`\`javascript
300
+ mcp__claude-flow__swarm_init {
301
+ topology: "distributed",
302
+ strategy: "research",
303
+ maxAgents: 6
304
+ }
305
+
306
+ mcp__claude-flow__task_orchestrate {
307
+ task: "research topic X",
308
+ strategy: "parallel"
309
+ }
310
+ \`\`\`
311
+
312
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
313
+ \`\`\`bash
314
+ # Use when running from terminal or MCP tools unavailable
315
+ npx claude-flow swarm "research topic X" --strategy research
316
+
317
+ # For alpha features
318
+ npx claude-flow@alpha swarm "research topic X" --strategy research
319
+ \`\`\`
320
+
321
+ ### Option 3: Local Installation
322
+ \`\`\`bash
323
+ # If claude-flow is installed locally
324
+ ./claude-flow swarm "research topic X" --strategy research
325
+ \`\`\`
185
326
 
186
327
  ## Agent Roles
187
328
  - Web Researcher: Searches online sources
@@ -202,7 +343,35 @@ function createTestingStrategy() {
202
343
  Comprehensive testing through distributed execution.
203
344
 
204
345
  ## Activation
205
- \`./claude-flow swarm "test application" --strategy testing\`
346
+
347
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
348
+ \`\`\`javascript
349
+ mcp__claude-flow__swarm_init {
350
+ topology: "distributed",
351
+ strategy: "testing",
352
+ maxAgents: 5
353
+ }
354
+
355
+ mcp__claude-flow__task_orchestrate {
356
+ task: "test application",
357
+ strategy: "parallel"
358
+ }
359
+ \`\`\`
360
+
361
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
362
+ \`\`\`bash
363
+ # Use when running from terminal or MCP tools unavailable
364
+ npx claude-flow swarm "test application" --strategy testing
365
+
366
+ # For alpha features
367
+ npx claude-flow@alpha swarm "test application" --strategy testing
368
+ \`\`\`
369
+
370
+ ### Option 3: Local Installation
371
+ \`\`\`bash
372
+ # If claude-flow is installed locally
373
+ ./claude-flow swarm "test application" --strategy testing
374
+ \`\`\`
206
375
 
207
376
  ## Agent Roles
208
377
  - Unit Tester: Tests individual components
@@ -245,7 +414,33 @@ function createAnalyzerMode() {
245
414
  Deep code and data analysis with batch processing capabilities.
246
415
 
247
416
  ## Activation
248
- \`./claude-flow sparc run analyzer "analyze codebase performance"\`
417
+
418
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
419
+ \`\`\`javascript
420
+ mcp__claude-flow__sparc_mode {
421
+ mode: "analyzer",
422
+ task_description: "analyze codebase performance",
423
+ options: {
424
+ parallel: true,
425
+ detailed: true
426
+ }
427
+ }
428
+ \`\`\`
429
+
430
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
431
+ \`\`\`bash
432
+ # Use when running from terminal or MCP tools unavailable
433
+ npx claude-flow sparc run analyzer "analyze codebase performance"
434
+
435
+ # For alpha features
436
+ npx claude-flow@alpha sparc run analyzer "analyze codebase performance"
437
+ \`\`\`
438
+
439
+ ### Option 3: Local Installation
440
+ \`\`\`bash
441
+ # If claude-flow is installed locally
442
+ ./claude-flow sparc run analyzer "analyze codebase performance"
443
+ \`\`\`
249
444
 
250
445
  ## Core Capabilities
251
446
  - Code analysis with parallel file processing
@@ -274,7 +469,33 @@ function createArchitectMode() {
274
469
  System design with Memory-based coordination for scalable architectures.
275
470
 
276
471
  ## Activation
277
- \`./claude-flow sparc run architect "design microservices architecture"\`
472
+
473
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
474
+ \`\`\`javascript
475
+ mcp__claude-flow__sparc_mode {
476
+ mode: "architect",
477
+ task_description: "design microservices architecture",
478
+ options: {
479
+ detailed: true,
480
+ memory_enabled: true
481
+ }
482
+ }
483
+ \`\`\`
484
+
485
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
486
+ \`\`\`bash
487
+ # Use when running from terminal or MCP tools unavailable
488
+ npx claude-flow sparc run architect "design microservices architecture"
489
+
490
+ # For alpha features
491
+ npx claude-flow@alpha sparc run architect "design microservices architecture"
492
+ \`\`\`
493
+
494
+ ### Option 3: Local Installation
495
+ \`\`\`bash
496
+ # If claude-flow is installed locally
497
+ ./claude-flow sparc run architect "design microservices architecture"
498
+ \`\`\`
278
499
 
279
500
  ## Core Capabilities
280
501
  - System architecture design
@@ -304,7 +525,33 @@ function createBatchExecutorMode() {
304
525
  Parallel task execution specialist using batch operations.
305
526
 
306
527
  ## Activation
307
- \`./claude-flow sparc run batch-executor "process multiple files"\`
528
+
529
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
530
+ \`\`\`javascript
531
+ mcp__claude-flow__sparc_mode {
532
+ mode: "batch-executor",
533
+ task_description: "process multiple files",
534
+ options: {
535
+ parallel: true,
536
+ batch_size: 10
537
+ }
538
+ }
539
+ \`\`\`
540
+
541
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
542
+ \`\`\`bash
543
+ # Use when running from terminal or MCP tools unavailable
544
+ npx claude-flow sparc run batch-executor "process multiple files"
545
+
546
+ # For alpha features
547
+ npx claude-flow@alpha sparc run batch-executor "process multiple files"
548
+ \`\`\`
549
+
550
+ ### Option 3: Local Installation
551
+ \`\`\`bash
552
+ # If claude-flow is installed locally
553
+ ./claude-flow sparc run batch-executor "process multiple files"
554
+ \`\`\`
308
555
 
309
556
  ## Core Capabilities
310
557
  - Parallel file operations
@@ -335,7 +582,33 @@ function createCoderMode() {
335
582
  Autonomous code generation with batch file operations.
336
583
 
337
584
  ## Activation
338
- \`./claude-flow sparc run coder "implement user authentication"\`
585
+
586
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
587
+ \`\`\`javascript
588
+ mcp__claude-flow__sparc_mode {
589
+ mode: "coder",
590
+ task_description: "implement user authentication",
591
+ options: {
592
+ test_driven: true,
593
+ parallel_edits: true
594
+ }
595
+ }
596
+ \`\`\`
597
+
598
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
599
+ \`\`\`bash
600
+ # Use when running from terminal or MCP tools unavailable
601
+ npx claude-flow sparc run coder "implement user authentication"
602
+
603
+ # For alpha features
604
+ npx claude-flow@alpha sparc run coder "implement user authentication"
605
+ \`\`\`
606
+
607
+ ### Option 3: Local Installation
608
+ \`\`\`bash
609
+ # If claude-flow is installed locally
610
+ ./claude-flow sparc run coder "implement user authentication"
611
+ \`\`\`
339
612
 
340
613
  ## Core Capabilities
341
614
  - Feature implementation
@@ -366,7 +639,33 @@ function createDebuggerMode() {
366
639
  Systematic debugging with TodoWrite and Memory integration.
367
640
 
368
641
  ## Activation
369
- \`./claude-flow sparc run debugger "fix authentication issues"\`
642
+
643
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
644
+ \`\`\`javascript
645
+ mcp__claude-flow__sparc_mode {
646
+ mode: "debugger",
647
+ task_description: "fix authentication issues",
648
+ options: {
649
+ verbose: true,
650
+ trace: true
651
+ }
652
+ }
653
+ \`\`\`
654
+
655
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
656
+ \`\`\`bash
657
+ # Use when running from terminal or MCP tools unavailable
658
+ npx claude-flow sparc run debugger "fix authentication issues"
659
+
660
+ # For alpha features
661
+ npx claude-flow@alpha sparc run debugger "fix authentication issues"
662
+ \`\`\`
663
+
664
+ ### Option 3: Local Installation
665
+ \`\`\`bash
666
+ # If claude-flow is installed locally
667
+ ./claude-flow sparc run debugger "fix authentication issues"
668
+ \`\`\`
370
669
 
371
670
  ## Core Capabilities
372
671
  - Issue reproduction
@@ -397,7 +696,33 @@ function createDesignerMode() {
397
696
  UI/UX design with Memory coordination for consistent experiences.
398
697
 
399
698
  ## Activation
400
- \`./claude-flow sparc run designer "create dashboard UI"\`
699
+
700
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
701
+ \`\`\`javascript
702
+ mcp__claude-flow__sparc_mode {
703
+ mode: "designer",
704
+ task_description: "create dashboard UI",
705
+ options: {
706
+ design_system: true,
707
+ responsive: true
708
+ }
709
+ }
710
+ \`\`\`
711
+
712
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
713
+ \`\`\`bash
714
+ # Use when running from terminal or MCP tools unavailable
715
+ npx claude-flow sparc run designer "create dashboard UI"
716
+
717
+ # For alpha features
718
+ npx claude-flow@alpha sparc run designer "create dashboard UI"
719
+ \`\`\`
720
+
721
+ ### Option 3: Local Installation
722
+ \`\`\`bash
723
+ # If claude-flow is installed locally
724
+ ./claude-flow sparc run designer "create dashboard UI"
725
+ \`\`\`
401
726
 
402
727
  ## Core Capabilities
403
728
  - Interface design
@@ -427,7 +752,33 @@ function createDocumenterMode() {
427
752
  Documentation with batch file operations for comprehensive docs.
428
753
 
429
754
  ## Activation
430
- \`./claude-flow sparc run documenter "create API documentation"\`
755
+
756
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
757
+ \`\`\`javascript
758
+ mcp__claude-flow__sparc_mode {
759
+ mode: "documenter",
760
+ task_description: "create API documentation",
761
+ options: {
762
+ format: "markdown",
763
+ include_examples: true
764
+ }
765
+ }
766
+ \`\`\`
767
+
768
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
769
+ \`\`\`bash
770
+ # Use when running from terminal or MCP tools unavailable
771
+ npx claude-flow sparc run documenter "create API documentation"
772
+
773
+ # For alpha features
774
+ npx claude-flow@alpha sparc run documenter "create API documentation"
775
+ \`\`\`
776
+
777
+ ### Option 3: Local Installation
778
+ \`\`\`bash
779
+ # If claude-flow is installed locally
780
+ ./claude-flow sparc run documenter "create API documentation"
781
+ \`\`\`
431
782
 
432
783
  ## Core Capabilities
433
784
  - API documentation
@@ -458,7 +809,33 @@ function createInnovatorMode() {
458
809
  Creative problem solving with WebSearch and Memory integration.
459
810
 
460
811
  ## Activation
461
- \`./claude-flow sparc run innovator "innovative solutions for scaling"\`
812
+
813
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
814
+ \`\`\`javascript
815
+ mcp__claude-flow__sparc_mode {
816
+ mode: "innovator",
817
+ task_description: "innovative solutions for scaling",
818
+ options: {
819
+ research_depth: "comprehensive",
820
+ creativity_level: "high"
821
+ }
822
+ }
823
+ \`\`\`
824
+
825
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
826
+ \`\`\`bash
827
+ # Use when running from terminal or MCP tools unavailable
828
+ npx claude-flow sparc run innovator "innovative solutions for scaling"
829
+
830
+ # For alpha features
831
+ npx claude-flow@alpha sparc run innovator "innovative solutions for scaling"
832
+ \`\`\`
833
+
834
+ ### Option 3: Local Installation
835
+ \`\`\`bash
836
+ # If claude-flow is installed locally
837
+ ./claude-flow sparc run innovator "innovative solutions for scaling"
838
+ \`\`\`
462
839
 
463
840
  ## Core Capabilities
464
841
  - Creative ideation
@@ -489,7 +866,33 @@ function createMemoryManagerMode() {
489
866
  Knowledge management with Memory tools for persistent insights.
490
867
 
491
868
  ## Activation
492
- \`./claude-flow sparc run memory-manager "organize project knowledge"\`
869
+
870
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
871
+ \`\`\`javascript
872
+ mcp__claude-flow__sparc_mode {
873
+ mode: "memory-manager",
874
+ task_description: "organize project knowledge",
875
+ options: {
876
+ namespace: "project",
877
+ auto_organize: true
878
+ }
879
+ }
880
+ \`\`\`
881
+
882
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
883
+ \`\`\`bash
884
+ # Use when running from terminal or MCP tools unavailable
885
+ npx claude-flow sparc run memory-manager "organize project knowledge"
886
+
887
+ # For alpha features
888
+ npx claude-flow@alpha sparc run memory-manager "organize project knowledge"
889
+ \`\`\`
890
+
891
+ ### Option 3: Local Installation
892
+ \`\`\`bash
893
+ # If claude-flow is installed locally
894
+ ./claude-flow sparc run memory-manager "organize project knowledge"
895
+ \`\`\`
493
896
 
494
897
  ## Core Capabilities
495
898
  - Knowledge organization
@@ -520,7 +923,33 @@ function createOptimizerMode() {
520
923
  Performance optimization with systematic analysis and improvements.
521
924
 
522
925
  ## Activation
523
- \`./claude-flow sparc run optimizer "optimize application performance"\`
926
+
927
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
928
+ \`\`\`javascript
929
+ mcp__claude-flow__sparc_mode {
930
+ mode: "optimizer",
931
+ task_description: "optimize application performance",
932
+ options: {
933
+ profile: true,
934
+ benchmark: true
935
+ }
936
+ }
937
+ \`\`\`
938
+
939
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
940
+ \`\`\`bash
941
+ # Use when running from terminal or MCP tools unavailable
942
+ npx claude-flow sparc run optimizer "optimize application performance"
943
+
944
+ # For alpha features
945
+ npx claude-flow@alpha sparc run optimizer "optimize application performance"
946
+ \`\`\`
947
+
948
+ ### Option 3: Local Installation
949
+ \`\`\`bash
950
+ # If claude-flow is installed locally
951
+ ./claude-flow sparc run optimizer "optimize application performance"
952
+ \`\`\`
524
953
 
525
954
  ## Core Capabilities
526
955
  - Performance profiling
@@ -551,7 +980,33 @@ function createOrchestratorMode() {
551
980
  Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory.
552
981
 
553
982
  ## Activation
554
- \`./claude-flow sparc run orchestrator "coordinate feature development"\`
983
+
984
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
985
+ \`\`\`javascript
986
+ mcp__claude-flow__sparc_mode {
987
+ mode: "orchestrator",
988
+ task_description: "coordinate feature development",
989
+ options: {
990
+ parallel: true,
991
+ monitor: true
992
+ }
993
+ }
994
+ \`\`\`
995
+
996
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
997
+ \`\`\`bash
998
+ # Use when running from terminal or MCP tools unavailable
999
+ npx claude-flow sparc run orchestrator "coordinate feature development"
1000
+
1001
+ # For alpha features
1002
+ npx claude-flow@alpha sparc run orchestrator "coordinate feature development"
1003
+ \`\`\`
1004
+
1005
+ ### Option 3: Local Installation
1006
+ \`\`\`bash
1007
+ # If claude-flow is installed locally
1008
+ ./claude-flow sparc run orchestrator "coordinate feature development"
1009
+ \`\`\`
555
1010
 
556
1011
  ## Core Capabilities
557
1012
  - Task decomposition
@@ -582,7 +1037,33 @@ function createResearcherMode() {
582
1037
  Deep research with parallel WebSearch/WebFetch and Memory coordination.
583
1038
 
584
1039
  ## Activation
585
- \`./claude-flow sparc run researcher "research AI trends 2024"\`
1040
+
1041
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1042
+ \`\`\`javascript
1043
+ mcp__claude-flow__sparc_mode {
1044
+ mode: "researcher",
1045
+ task_description: "research AI trends 2024",
1046
+ options: {
1047
+ depth: "comprehensive",
1048
+ sources: ["academic", "industry", "news"]
1049
+ }
1050
+ }
1051
+ \`\`\`
1052
+
1053
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1054
+ \`\`\`bash
1055
+ # Use when running from terminal or MCP tools unavailable
1056
+ npx claude-flow sparc run researcher "research AI trends 2024"
1057
+
1058
+ # For alpha features
1059
+ npx claude-flow@alpha sparc run researcher "research AI trends 2024"
1060
+ \`\`\`
1061
+
1062
+ ### Option 3: Local Installation
1063
+ \`\`\`bash
1064
+ # If claude-flow is installed locally
1065
+ ./claude-flow sparc run researcher "research AI trends 2024"
1066
+ \`\`\`
586
1067
 
587
1068
  ## Core Capabilities
588
1069
  - Information gathering
@@ -613,7 +1094,33 @@ function createReviewerMode() {
613
1094
  Code review using batch file analysis for comprehensive reviews.
614
1095
 
615
1096
  ## Activation
616
- \`./claude-flow sparc run reviewer "review pull request #123"\`
1097
+
1098
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1099
+ \`\`\`javascript
1100
+ mcp__claude-flow__sparc_mode {
1101
+ mode: "reviewer",
1102
+ task_description: "review pull request #123",
1103
+ options: {
1104
+ security_check: true,
1105
+ performance_check: true
1106
+ }
1107
+ }
1108
+ \`\`\`
1109
+
1110
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1111
+ \`\`\`bash
1112
+ # Use when running from terminal or MCP tools unavailable
1113
+ npx claude-flow sparc run reviewer "review pull request #123"
1114
+
1115
+ # For alpha features
1116
+ npx claude-flow@alpha sparc run reviewer "review pull request #123"
1117
+ \`\`\`
1118
+
1119
+ ### Option 3: Local Installation
1120
+ \`\`\`bash
1121
+ # If claude-flow is installed locally
1122
+ ./claude-flow sparc run reviewer "review pull request #123"
1123
+ \`\`\`
617
1124
 
618
1125
  ## Core Capabilities
619
1126
  - Code quality assessment
@@ -644,7 +1151,33 @@ function createSwarmCoordinatorMode() {
644
1151
  Specialized swarm management with batch coordination capabilities.
645
1152
 
646
1153
  ## Activation
647
- \`./claude-flow sparc run swarm-coordinator "manage development swarm"\`
1154
+
1155
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1156
+ \`\`\`javascript
1157
+ mcp__claude-flow__sparc_mode {
1158
+ mode: "swarm-coordinator",
1159
+ task_description: "manage development swarm",
1160
+ options: {
1161
+ topology: "hierarchical",
1162
+ max_agents: 10
1163
+ }
1164
+ }
1165
+ \`\`\`
1166
+
1167
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1168
+ \`\`\`bash
1169
+ # Use when running from terminal or MCP tools unavailable
1170
+ npx claude-flow sparc run swarm-coordinator "manage development swarm"
1171
+
1172
+ # For alpha features
1173
+ npx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"
1174
+ \`\`\`
1175
+
1176
+ ### Option 3: Local Installation
1177
+ \`\`\`bash
1178
+ # If claude-flow is installed locally
1179
+ ./claude-flow sparc run swarm-coordinator "manage development swarm"
1180
+ \`\`\`
648
1181
 
649
1182
  ## Core Capabilities
650
1183
  - Swarm initialization
@@ -675,7 +1208,33 @@ function createTddMode() {
675
1208
  Test-driven development with TodoWrite planning and comprehensive testing.
676
1209
 
677
1210
  ## Activation
678
- \`./claude-flow sparc run tdd "shopping cart feature"\`
1211
+
1212
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1213
+ \`\`\`javascript
1214
+ mcp__claude-flow__sparc_mode {
1215
+ mode: "tdd",
1216
+ task_description: "shopping cart feature",
1217
+ options: {
1218
+ coverage_target: 90,
1219
+ test_framework: "jest"
1220
+ }
1221
+ }
1222
+ \`\`\`
1223
+
1224
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1225
+ \`\`\`bash
1226
+ # Use when running from terminal or MCP tools unavailable
1227
+ npx claude-flow sparc run tdd "shopping cart feature"
1228
+
1229
+ # For alpha features
1230
+ npx claude-flow@alpha sparc run tdd "shopping cart feature"
1231
+ \`\`\`
1232
+
1233
+ ### Option 3: Local Installation
1234
+ \`\`\`bash
1235
+ # If claude-flow is installed locally
1236
+ ./claude-flow sparc run tdd "shopping cart feature"
1237
+ \`\`\`
679
1238
 
680
1239
  ## Core Capabilities
681
1240
  - Test-first development
@@ -706,7 +1265,33 @@ function createTesterMode() {
706
1265
  Comprehensive testing with parallel execution capabilities.
707
1266
 
708
1267
  ## Activation
709
- \`./claude-flow sparc run tester "full regression suite"\`
1268
+
1269
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1270
+ \`\`\`javascript
1271
+ mcp__claude-flow__sparc_mode {
1272
+ mode: "tester",
1273
+ task_description: "full regression suite",
1274
+ options: {
1275
+ parallel: true,
1276
+ coverage: true
1277
+ }
1278
+ }
1279
+ \`\`\`
1280
+
1281
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1282
+ \`\`\`bash
1283
+ # Use when running from terminal or MCP tools unavailable
1284
+ npx claude-flow sparc run tester "full regression suite"
1285
+
1286
+ # For alpha features
1287
+ npx claude-flow@alpha sparc run tester "full regression suite"
1288
+ \`\`\`
1289
+
1290
+ ### Option 3: Local Installation
1291
+ \`\`\`bash
1292
+ # If claude-flow is installed locally
1293
+ ./claude-flow sparc run tester "full regression suite"
1294
+ \`\`\`
710
1295
 
711
1296
  ## Core Capabilities
712
1297
  - Test planning
@@ -737,7 +1322,33 @@ function createWorkflowManagerMode() {
737
1322
  Process automation with TodoWrite planning and Task execution.
738
1323
 
739
1324
  ## Activation
740
- \`./claude-flow sparc run workflow-manager "automate deployment"\`
1325
+
1326
+ ### Option 1: Using MCP Tools (Preferred in Claude Code)
1327
+ \`\`\`javascript
1328
+ mcp__claude-flow__sparc_mode {
1329
+ mode: "workflow-manager",
1330
+ task_description: "automate deployment",
1331
+ options: {
1332
+ pipeline: "ci-cd",
1333
+ rollback_enabled: true
1334
+ }
1335
+ }
1336
+ \`\`\`
1337
+
1338
+ ### Option 2: Using NPX CLI (Fallback when MCP not available)
1339
+ \`\`\`bash
1340
+ # Use when running from terminal or MCP tools unavailable
1341
+ npx claude-flow sparc run workflow-manager "automate deployment"
1342
+
1343
+ # For alpha features
1344
+ npx claude-flow@alpha sparc run workflow-manager "automate deployment"
1345
+ \`\`\`
1346
+
1347
+ ### Option 3: Local Installation
1348
+ \`\`\`bash
1349
+ # If claude-flow is installed locally
1350
+ ./claude-flow sparc run workflow-manager "automate deployment"
1351
+ \`\`\`
741
1352
 
742
1353
  ## Core Capabilities
743
1354
  - Workflow design