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.
- package/.claude.settings.template +2 -2
- package/CLAUDE.md +136 -72
- package/package.json +1 -1
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"servicenow-automation",
|
|
12
12
|
"servicenow-security-compliance",
|
|
13
13
|
"servicenow-reporting-analytics",
|
|
14
|
-
"
|
|
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
|
-
"
|
|
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
|
-
{
|
|
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
|
|
349
|
+
npx snow-flow sparc run servicenow-analyzer "Analyze incident table performance and suggest optimizations"
|
|
326
350
|
|
|
327
351
|
# Comprehensive process mining
|
|
328
|
-
npx
|
|
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
|
|
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
|
-
|
|
338
|
-
- `npx
|
|
339
|
-
- `npx
|
|
340
|
-
- `npx
|
|
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
|
-
|
|
344
|
-
- `npx
|
|
345
|
-
- `npx
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
798
|
-
claude mcp add
|
|
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
|
|
890
|
-
- `npx
|
|
891
|
-
- `npx
|
|
892
|
-
- `npx
|
|
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
|
|
1109
|
-
npx
|
|
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
|
|
1180
|
+
npx snow-flow hooks post-edit --file "[filepath]" --memory-key "swarm/[agent]/[step]"
|
|
1117
1181
|
|
|
1118
1182
|
# Store decisions and findings
|
|
1119
|
-
npx
|
|
1183
|
+
npx snow-flow hooks notify --message "[what was done]" --telemetry true
|
|
1120
1184
|
|
|
1121
1185
|
# Check coordination with other agents
|
|
1122
|
-
npx
|
|
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
|
|
1130
|
-
npx
|
|
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
|
|
1142
|
-
2. DURING: After EVERY file operation, run `npx
|
|
1143
|
-
3. MEMORY: Store ALL decisions using `npx
|
|
1144
|
-
4. END: Run `npx
|
|
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.
|
|
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",
|