snow-flow 1.4.10 → 1.4.12

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.
@@ -11,7 +11,7 @@
11
11
  "servicenow-automation",
12
12
  "servicenow-security-compliance",
13
13
  "servicenow-reporting-analytics",
14
- "claude-flow",
14
+ "snow-flow",
15
15
  "ruv-swarm"
16
16
  ],
17
17
  "permissions": {
@@ -27,7 +27,7 @@
27
27
  "TodoWrite",
28
28
  "Task(*)",
29
29
  "mcp__servicenow-*",
30
- "mcp__claude-flow__*"
30
+ "mcp__snow-flow__*"
31
31
  ]
32
32
  },
33
33
  "env": {
package/CLAUDE.md CHANGED
@@ -5,6 +5,7 @@
5
5
  **ABSOLUTE RULE**: ALL operations MUST be concurrent/parallel in a single message:
6
6
 
7
7
  ### 🔴 MANDATORY CONCURRENT PATTERNS:
8
+
8
9
  1. **TodoWrite**: ALWAYS batch ALL todos in ONE call (5-10+ todos minimum)
9
10
  2. **Task tool**: ALWAYS spawn ALL agents in ONE message with full instructions
10
11
  3. **File operations**: ALWAYS batch ALL reads/writes/edits in ONE message
@@ -14,6 +15,7 @@
14
15
  ### ⚡ GOLDEN RULE: "1 MESSAGE = ALL RELATED OPERATIONS"
15
16
 
16
17
  **Examples of CORRECT concurrent execution:**
18
+
17
19
  ```javascript
18
20
  // ✅ CORRECT: Everything in ONE message
19
21
  [Single Message]:
@@ -31,6 +33,7 @@
31
33
  ```
32
34
 
33
35
  **Examples of WRONG sequential execution:**
36
+
34
37
  ```javascript
35
38
  // ❌ WRONG: Multiple messages (NEVER DO THIS)
36
39
  Message 1: TodoWrite { todos: [single todo] }
@@ -45,6 +48,7 @@ Message 6: Bash("npm install")
45
48
  ### 🎯 CONCURRENT EXECUTION CHECKLIST:
46
49
 
47
50
  Before sending ANY message, ask yourself:
51
+
48
52
  - ✅ Are ALL related TodoWrite operations batched together?
49
53
  - ✅ Are ALL Task spawning operations in ONE message?
50
54
  - ✅ Are ALL file operations (Read/Write/Edit) batched together?
@@ -54,6 +58,7 @@ Before sending ANY message, ask yourself:
54
58
  If ANY answer is "No", you MUST combine operations into a single message!
55
59
 
56
60
  ## Project Overview
61
+
57
62
  This project combines the SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) methodology with **14 Advanced ServiceNow Features** for systematic Test-Driven Development with AI assistance through Claude-Flow orchestration.
58
63
 
59
64
  **🚀 Batchtools Optimization Enabled**: This configuration includes optimized prompts and parallel processing capabilities for improved performance and efficiency.
@@ -67,6 +72,7 @@ All features work directly with your ServiceNow instance using OAuth authenticat
67
72
  ### **📊 Core Analytics & Performance (Features 1-4)**
68
73
 
69
74
  #### **1. Smart Batch API Operations (`snow_batch_api`)**
75
+
70
76
  - **80% API call reduction** through intelligent batching
71
77
  - **Parallel execution** with transaction support
72
78
  - **Query optimization** and result caching
@@ -76,16 +82,22 @@ All features work directly with your ServiceNow instance using OAuth authenticat
76
82
  // Execute multiple operations in a single transaction
77
83
  snow_batch_api({
78
84
  operations: [
79
- { operation: 'query', table: 'incident', query: 'state=1', fields: ['number', 'short_description'] },
85
+ {
86
+ operation: 'query',
87
+ table: 'incident',
88
+ query: 'state=1',
89
+ fields: ['number', 'short_description'],
90
+ },
80
91
  { operation: 'update', table: 'incident', sys_id: 'xxx', data: { urgency: '1' } },
81
- { operation: 'insert', table: 'problem', data: { short_description: 'System issue' } }
92
+ { operation: 'insert', table: 'problem', data: { short_description: 'System issue' } },
82
93
  ],
83
94
  parallel: true,
84
- transactional: true
85
- })
95
+ transactional: true,
96
+ });
86
97
  ```
87
98
 
88
99
  #### **2. Table Relationship Mapping (`snow_get_table_relationships`)**
100
+
89
101
  - **Deep relationship discovery** across table hierarchies
90
102
  - **Visual relationship diagrams** (Mermaid format)
91
103
  - **Impact analysis** for schema changes
@@ -97,11 +109,12 @@ snow_get_table_relationships({
97
109
  table: 'incident',
98
110
  max_depth: 3,
99
111
  generate_visualization: true,
100
- include_counts: true
101
- })
112
+ include_counts: true,
113
+ });
102
114
  ```
103
115
 
104
116
  #### **3. Query Performance Analyzer (`snow_analyze_query`)**
117
+
105
118
  - **Query execution analysis** with bottleneck detection
106
119
  - **Index recommendations** for performance optimization
107
120
  - **Alternative query suggestions**
@@ -113,11 +126,12 @@ snow_analyze_query({
113
126
  query: 'state=1^priority<=2^assigned_to.manager=javascript:gs.getUserID()',
114
127
  table: 'incident',
115
128
  analyze_indexes: true,
116
- suggest_optimizations: true
117
- })
129
+ suggest_optimizations: true,
130
+ });
118
131
  ```
119
132
 
120
133
  #### **4. Field Usage Intelligence (`snow_analyze_field_usage`)**
134
+
121
135
  - **Comprehensive field usage analysis** across all ServiceNow components
122
136
  - **Unused field detection** with deprecation recommendations
123
137
  - **Technical debt scoring** and optimization opportunities
@@ -130,13 +144,14 @@ snow_analyze_field_usage({
130
144
  analyze_queries: true,
131
145
  analyze_reports: true,
132
146
  analyze_business_rules: true,
133
- unused_threshold_days: 90
134
- })
147
+ unused_threshold_days: 90,
148
+ });
135
149
  ```
136
150
 
137
151
  ### **🔄 Migration & Architecture (Features 5-7)**
138
152
 
139
153
  #### **5. Migration Helper (`snow_create_migration_plan`)**
154
+
140
155
  - **Automated migration planning** with risk assessment
141
156
  - **Data transformation scripts** generation
142
157
  - **Performance impact estimation**
@@ -150,12 +165,13 @@ snow_create_migration_plan({
150
165
  target_table: 'incident',
151
166
  target_changes: {
152
167
  fields_to_add: [{ name: 'u_severity_score', type: 'integer' }],
153
- fields_to_modify: [{ name: 'urgency', new_type: 'choice' }]
154
- }
155
- })
168
+ fields_to_modify: [{ name: 'urgency', new_type: 'choice' }],
169
+ },
170
+ });
156
171
  ```
157
172
 
158
173
  #### **6. Deep Table Analysis (`snow_analyze_table_deep`)**
174
+
159
175
  - **Multi-dimensional table analysis** (structure, data quality, performance)
160
176
  - **Security and compliance** assessment
161
177
  - **Usage pattern analysis** and optimization recommendations
