snow-flow 1.4.10 → 1.4.11

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:
@@ -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
 
@@ -747,7 +811,7 @@ 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
 
@@ -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
@@ -886,10 +950,10 @@ Once configured, Claude Flow MCP tools enhance Claude Code's coordination:
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
@@ -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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "snow-flow",
3
- "version": "1.4.10",
3
+ "version": "1.4.11",
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",