@@ -166,11 +182,12 @@ snow_create_migration_plan({
166
182
  snow_analyze_table_deep({
167
183
  table_name: 'incident',
168
184
  analysis_scope: ['structure', 'data_quality', 'performance', 'security'],
169
- generate_recommendations: true
170
- })
185
+ generate_recommendations: true,
186
+ });
171
187
  ```
172
188
 
173
189
  #### **7. Code Pattern Detector (`snow_detect_code_patterns`)**
190
+
174
191
  - **Advanced pattern recognition** across all script types
175
192
  - **Performance anti-pattern detection**
176
193
  - **Security vulnerability scanning**
@@ -181,13 +198,14 @@ snow_analyze_table_deep({
181
198
  snow_detect_code_patterns({
182
199
  analysis_scope: ['business_rules', 'script_includes', 'workflows'],
183
200
  pattern_categories: ['performance', 'security', 'maintainability'],
184
- max_scripts: 100
185
- })
201
+ max_scripts: 100,
202
+ });
186
203
  ```
187
204
 
188
205
  ### **🔮 AI-Powered Intelligence (Features 8-10)**
189
206
 
190
207
  #### **8. Predictive Impact Analysis (`snow_predict_change_impact`)**
208
+
191
209
  - **AI-powered change impact prediction**
192
210
  - **Risk assessment** with confidence scoring
193
211
  - **Dependency chain analysis**
@@ -200,12 +218,13 @@ snow_predict_change_impact({
200
218
  target_object: 'incident',
201
219
  change_details: {
202
220
  field_changes: ['urgency'],
203
- new_values: { mandatory: true }
204
- }
205
- })
221
+ new_values: { mandatory: true },
222
+ },
223
+ });
206
224
  ```
207
225
 
208
226
  #### **9. Auto Documentation Generator (`snow_generate_documentation`)**
227
+
209
228
  - **Intelligent documentation generation** from code and configuration
210
229
  - **Multiple output formats** (Markdown, HTML, PDF)
211
230
  - **Relationship diagrams** and architecture documentation
@@ -217,11 +236,12 @@ snow_generate_documentation({
217
236
  documentation_scope: ['tables', 'workflows', 'integrations'],
218
237
  target_objects: ['incident', 'problem'],
219
238
  output_format: 'markdown',
220
- include_diagrams: true
221
- })
239
+ include_diagrams: true,
240
+ });
222
241
  ```
223
242
 
224
243
  #### **10. Intelligent Refactoring (`snow_refactor_code`)**
244
+
225
245
  - **AI-driven code refactoring** with performance optimization
226
246
  - **Modern JavaScript patterns** and best practices
227
247
  - **Security hardening** and error handling improvements
@@ -232,13 +252,14 @@ snow_generate_documentation({
232
252
  snow_refactor_code({
233
253
  refactoring_scope: ['business_rules', 'script_includes'],
234
254
  refactoring_goals: ['performance', 'security', 'readability'],
235
- generate_preview: true
236
- })
255
+ generate_preview: true,
256
+ });
237
257
  ```
238
258
 
239
259
  ### **⚙️ Process Mining & Workflow (Features 11-14)**
240
260
 
241
261
  #### **11. Process Mining Engine (`snow_discover_process`)**
262
+
242
263
  - **Real process discovery** from ServiceNow event logs
243
264
  - **Process variant analysis** and bottleneck identification
244
265
  - **Compliance checking** against reference models
@@ -250,11 +271,12 @@ snow_discover_process({
250
271
  process_type: 'incident_management',
251
272
  analysis_period: '30d',
252
273
  include_variants: true,
253
- compliance_analysis: true
254
- })
274
+ compliance_analysis: true,
275
+ });
255
276
  ```
256
277
 
257
278
  #### **12. Workflow Reality Analyzer (`snow_analyze_workflow_execution`)**
279
+
258
280
  - **Real workflow execution analysis** vs. designed processes
259
281
  - **Performance bottleneck identification**
260
282
  - **SLA compliance monitoring**
@@ -266,11 +288,12 @@ snow_analyze_workflow_execution({
266
288
  workflow_type: 'incident',
267
289
  analysis_period: '7d',
268
290
  include_performance_metrics: true,
269
- identify_bottlenecks: true
270
- })
291
+ identify_bottlenecks: true,
292
+ });
271
293
  ```
272
294
 
273
295
  #### **13. Cross Table Process Discovery (`snow_discover_cross_table_process`)**
296
+
274
297
  - **Multi-table process flow discovery**
275
298
  - **Data lineage and transformation tracking**
276
299
  - **Integration point analysis**
@@ -282,11 +305,12 @@ snow_discover_cross_table_process({
282
305
  start_table: 'incident',
283
306
  end_tables: ['problem', 'change_request'],
284
307
  analysis_period: '90d',
285
- include_data_flow: true
286
- })
308
+ include_data_flow: true,
309
+ });
287
310
  ```
288
311
 
289
312
  #### **14. Real Time Process Monitoring (`snow_monitor_process`)**
313
+
290
314
  - **Live process monitoring** with real-time alerts
291
315
  - **Anomaly detection** using machine learning
292
316
  - **Performance trend analysis**
@@ -298,8 +322,8 @@ snow_monitor_process({
298
322
  process_name: 'incident_resolution',
299
323
  tables_to_monitor: ['incident', 'task'],
300
324
  monitoring_duration: '24h',
301
- enable_anomaly_detection: true
302
- })
325
+ enable_anomaly_detection: true,
326
+ });
303
327
  ```
304
328
 
305
329
  ### **🚀 Performance Metrics & Benefits**
@@ -322,29 +346,32 @@ snow_monitor_process({
322
346
 
323
347
  ```bash
324
348
  # Quick ServiceNow analysis
325
- npx claude-flow sparc run servicenow-analyzer "Analyze incident table performance and suggest optimizations"
349
+ npx snow-flow sparc run servicenow-analyzer "Analyze incident table performance and suggest optimizations"
326
350
 
327
351
  # Comprehensive process mining
328
- npx claude-flow swarm "Discover all incident management processes and identify bottlenecks" --strategy analysis --auto-deploy
352
+ npx snow-flow swarm "Discover all incident management processes and identify bottlenecks" --strategy analysis --auto-deploy
329
353
 
330
354
  # Real-time monitoring setup
331
- npx claude-flow sparc run servicenow-monitor "Setup real-time monitoring for change management processes"
355
+ npx snow-flow sparc run servicenow-monitor "Setup real-time monitoring for change management processes"
332
356
  ```
333
357
 
334
358
  ## SPARC Development Commands
335
359
 
336
360
  ### Core SPARC Commands
337
- - `npx claude-flow sparc modes`: List all available SPARC development modes
338
- - `npx claude-flow sparc run <mode> "<task>"`: Execute specific SPARC mode for a task
339
- - `npx claude-flow sparc tdd "<feature>"`: Run complete TDD workflow using SPARC methodology
340
- - `npx claude-flow sparc info <mode>`: Get detailed information about a specific mode
361
+
362
+ - `npx snow-flow sparc modes`: List all available SPARC development modes
363
+ - `npx snow-flow sparc run <mode> "<task>"`: Execute specific SPARC mode for a task
364
+ - `npx snow-flow sparc tdd "<feature>"`: Run complete TDD workflow using SPARC methodology
365
+ - `npx snow-flow sparc info <mode>`: Get detailed information about a specific mode
341
366
 
342
367
  ### Batchtools Commands (Optimized)
343
- - `npx claude-flow sparc batch <modes> "<task>"`: Execute multiple SPARC modes in parallel
344
- - `npx claude-flow sparc pipeline "<task>"`: Execute full SPARC pipeline with parallel processing
345
- - `npx claude-flow sparc concurrent <mode> "<tasks-file>"`: Process multiple tasks concurrently
368
+
369
+ - `npx snow-flow sparc batch <modes> "<task>"`: Execute multiple SPARC modes in parallel
370
+ - `npx snow-flow sparc pipeline "<task>"`: Execute full SPARC pipeline with parallel processing
371
+ - `npx snow-flow sparc concurrent <mode> "<tasks-file>"`: Process multiple tasks concurrently
346
372
 
347
373
  ### Standard Build Commands
374
+
348
375
  - `npm run build`: Build the project
349
376
  - `npm run test`: Run the test suite
350
377
  - `npm run lint`: Run linter and format checks
@@ -353,49 +380,61 @@ npx claude-flow sparc run servicenow-monitor "Setup real-time monitoring for cha
353
380
  ## SPARC Methodology Workflow (Batchtools Enhanced)
354
381
 
355
382
  ### 1. Specification Phase (Parallel Analysis)
383
+
356
384
  ```bash
357
385
  # Create detailed specifications with concurrent requirements analysis
358
- npx claude-flow sparc run spec-pseudocode "Define user authentication requirements" --parallel
386
+ npx snow-flow sparc run spec-pseudocode "Define user authentication requirements" --parallel
359
387
  ```
388
+
360
389
  **Batchtools Optimization**: Simultaneously analyze multiple requirement sources, validate constraints in parallel, and generate comprehensive specifications.
361
390
 
362
391
  ### 2. Pseudocode Phase (Concurrent Logic Design)
392
+
363
393
  ```bash
364
394
  # Develop algorithmic logic with parallel pattern analysis
365
- npx claude-flow sparc run spec-pseudocode "Create authentication flow pseudocode" --batch-optimize
395
+ npx snow-flow sparc run spec-pseudocode "Create authentication flow pseudocode" --batch-optimize
366
396
  ```
397
+
367
398
  **Batchtools Optimization**: Process multiple algorithm patterns concurrently, validate logic flows in parallel, and optimize data structures simultaneously.
368
399
 
369
400
  ### 3. Architecture Phase (Parallel Component Design)
401
+
370
402
  ```bash
371
403
  # Design system architecture with concurrent component analysis
372
- npx claude-flow sparc run architect "Design authentication service architecture" --parallel
404
+ npx snow-flow sparc run architect "Design authentication service architecture" --parallel
373
405
  ```
406
+
374
407
  **Batchtools Optimization**: Generate multiple architectural alternatives simultaneously, validate integration points in parallel, and create comprehensive documentation concurrently.
375
408
 
376
409
  ### 4. Refinement Phase (Parallel TDD Implementation)
410
+
377
411
  ```bash
378
412
  # Execute Test-Driven Development with parallel test generation
379
- npx claude-flow sparc tdd "implement user authentication system" --batch-tdd
413
+ npx snow-flow sparc tdd "implement user authentication system" --batch-tdd
380
414
  ```
415
+
381
416
  **Batchtools Optimization**: Generate multiple test scenarios simultaneously, implement and validate code in parallel, and optimize performance concurrently.
382
417
 
383
418
  ### 5. Completion Phase (Concurrent Integration)
419
+
384
420
  ```bash
385
421
  # Integration with parallel validation and documentation
386
- npx claude-flow sparc run integration "integrate authentication with user management" --parallel
422
+ npx snow-flow sparc run integration "integrate authentication with user management" --parallel
387
423
  ```
424
+
388
425
  **Batchtools Optimization**: Run integration tests in parallel, generate documentation concurrently, and validate requirements simultaneously.
389
426
 
390
427
  ## Batchtools Integration Features
391
428
 
392
429
  ### Parallel Processing Capabilities
430
+
393
431
  - **Concurrent File Operations**: Read, analyze, and modify multiple files simultaneously
394
432
  - **Parallel Code Analysis**: Analyze dependencies, patterns, and architecture concurrently
395
433
  - **Batch Test Generation**: Create comprehensive test suites in parallel
396
434
  - **Concurrent Documentation**: Generate multiple documentation formats simultaneously
397
435
 
398
436
  ### Performance Optimizations
437
+
399
438
  - **Smart Batching**: Group related operations for optimal performance
400
439
  - **Pipeline Processing**: Chain dependent operations with parallel stages
401
440
  - **Resource Management**: Efficient utilization of system resources
@@ -404,6 +443,7 @@ npx claude-flow sparc run integration "integrate authentication with user manage
404
443
  ## Performance Benchmarks
405
444
 
406
445
  ### Batchtools Performance Improvements
446
+
407
447
  - **File Operations**: Up to 300% faster with parallel processing
408
448
  - **Code Analysis**: 250% improvement with concurrent pattern recognition
409
449
  - **Test Generation**: 400% faster with parallel test creation
@@ -413,6 +453,7 @@ npx claude-flow sparc run integration "integrate authentication with user manage
413
453
  ## Code Style and Best Practices (Batchtools Enhanced)
414
454
 
415
455
  ### SPARC Development Principles with Batchtools
456
+
416
457
  - **Modular Design**: Keep files under 500 lines, optimize with parallel analysis
417
458
  - **Environment Safety**: Never hardcode secrets, validate with concurrent checks
418
459
  - **Test-First**: Always write tests before implementation using parallel generation
@@ -420,6 +461,7 @@ npx claude-flow sparc run integration "integrate authentication with user manage
420
461
  - **Parallel Documentation**: Maintain clear, up-to-date documentation with concurrent updates
421
462
 
422
463
  ### Batchtools Best Practices
464
+
423
465
  - **Parallel Operations**: Use batchtools for independent tasks
424
466
  - **Concurrent Validation**: Validate multiple aspects simultaneously
425
467
  - **Batch Processing**: Group similar operations for efficiency
@@ -446,7 +488,7 @@ npx claude-flow sparc run integration "integrate authentication with user manage
446
488
  // ✅ CORRECT: Concurrent agent deployment
447
489
  [Single Message]:
448
490
  - Task("Agent 1", "full instructions", "agent-type-1")
449
- - Task("Agent 2", "full instructions", "agent-type-2")
491
+ - Task("Agent 2", "full instructions", "agent-type-2")
450
492
  - Task("Agent 3", "full instructions", "agent-type-3")
451
493
  - Task("Agent 4", "full instructions", "agent-type-4")
452
494
  - Task("Agent 5", "full instructions", "agent-type-5")
@@ -455,6 +497,7 @@ npx claude-flow sparc run integration "integrate authentication with user manage
455
497
  ### 📋 Agent Categories & Concurrent Patterns
456
498
 
457
499
  #### **Core Development Agents**
500
+
458
501
  - `coder` - Implementation specialist
459
502
  - `reviewer` - Code quality assurance
460
503
  - `tester` - Test creation and validation
@@ -462,16 +505,18 @@ npx claude-flow sparc run integration "integrate authentication with user manage
462
505
  - `researcher` - Information gathering
463
506
 
464
507
  **Concurrent Usage:**
508
+
465
509
  ```bash
466
510
  # Deploy full development swarm
467
511
  Task("Research requirements", "...", "researcher")
468
- Task("Plan architecture", "...", "planner")
512
+ Task("Plan architecture", "...", "planner")
469
513
  Task("Implement features", "...", "coder")
470
514
  Task("Create tests", "...", "tester")
471
515
  Task("Review code", "...", "reviewer")
472
516
  ```
473
517
 
474
518
  #### **Swarm Coordination Agents**
519
+
475
520
  - `hierarchical-coordinator` - Queen-led coordination
476
521
  - `mesh-coordinator` - Peer-to-peer networks
477
522
  - `adaptive-coordinator` - Dynamic topology
@@ -479,6 +524,7 @@ Task("Review code", "...", "reviewer")
479
524
  - `swarm-memory-manager` - Distributed memory
480
525
 
481
526
  **Concurrent Swarm Deployment:**
527
+
482
528
  ```bash
483
529
  # Deploy multi-topology coordination
484
530
  Task("Hierarchical coordination", "...", "hierarchical-coordinator")
@@ -487,6 +533,7 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
487
533
  ```
488
534
 
489
535
  #### **Consensus & Distributed Systems**
536
+
490
537
  - `byzantine-coordinator` - Byzantine fault tolerance
491
538
  - `raft-manager` - Leader election protocols
492
539
  - `gossip-coordinator` - Epidemic dissemination
@@ -496,6 +543,7 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
496
543
  - `security-manager` - Cryptographic security
497
544
 
498
545
  #### **Performance & Optimization**
546
+
499
547
  - `perf-analyzer` - Bottleneck identification
500
548
  - `performance-benchmarker` - Performance testing
501
549
  - `task-orchestrator` - Workflow optimization
@@ -503,6 +551,7 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
503
551
  - `smart-agent` - Intelligent coordination
504
552
 
505
553
  #### **GitHub & Repository Management**
554
+
506
555
  - `github-modes` - Comprehensive GitHub integration
507
556
  - `pr-manager` - Pull request management
508
557
  - `code-review-swarm` - Multi-agent code review
@@ -514,6 +563,7 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
514
563
  - `multi-repo-swarm` - Cross-repository coordination
515
564
 
516
565
  #### **SPARC Methodology Agents**
566
+
517
567
  - `sparc-coord` - SPARC orchestration
518
568
  - `sparc-coder` - TDD implementation
519
569
  - `specification` - Requirements analysis
@@ -522,6 +572,7 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
522
572
  - `refinement` - Iterative improvement
523
573
 
524
574
  #### **Specialized Development**
575
+
525
576
  - `backend-dev` - API development
526
577
  - `mobile-dev` - React Native development
527
578
  - `ml-developer` - Machine learning
@@ -532,19 +583,22 @@ Task("Adaptive optimization", "...", "adaptive-coordinator")
532
583
  - `base-template-generator` - Boilerplate creation
533
584
 
534
585
  #### **Testing & Validation**
586
+
535
587
  - `tdd-london-swarm` - Mock-driven TDD
536
588
  - `production-validator` - Real implementation validation
537
589
 
538
590
  #### **Migration & Planning**
591
+
539
592
  - `migration-planner` - System migrations
540
593
  - `swarm-init` - Topology initialization
541
594
 
542
595
  ### 🎯 Concurrent Agent Patterns
543
596
 
544
597
  #### **Full-Stack Development Swarm (8 agents)**
598
+
545
599
  ```bash
546
600
  Task("System architecture", "...", "system-architect")
547
- Task("Backend APIs", "...", "backend-dev")
601
+ Task("Backend APIs", "...", "backend-dev")
548
602
  Task("Frontend mobile", "...", "mobile-dev")
549
603
  Task("Database design", "...", "coder")
550
604
  Task("API documentation", "...", "api-docs")
@@ -554,16 +608,18 @@ Task("Production validation", "...", "production-validator")
554
608
  ```
555
609
 
556
610
  #### **Distributed System Swarm (6 agents)**
611
+
557
612
  ```bash
558
613
  Task("Byzantine consensus", "...", "byzantine-coordinator")
559
614
  Task("Raft coordination", "...", "raft-manager")
560
- Task("Gossip protocols", "...", "gossip-coordinator")
615
+ Task("Gossip protocols", "...", "gossip-coordinator")
561
616
  Task("CRDT synchronization", "...", "crdt-synchronizer")
562
617
  Task("Security management", "...", "security-manager")
563
618
  Task("Performance monitoring", "...", "perf-analyzer")
564
619
  ```
565
620
 
566
621
  #### **GitHub Workflow Swarm (5 agents)**
622
+
567
623
  ```bash
568
624
  Task("PR management", "...", "pr-manager")
569
625
  Task("Code review", "...", "code-review-swarm")
@@ -573,10 +629,11 @@ Task("Workflow automation", "...", "workflow-automation")
573
629
  ```
574
630
 
575
631
  #### **SPARC TDD Swarm (7 agents)**
632
+
576
633
  ```bash
577
634
  Task("Requirements spec", "...", "specification")
578
635
  Task("Algorithm design", "...", "pseudocode")
579
- Task("System architecture", "...", "architecture")
636
+ Task("System architecture", "...", "architecture")
580
637
  Task("TDD implementation", "...", "sparc-coder")
581
638
  Task("London school tests", "...", "tdd-london-swarm")
582
639
  Task("Iterative refinement", "...", "refinement")
@@ -586,25 +643,30 @@ Task("Production validation", "...", "production-validator")
586
643
  ### ⚡ Performance Optimization
587
644
 
588
645
  **Agent Selection Strategy:**
646
+
589
647
  - **High Priority**: Use 3-5 agents max for critical path
590
648
  - **Medium Priority**: Use 5-8 agents for complex features
591
649
  - **Large Projects**: Use 8+ agents with proper coordination
592
650
 
593
651
  **Memory Management:**
652
+
594
653
  - Use `memory-coordinator` for cross-agent state
595
654
  - Implement `swarm-memory-manager` for distributed coordination
596
655
  - Apply `collective-intelligence-coordinator` for decision-making
597
656
 
598
- For more information about SPARC methodology and batchtools optimization, see:
657
+ For more information about SPARC methodology and batchtools optimization, see:
658
+
599
659
  - SPARC Guide: https://github.com/ruvnet/claude-code-flow/docs/sparc.md
600
660
  - Batchtools Documentation: https://github.com/ruvnet/claude-code-flow/docs/batchtools.md
601
661
 
602
662
  # important-instruction-reminders
663
+
603
664
  Message 3: Task("Agent 2")
604
665
  Message 4: Read("file1.js")
605
666
  Message 5: Write("output1.js")
606
667
  Message 6: Bash("npm install")
607
668
  // This is 6x slower and breaks coordination!
669
+
608
670
  ```
609
671
 
610
672
  ### 🎯 CONCURRENT EXECUTION CHECKLIST:
@@ -675,17 +737,17 @@ If ANY answer is "No", you MUST combine operations into a single message!
675
737
 
676
738
  **✅ CORRECT Workflow:**
677
739
 
678
- 1. **MCP**: `mcp__claude-flow__swarm_init` (coordination setup)
679
- 2. **MCP**: `mcp__claude-flow__agent_spawn` (planning agents)
680
- 3. **MCP**: `mcp__claude-flow__task_orchestrate` (task coordination)
740
+ 1. **MCP**: `mcp__snow-flow__swarm_init` (coordination setup)
741
+ 2. **MCP**: `mcp__snow-flow__agent_spawn` (planning agents)
742
+ 3. **MCP**: `mcp__snow-flow__task_orchestrate` (task coordination)
681
743
  4. **Claude Code**: `Task` tool to spawn agents with coordination instructions
682
744
  5. **Claude Code**: `TodoWrite` with ALL todos batched (5-10+ in ONE call)
683
745
  6. **Claude Code**: `Read`, `Write`, `Edit`, `Bash` (actual work)
684
- 7. **MCP**: `mcp__claude-flow__memory_usage` (store results)
746
+ 7. **MCP**: `mcp__snow-flow__memory_usage` (store results)
685
747
 
686
748
  **❌ WRONG Workflow:**
687
749
 
688
- 1. **MCP**: `mcp__claude-flow__terminal_execute` (DON'T DO THIS)
750
+ 1. **MCP**: `mcp__snow-flow__terminal_execute` (DON'T DO THIS)
689
751
  2. **MCP**: File creation via MCP (DON'T DO THIS)
690
752
  3. **MCP**: Code generation via MCP (DON'T DO THIS)
691
753
  4. **Claude Code**: Sequential Task calls (DON'T DO THIS)
@@ -709,8 +771,10 @@ If ANY answer is "No", you MUST combine operations into a single message!
709
771
  ### ⚡ THE GOLDEN RULE OF SWARMS
710
772
 
711
773
  ```
774
+
712
775
  If you need to do X operations, they should be in 1 message, not X messages
713
- ```
776
+
777
+ ````
714
778
 
715
779
  ### 🚨 MANDATORY TODO AND TASK BATCHING
716
780
 
@@ -728,12 +792,12 @@ If you need to do X operations, they should be in 1 message, not X messages
728
792
  ```javascript
729
793
  [Single Message with BatchTool]:
730
794
  // MCP coordination setup
731
- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }
732
- mcp__claude-flow__agent_spawn { type: "researcher" }
733
- mcp__claude-flow__agent_spawn { type: "coder" }
734
- mcp__claude-flow__agent_spawn { type: "analyst" }
735
- mcp__claude-flow__agent_spawn { type: "tester" }
736
- mcp__claude-flow__agent_spawn { type: "coordinator" }
795
+ mcp__snow-flow__swarm_init { topology: "mesh", maxAgents: 6 }
796
+ mcp__snow-flow__agent_spawn { type: "researcher" }
797
+ mcp__snow-flow__agent_spawn { type: "coder" }
798
+ mcp__snow-flow__agent_spawn { type: "analyst" }
799
+ mcp__snow-flow__agent_spawn { type: "tester" }
800
+ mcp__snow-flow__agent_spawn { type: "coordinator" }
737
801
 
738
802
  // Claude Code execution - ALL in parallel
739
803
  Task("You are researcher agent. MUST coordinate via hooks...")
@@ -747,12 +811,12 @@ If you need to do X operations, they should be in 1 message, not X messages
747
811
  Write "app/package.json"
748
812
  Write "app/README.md"
749
813
  Write "app/src/index.js"
750
- ```
814
+ ````
751
815
 
752
816
  **❌ WRONG - Multiple Messages (NEVER DO THIS):**
753
817
 
754
818
  ```javascript
755
- Message 1: mcp__claude-flow__swarm_init
819
+ Message 1: mcp__snow-flow__swarm_init
756
820
  Message 2: Task("researcher agent")
757
821
  Message 3: Task("coder agent")
758
822
  Message 4: TodoWrite({ todo: "single todo" })
@@ -794,8 +858,8 @@ Message 6: Write "package.json"
794
858
  ### 1. Add MCP Server (Stdio - No Port Needed)
795
859
 
796
860
  ```bash
797
- # Add Claude Flow MCP server to Claude Code using stdio
798
- claude mcp add claude-flow npx claude-flow@alpha mcp start
861
+ # Add Snow Flow MCP server to Claude Code using stdio
862
+ claude mcp add snow-flow npx snow-flow@alpha mcp start
799
863
  ```
800
864
 
801
865
  ### 2. Use MCP Tools for Coordination in Claude Code
@@ -804,19 +868,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
804
868
 
805
869
  **Initialize a swarm:**
806
870
 
807
- - Use the `mcp__claude-flow__swarm_init` tool to set up coordination topology
871
+ - Use the `mcp__snow-flow__swarm_init` tool to set up coordination topology
808
872
  - Choose: mesh, hierarchical, ring, or star
809
873
  - This creates a coordination framework for Claude Code's work
810
874
 
811
875
  **Spawn agents:**
812
876
 
813
- - Use `mcp__claude-flow__agent_spawn` tool to create specialized coordinators
877
+ - Use `mcp__snow-flow__agent_spawn` tool to create specialized coordinators
814
878
  - Agent types represent different thinking patterns, not actual coders
815
879
  - They help Claude Code approach problems from different angles
816
880
 
817
881
  **Orchestrate tasks:**
818
882
 
819
- - Use `mcp__claude-flow__task_orchestrate` tool to coordinate complex workflows
883
+ - Use `mcp__snow-flow__task_orchestrate` tool to coordinate complex workflows
820
884
  - This breaks down tasks for Claude Code to execute systematically
821
885
  - The agents don't write code - they coordinate Claude Code's actions
822
886
 
@@ -824,38 +888,38 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
824
888
 
825
889
  ### Coordination Tools:
826
890
 
827
- - `mcp__claude-flow__swarm_init` - Set up coordination topology for Claude Code
828
- - `mcp__claude-flow__agent_spawn` - Create cognitive patterns to guide Claude Code
829
- - `mcp__claude-flow__task_orchestrate` - Break down and coordinate complex tasks
891
+ - `mcp__snow-flow__swarm_init` - Set up coordination topology for Claude Code
892
+ - `mcp__snow-flow__agent_spawn` - Create cognitive patterns to guide Claude Code
893
+ - `mcp__snow-flow__task_orchestrate` - Break down and coordinate complex tasks
830
894
 
831
895
  ### Monitoring Tools:
832
896
 
833
- - `mcp__claude-flow__swarm_status` - Monitor coordination effectiveness
834
- - `mcp__claude-flow__agent_list` - View active cognitive patterns
835
- - `mcp__claude-flow__agent_metrics` - Track coordination performance
836
- - `mcp__claude-flow__task_status` - Check workflow progress
837
- - `mcp__claude-flow__task_results` - Review coordination outcomes
897
+ - `mcp__snow-flow__swarm_status` - Monitor coordination effectiveness
898
+ - `mcp__snow-flow__agent_list` - View active cognitive patterns
899
+ - `mcp__snow-flow__agent_metrics` - Track coordination performance
900
+ - `mcp__snow-flow__task_status` - Check workflow progress
901
+ - `mcp__snow-flow__task_results` - Review coordination outcomes
838
902
 
839
903
  ### Memory & Neural Tools:
840
904
 
841
- - `mcp__claude-flow__memory_usage` - Persistent memory across sessions
842
- - `mcp__claude-flow__neural_status` - Neural pattern effectiveness
843
- - `mcp__claude-flow__neural_train` - Improve coordination patterns
844
- - `mcp__claude-flow__neural_patterns` - Analyze thinking approaches
905
+ - `mcp__snow-flow__memory_usage` - Persistent memory across sessions
906
+ - `mcp__snow-flow__neural_status` - Neural pattern effectiveness
907
+ - `mcp__snow-flow__neural_train` - Improve coordination patterns
908
+ - `mcp__snow-flow__neural_patterns` - Analyze thinking approaches
845
909
 
846
910
  ### GitHub Integration Tools (NEW!):
847
911
 
848
- - `mcp__claude-flow__github_swarm` - Create specialized GitHub management swarms
849
- - `mcp__claude-flow__repo_analyze` - Deep repository analysis with AI
850
- - `mcp__claude-flow__pr_enhance` - AI-powered pull request improvements
851
- - `mcp__claude-flow__issue_triage` - Intelligent issue classification
852
- - `mcp__claude-flow__code_review` - Automated code review with swarms
912
+ - `mcp__snow-flow__github_swarm` - Create specialized GitHub management swarms
913
+ - `mcp__snow-flow__repo_analyze` - Deep repository analysis with AI
914
+ - `mcp__snow-flow__pr_enhance` - AI-powered pull request improvements
915
+ - `mcp__snow-flow__issue_triage` - Intelligent issue classification
916
+ - `mcp__snow-flow__code_review` - Automated code review with swarms
853
917
 
854
918
  ### System Tools:
855
919
 
856
- - `mcp__claude-flow__benchmark_run` - Measure coordination efficiency
857
- - `mcp__claude-flow__features_detect` - Available capabilities
858
- - `mcp__claude-flow__swarm_monitor` - Real-time coordination tracking
920
+ - `mcp__snow-flow__benchmark_run` - Measure coordination efficiency
921
+ - `mcp__snow-flow__features_detect` - Available capabilities
922
+ - `mcp__snow-flow__swarm_monitor` - Real-time coordination tracking
859
923
 
860
924
  ## Workflow Examples (Coordination-Focused)
861
925
 
@@ -865,31 +929,31 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
865
929
 
866
930
  **Step 1:** Set up research coordination
867
931
 
868
- - Tool: `mcp__claude-flow__swarm_init`
932
+ - Tool: `mcp__snow-flow__swarm_init`
869
933
  - Parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`
870
934
  - Result: Creates a mesh topology for comprehensive exploration
871
935
 
872
936
  **Step 2:** Define research perspectives
873
937
 
874
- - Tool: `mcp__claude-flow__agent_spawn`
938
+ - Tool: `mcp__snow-flow__agent_spawn`
875
939
  - Parameters: `{"type": "researcher", "name": "Literature Review"}`
876
- - Tool: `mcp__claude-flow__agent_spawn`
940
+ - Tool: `mcp__snow-flow__agent_spawn`
877
941
  - Parameters: `{"type": "analyst", "name": "Data Analysis"}`
878
942
  - Result: Different cognitive patterns for Claude Code to use
879
943
 
880
944
  **Step 3:** Coordinate research execution
881
945
 
882
- - Tool: `mcp__claude-flow__task_orchestrate`
946
+ - Tool: `mcp__snow-flow__task_orchestrate`
883
947
  - Parameters: `{"task": "Research neural architecture search papers", "strategy": "adaptive"}`
884
948
  - Result: Claude Code systematically searches, reads, and analyzes papers
885
949
 
886
950
  **What Actually Happens:**
887
951
 
888
952
  1. The swarm sets up a coordination framework
889
- 2. Each agent MUST use Claude Flow hooks for coordination:
890
- - `npx claude-flow@alpha hooks pre-task` before starting
891
- - `npx claude-flow@alpha hooks post-edit` after each file operation
892
- - `npx claude-flow@alpha hooks notify` to share decisions
953
+ 2. Each agent MUST use Snow Flow hooks for coordination:
954
+ - `npx snow-flow hooks pre-task` before starting
955
+ - `npx snow-flow hooks post-edit` after each file operation
956
+ - `npx snow-flow hooks notify` to share decisions
893
957
  3. Claude Code uses its native Read, WebSearch, and Task tools
894
958
  4. The swarm coordinates through shared memory and hooks
895
959
  5. Results are synthesized by Claude Code with full coordination history
@@ -900,19 +964,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
900
964
 
901
965
  **Step 1:** Set up development coordination
902
966
 
903
- - Tool: `mcp__claude-flow__swarm_init`
967
+ - Tool: `mcp__snow-flow__swarm_init`
904
968
  - Parameters: `{"topology": "hierarchical", "maxAgents": 8, "strategy": "specialized"}`
905
969
  - Result: Hierarchical structure for organized development
906
970
 
907
971
  **Step 2:** Define development perspectives
908
972
 
909
- - Tool: `mcp__claude-flow__agent_spawn`
973
+ - Tool: `mcp__snow-flow__agent_spawn`
910
974
  - Parameters: `{"type": "architect", "name": "System Design"}`
911
975
  - Result: Architectural thinking pattern for Claude Code
912
976
 
913
977
  **Step 3:** Coordinate implementation
914
978
 
915
- - Tool: `mcp__claude-flow__task_orchestrate`
979
+ - Tool: `mcp__snow-flow__task_orchestrate`
916
980
  - Parameters: `{"task": "Implement user authentication with JWT", "strategy": "parallel"}`
917
981
  - Result: Claude Code implements features using its native tools
918
982
 
@@ -933,19 +997,19 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
933
997
 
934
998
  **Step 1:** Initialize GitHub swarm
935
999
 
936
- - Tool: `mcp__claude-flow__github_swarm`
1000
+ - Tool: `mcp__snow-flow__github_swarm`
937
1001
  - Parameters: `{"repository": "owner/repo", "agents": 5, "focus": "maintenance"}`
938
1002
  - Result: Specialized swarm for repository management
939
1003
 
940
1004
  **Step 2:** Analyze repository health
941
1005
 
942
- - Tool: `mcp__claude-flow__repo_analyze`
1006
+ - Tool: `mcp__snow-flow__repo_analyze`
943
1007
  - Parameters: `{"deep": true, "include": ["issues", "prs", "code"]}`
944
1008
  - Result: Comprehensive repository analysis
945
1009
 
946
1010
  **Step 3:** Enhance pull requests
947
1011
 
948
- - Tool: `mcp__claude-flow__pr_enhance`
1012
+ - Tool: `mcp__snow-flow__pr_enhance`
949
1013
  - Parameters: `{"pr_number": 123, "add_tests": true, "improve_docs": true}`
950
1014
  - Result: AI-powered PR improvements
951
1015
 
@@ -1063,13 +1127,13 @@ See `.claude/commands/` for detailed documentation on all features.
1063
1127
  1. **SPAWN ALL AGENTS IN ONE BATCH** - Use multiple tool calls in a SINGLE message
1064
1128
  2. **EXECUTE TASKS IN PARALLEL** - Never wait for one task before starting another
1065
1129
  3. **USE BATCHTOOL FOR EVERYTHING** - Multiple operations = Single message with multiple tools
1066
- 4. **ALL AGENTS MUST USE COORDINATION TOOLS** - Every spawned agent MUST use claude-flow hooks and memory
1130
+ 4. **ALL AGENTS MUST USE COORDINATION TOOLS** - Every spawned agent MUST use snow-flow hooks and memory
1067
1131
 
1068
1132
  ### 🎯 AGENT COUNT CONFIGURATION
1069
1133
 
1070
1134
  **CRITICAL: Dynamic Agent Count Rules**
1071
1135
 
1072
- 1. **Check CLI Arguments First**: If user runs `npx claude-flow@alpha --agents 5`, use 5 agents
1136
+ 1. **Check CLI Arguments First**: If user runs `npx snow-flow --agents 5`, use 5 agents
1073
1137
  2. **Auto-Decide if No Args**: Without CLI args, analyze task complexity:
1074
1138
  - Simple tasks (1-3 components): 3-4 agents
1075
1139
  - Medium tasks (4-6 components): 5-7 agents
@@ -1083,7 +1147,7 @@ See `.claude/commands/` for detailed documentation on all features.
1083
1147
  **Example Auto-Decision Logic:**
1084
1148
 
1085
1149
  ```javascript
1086
- // If CLI args provided: npx claude-flow@alpha --agents 6
1150
+ // If CLI args provided: npx snow-flow --agents 6
1087
1151
  maxAgents = CLI_ARGS.agents || determineAgentCount(task);
1088
1152
 
1089
1153
  function determineAgentCount(task) {
@@ -1105,29 +1169,29 @@ When you spawn an agent using the Task tool, that agent MUST:
1105
1169
 
1106
1170
  ```bash
1107
1171
  # Check previous work and load context
1108
- npx claude-flow@alpha hooks pre-task --description "[agent task]" --auto-spawn-agents false
1109
- npx claude-flow@alpha hooks session-restore --session-id "swarm-[id]" --load-memory true
1172
+ npx snow-flow hooks pre-task --description "[agent task]" --auto-spawn-agents false
1173
+ npx snow-flow hooks session-restore --session-id "swarm-[id]" --load-memory true
1110
1174
  ```
1111
1175
 
1112
1176
  **2️⃣ DURING Work (After EVERY Major Step):**
1113
1177
 
1114
1178
  ```bash
1115
1179
  # Store progress in memory after each file operation
1116
- npx claude-flow@alpha hooks post-edit --file "[filepath]" --memory-key "swarm/[agent]/[step]"
1180
+ npx snow-flow hooks post-edit --file "[filepath]" --memory-key "swarm/[agent]/[step]"
1117
1181
 
1118
1182
  # Store decisions and findings
1119
- npx claude-flow@alpha hooks notify --message "[what was done]" --telemetry true
1183
+ npx snow-flow hooks notify --message "[what was done]" --telemetry true
1120
1184
 
1121
1185
  # Check coordination with other agents
1122
- npx claude-flow@alpha hooks pre-search --query "[what to check]" --cache-results true
1186
+ npx snow-flow hooks pre-search --query "[what to check]" --cache-results true
1123
1187
  ```
1124
1188
 
1125
1189
  **3️⃣ AFTER Completing Work:**
1126
1190
 
1127
1191
  ```bash
1128
1192
  # Save all results and learnings
1129
- npx claude-flow@alpha hooks post-task --task-id "[task]" --analyze-performance true
1130
- npx claude-flow@alpha hooks session-end --export-metrics true --generate-summary true
1193
+ npx snow-flow hooks post-task --task-id "[task]" --analyze-performance true
1194
+ npx snow-flow hooks session-end --export-metrics true --generate-summary true
1131
1195
  ```
1132
1196
 
1133
1197
  ### 🎯 AGENT PROMPT TEMPLATE
@@ -1138,10 +1202,10 @@ When spawning agents, ALWAYS include these coordination instructions:
1138
1202
  You are the [Agent Type] agent in a coordinated swarm.
1139
1203
 
1140
1204
  MANDATORY COORDINATION:
1141
- 1. START: Run `npx claude-flow@alpha hooks pre-task --description "[your task]"`
1142
- 2. DURING: After EVERY file operation, run `npx claude-flow@alpha hooks post-edit --file "[file]" --memory-key "agent/[step]"`
1143
- 3. MEMORY: Store ALL decisions using `npx claude-flow@alpha hooks notify --message "[decision]"`
1144
- 4. END: Run `npx claude-flow@alpha hooks post-task --task-id "[task]" --analyze-performance true`
1205
+ 1. START: Run `npx snow-flow hooks pre-task --description "[your task]"`
1206
+ 2. DURING: After EVERY file operation, run `npx snow-flow hooks post-edit --file "[file]" --memory-key "agent/[step]"`
1207
+ 3. MEMORY: Store ALL decisions using `npx snow-flow hooks notify --message "[decision]"`
1208
+ 4. END: Run `npx snow-flow hooks post-task --task-id "[task]" --analyze-performance true`
1145
1209
 
1146
1210
  Your specific task: [detailed task description]
1147
1211
 
@@ -1166,12 +1230,12 @@ Message 6: TodoWrite (another single todo)
1166
1230
  ```
1167
1231
  Message 1: [BatchTool]
1168
1232
  // MCP coordination setup
1169
- - mcp__claude-flow__swarm_init
1170
- - mcp__claude-flow__agent_spawn (researcher)
1171
- - mcp__claude-flow__agent_spawn (coder)
1172
- - mcp__claude-flow__agent_spawn (analyst)
1173
- - mcp__claude-flow__agent_spawn (tester)
1174
- - mcp__claude-flow__agent_spawn (coordinator)
1233
+ - mcp__snow-flow__swarm_init
1234
+ - mcp__snow-flow__agent_spawn (researcher)
1235
+ - mcp__snow-flow__agent_spawn (coder)
1236
+ - mcp__snow-flow__agent_spawn (analyst)
1237
+ - mcp__snow-flow__agent_spawn (tester)
1238
+ - mcp__snow-flow__agent_spawn (coordinator)
1175
1239
 
1176
1240
  Message 2: [BatchTool - Claude Code execution]
1177
1241
  // Task agents with full coordination instructions
@@ -1205,7 +1269,7 @@ When given ANY complex task with swarms:
1205
1269
  STEP 1: IMMEDIATE PARALLEL SPAWN (Single Message!)
1206
1270
  [BatchTool]:
1207
1271
  // IMPORTANT: Check CLI args for agent count, otherwise auto-decide based on task complexity
1208
- - mcp__claude-flow__swarm_init {
1272
+ - mcp__snow-flow__swarm_init {
1209
1273
  topology: "hierarchical",
1210
1274
  maxAgents: CLI_ARGS.agents || AUTO_DECIDE(task_complexity), // Use CLI args or auto-decide
1211
1275
  strategy: "parallel"
@@ -1213,19 +1277,19 @@ STEP 1: IMMEDIATE PARALLEL SPAWN (Single Message!)
1213
1277
 
1214
1278
  // Spawn agents based on maxAgents count and task requirements
1215
1279
  // If CLI specifies 3 agents, spawn 3. If no args, auto-decide optimal count (3-12)
1216
- - mcp__claude-flow__agent_spawn { type: "architect", name: "System Designer" }
1217
- - mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }
1218
- - mcp__claude-flow__agent_spawn { type: "coder", name: "Frontend Dev" }
1219
- - mcp__claude-flow__agent_spawn { type: "analyst", name: "DB Designer" }
1220
- - mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
1221
- - mcp__claude-flow__agent_spawn { type: "researcher", name: "Tech Lead" }
1222
- - mcp__claude-flow__agent_spawn { type: "coordinator", name: "PM" }
1280
+ - mcp__snow-flow__agent_spawn { type: "architect", name: "System Designer" }
1281
+ - mcp__snow-flow__agent_spawn { type: "coder", name: "API Developer" }
1282
+ - mcp__snow-flow__agent_spawn { type: "coder", name: "Frontend Dev" }
1283
+ - mcp__snow-flow__agent_spawn { type: "analyst", name: "DB Designer" }
1284
+ - mcp__snow-flow__agent_spawn { type: "tester", name: "QA Engineer" }
1285
+ - mcp__snow-flow__agent_spawn { type: "researcher", name: "Tech Lead" }
1286
+ - mcp__snow-flow__agent_spawn { type: "coordinator", name: "PM" }
1223
1287
  - TodoWrite { todos: [multiple todos at once] }
1224
1288
 
1225
1289
  STEP 2: PARALLEL TASK EXECUTION (Single Message!)
1226
1290
  [BatchTool]:
1227
- - mcp__claude-flow__task_orchestrate { task: "main task", strategy: "parallel" }
1228
- - mcp__claude-flow__memory_usage { action: "store", key: "init", value: {...} }
1291
+ - mcp__snow-flow__task_orchestrate { task: "main task", strategy: "parallel" }
1292
+ - mcp__snow-flow__memory_usage { action: "store", key: "init", value: {...} }
1229
1293
  - Multiple Read operations
1230
1294
  - Multiple Write operations
1231
1295
  - Multiple Bash commands
@@ -1270,13 +1334,13 @@ Dependencies: ↳ X deps | Actionable: ▶
1270
1334
  // ✅ CORRECT: SINGLE MESSAGE with ALL operations
1271
1335
  [BatchTool - Message 1]:
1272
1336
  // Initialize and spawn ALL agents at once
1273
- mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8, strategy: "parallel" }
1274
- mcp__claude-flow__agent_spawn { type: "architect", name: "System Designer" }
1275
- mcp__claude-flow__agent_spawn { type: "coder", name: "API Developer" }
1276
- mcp__claude-flow__agent_spawn { type: "coder", name: "Auth Expert" }
1277
- mcp__claude-flow__agent_spawn { type: "analyst", name: "DB Designer" }
1278
- mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
1279
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "Lead" }
1337
+ mcp__snow-flow__swarm_init { topology: "hierarchical", maxAgents: 8, strategy: "parallel" }
1338
+ mcp__snow-flow__agent_spawn { type: "architect", name: "System Designer" }
1339
+ mcp__snow-flow__agent_spawn { type: "coder", name: "API Developer" }
1340
+ mcp__snow-flow__agent_spawn { type: "coder", name: "Auth Expert" }
1341
+ mcp__snow-flow__agent_spawn { type: "analyst", name: "DB Designer" }
1342
+ mcp__snow-flow__agent_spawn { type: "tester", name: "Test Engineer" }
1343
+ mcp__snow-flow__agent_spawn { type: "coordinator", name: "Lead" }
1280
1344
 
1281
1345
  // Update ALL todos at once - NEVER split todos!
1282
1346
  TodoWrite { todos: [
@@ -1291,10 +1355,10 @@ Dependencies: ↳ X deps | Actionable: ▶
1291
1355
  ]}
1292
1356
 
1293
1357
  // Start orchestration
1294
- mcp__claude-flow__task_orchestrate { task: "Build REST API", strategy: "parallel" }
1358
+ mcp__snow-flow__task_orchestrate { task: "Build REST API", strategy: "parallel" }
1295
1359
 
1296
1360
  // Store initial memory
1297
- mcp__claude-flow__memory_usage { action: "store", key: "project/init", value: { started: Date.now() } }
1361
+ mcp__snow-flow__memory_usage { action: "store", key: "project/init", value: { started: Date.now() } }
1298
1362
 
1299
1363
  [BatchTool - Message 2]:
1300
1364
  // Create ALL directories at once
@@ -1325,9 +1389,9 @@ Dependencies: ↳ X deps | Actionable: ▶
1325
1389
 
1326
1390
  ```javascript
1327
1391
  // ❌ WRONG: Multiple messages, one operation each
1328
- Message 1: mcp__claude-flow__swarm_init
1329
- Message 2: mcp__claude-flow__agent_spawn (just one agent)
1330
- Message 3: mcp__claude-flow__agent_spawn (another agent)
1392
+ Message 1: mcp__snow-flow__swarm_init
1393
+ Message 2: mcp__snow-flow__agent_spawn (just one agent)
1394
+ Message 3: mcp__snow-flow__agent_spawn (another agent)
1331
1395
  Message 4: TodoWrite (single todo)
1332
1396
  Message 5: Write (single file)
1333
1397
  // This is 5x slower and wastes swarm coordination!
@@ -1339,7 +1403,7 @@ Every agent coordination step MUST use memory:
1339
1403
 
1340
1404
  ```
1341
1405
  // After each major decision or implementation
1342
- mcp__claude-flow__memory_usage
1406
+ mcp__snow-flow__memory_usage
1343
1407
  action: "store"
1344
1408
  key: "swarm-{id}/agent-{name}/{step}"
1345
1409
  value: {
@@ -1351,12 +1415,12 @@ mcp__claude-flow__memory_usage
1351
1415
  }
1352
1416
 
1353
1417
  // To retrieve coordination data
1354
- mcp__claude-flow__memory_usage
1418
+ mcp__snow-flow__memory_usage
1355
1419
  action: "retrieve"
1356
1420
  key: "swarm-{id}/agent-{name}/{step}"
1357
1421
 
1358
1422
  // To check all swarm progress
1359
- mcp__claude-flow__memory_usage
1423
+ mcp__snow-flow__memory_usage
1360
1424
  action: "list"
1361
1425
  pattern: "swarm-{id}/*"
1362
1426
  ```
@@ -1366,7 +1430,7 @@ mcp__claude-flow__memory_usage
1366
1430
  1. **Batch Everything**: Never operate on single files when multiple are needed
1367
1431
  2. **Parallel First**: Always think "what can run simultaneously?"
1368
1432
  3. **Memory is Key**: Use memory for ALL cross-agent coordination
1369
- 4. **Monitor Progress**: Use mcp**claude-flow**swarm_monitor for real-time tracking
1433
+ 4. **Monitor Progress**: Use mcp**snow-flow**swarm_monitor for real-time tracking
1370
1434
  5. **Auto-Optimize**: Let hooks handle topology and agent selection
1371
1435
 
1372
1436
  ### 🎨 VISUAL SWARM STATUS
@@ -1449,10 +1513,10 @@ Claude Flow extends the base coordination with:
1449
1513
 
1450
1514
  ## Support
1451
1515
 
1452
- - Documentation: https://github.com/ruvnet/claude-flow
1453
- - Issues: https://github.com/ruvnet/claude-flow/issues
1454
- - Examples: https://github.com/ruvnet/claude-flow/tree/main/examples
1516
+ - Documentation: https://github.com/groeimetai/snow-flow
1517
+ - Issues: https://github.com/groeimetai/snow-flow/issues
1518
+ - Examples: https://github.com/groeimetai/snow-flow/tree/main/examples
1455
1519
 
1456
1520
  ---
1457
1521
 
1458
- Remember: **Claude Flow coordinates, Claude Code creates!** Start with `mcp__claude-flow__swarm_init` to enhance your development workflow.
1522
+ Remember: **Snow-Flow coordinates, Claude Code creates!** Start with `mcp__snow-flow__swarm_init` to enhance your development workflow.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "snow-flow",
3
- "version": "1.4.10",
3
+ "version": "1.4.12",
4
4
  "description": "Snow-Flow: ServiceNow Advanced Intelligence Platform - 14 AI-powered analysis tools with multi-agent orchestration. Zero Mock Data, 100% Real API Integration. Revolutionize ServiceNow development with hive-mind intelligence.",
5
5
  "main": "dist/index.js",
6
6
  "type": "commonjs",