claude-flow-novice 2.10.8 → 2.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/.claude/commands/README.md +157 -0
  2. package/.claude/hooks/cfn-invoke-post-edit.sh +1 -1
  3. package/.claude/hooks/cfn-invoke-pre-edit.sh +88 -0
  4. package/.claude/skills/cfn-agent-spawning/spawn-worker.sh +176 -0
  5. package/.claude/skills/cfn-backlog-management/SKILL.md +199 -0
  6. package/.claude/skills/cfn-backlog-management/add-backlog-item.sh +210 -0
  7. package/claude-assets/agents/cfn-dev-team/architecture/base-template-generator.md +7 -21
  8. package/claude-assets/agents/cfn-dev-team/testing/test-validation-agent.md +312 -0
  9. package/claude-assets/agents/cfn-dev-team/utility/agent-builder.md +480 -115
  10. package/claude-assets/agents/csuite/cto-agent.md +371 -0
  11. package/claude-assets/agents/marketing_hybrid/cost_tracker.md +13 -0
  12. package/claude-assets/agents/marketing_hybrid/docker_deployer.md +13 -0
  13. package/claude-assets/agents/marketing_hybrid/zai_worker_spawner.md +13 -0
  14. package/claude-assets/hooks/cfn-invoke-post-edit.sh +1 -1
  15. package/claude-assets/hooks/cfn-invoke-pre-edit.sh +88 -0
  16. package/claude-assets/skills/cfn-agent-spawning/spawn-worker.sh +176 -0
  17. package/claude-assets/skills/cfn-backlog-management/SKILL.md +199 -0
  18. package/claude-assets/skills/cfn-backlog-management/add-backlog-item.sh +210 -0
  19. package/claude-assets/skills/pre-edit-backup/backup.sh +130 -0
  20. package/claude-assets/skills/pre-edit-backup/cleanup.sh +155 -0
  21. package/claude-assets/skills/pre-edit-backup/restore.sh +128 -0
  22. package/claude-assets/skills/pre-edit-backup/revert-file.sh +168 -0
  23. package/dist/agents/agent-loader.js +315 -0
  24. package/dist/agents/agent-loader.js.map +1 -1
  25. package/package.json +3 -2
  26. package/scripts/init-project.js +38 -3
  27. package/scripts/marketing_hybrid_deployment.sh +45 -0
  28. package/scripts/redis-prometheus-exporter.sh +33 -0
  29. package/scripts/track-zai-costs.sh +19 -0
  30. package/claude-assets/commands/agents/README.md +0 -10
  31. package/claude-assets/commands/agents/agent-capabilities.md +0 -21
  32. package/claude-assets/commands/agents/agent-coordination.md +0 -28
  33. package/claude-assets/commands/agents/agent-spawning.md +0 -28
  34. package/claude-assets/commands/agents/agent-types.md +0 -26
  35. package/claude-assets/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +0 -54
  36. package/claude-assets/commands/analysis/README.md +0 -9
  37. package/claude-assets/commands/analysis/bottleneck-detect.md +0 -162
  38. package/claude-assets/commands/analysis/performance-bottlenecks.md +0 -59
  39. package/claude-assets/commands/analysis/performance-report.md +0 -25
  40. package/claude-assets/commands/analysis/token-efficiency.md +0 -45
  41. package/claude-assets/commands/analysis/token-usage.md +0 -25
  42. package/claude-assets/commands/automation/README.md +0 -9
  43. package/claude-assets/commands/automation/auto-agent.md +0 -122
  44. package/claude-assets/commands/automation/self-healing.md +0 -106
  45. package/claude-assets/commands/automation/session-memory.md +0 -90
  46. package/claude-assets/commands/automation/smart-agents.md +0 -73
  47. package/claude-assets/commands/automation/smart-spawn.md +0 -25
  48. package/claude-assets/commands/automation/workflow-select.md +0 -25
  49. package/claude-assets/commands/claude-md.js +0 -237
  50. package/claude-assets/commands/claude-soul.js +0 -28
  51. package/claude-assets/commands/cli-integration.js +0 -216
  52. package/claude-assets/commands/coordination/README.md +0 -9
  53. package/claude-assets/commands/coordination/agent-spawn.md +0 -25
  54. package/claude-assets/commands/coordination/coordination-system.md +0 -88
  55. package/claude-assets/commands/coordination/init.md +0 -44
  56. package/claude-assets/commands/coordination/orchestrate.md +0 -43
  57. package/claude-assets/commands/coordination/spawn.md +0 -45
  58. package/claude-assets/commands/coordination/swarm-init.md +0 -85
  59. package/claude-assets/commands/coordination/task-orchestrate.md +0 -25
  60. package/claude-assets/commands/github/README.md +0 -11
  61. package/claude-assets/commands/github/code-review-swarm.md +0 -514
  62. package/claude-assets/commands/github/code-review.md +0 -25
  63. package/claude-assets/commands/github/github-modes.md +0 -147
  64. package/claude-assets/commands/github/github-swarm.md +0 -121
  65. package/claude-assets/commands/github/issue-tracker.md +0 -292
  66. package/claude-assets/commands/github/issue-triage.md +0 -25
  67. package/claude-assets/commands/github/multi-repo-swarm.md +0 -519
  68. package/claude-assets/commands/github/pr-enhance.md +0 -26
  69. package/claude-assets/commands/github/pr-manager.md +0 -170
  70. package/claude-assets/commands/github/project-board-sync.md +0 -471
  71. package/claude-assets/commands/github/release-manager.md +0 -338
  72. package/claude-assets/commands/github/release-swarm.md +0 -544
  73. package/claude-assets/commands/github/repo-analyze.md +0 -25
  74. package/claude-assets/commands/github/repo-architect.md +0 -367
  75. package/claude-assets/commands/github/swarm-issue.md +0 -482
  76. package/claude-assets/commands/github/swarm-pr.md +0 -285
  77. package/claude-assets/commands/github/sync-coordinator.md +0 -301
  78. package/claude-assets/commands/github/workflow-automation.md +0 -442
  79. package/claude-assets/commands/github.js +0 -638
  80. package/claude-assets/commands/hive-mind/README.md +0 -17
  81. package/claude-assets/commands/hive-mind/hive-mind-consensus.md +0 -8
  82. package/claude-assets/commands/hive-mind/hive-mind-init.md +0 -18
  83. package/claude-assets/commands/hive-mind/hive-mind-memory.md +0 -8
  84. package/claude-assets/commands/hive-mind/hive-mind-metrics.md +0 -8
  85. package/claude-assets/commands/hive-mind/hive-mind-resume.md +0 -8
  86. package/claude-assets/commands/hive-mind/hive-mind-sessions.md +0 -8
  87. package/claude-assets/commands/hive-mind/hive-mind-spawn.md +0 -21
  88. package/claude-assets/commands/hive-mind/hive-mind-status.md +0 -8
  89. package/claude-assets/commands/hive-mind/hive-mind-stop.md +0 -8
  90. package/claude-assets/commands/hive-mind/hive-mind-wizard.md +0 -8
  91. package/claude-assets/commands/hive-mind/hive-mind.md +0 -27
  92. package/claude-assets/commands/hooks/README.md +0 -11
  93. package/claude-assets/commands/hooks/overview.md +0 -58
  94. package/claude-assets/commands/hooks/post-edit.md +0 -117
  95. package/claude-assets/commands/hooks/post-task.md +0 -112
  96. package/claude-assets/commands/hooks/pre-edit.md +0 -113
  97. package/claude-assets/commands/hooks/pre-task.md +0 -111
  98. package/claude-assets/commands/hooks/session-end.md +0 -118
  99. package/claude-assets/commands/hooks/session-start.md +0 -9
  100. package/claude-assets/commands/hooks/setup.md +0 -103
  101. package/claude-assets/commands/hooks.js +0 -651
  102. package/claude-assets/commands/index.js +0 -119
  103. package/claude-assets/commands/memory/README.md +0 -9
  104. package/claude-assets/commands/memory/memory-bank.md +0 -58
  105. package/claude-assets/commands/memory/memory-persist.md +0 -25
  106. package/claude-assets/commands/memory/memory-search.md +0 -25
  107. package/claude-assets/commands/memory/memory-usage.md +0 -25
  108. package/claude-assets/commands/memory/neural.md +0 -47
  109. package/claude-assets/commands/memory/usage.md +0 -46
  110. package/claude-assets/commands/monitoring/README.md +0 -9
  111. package/claude-assets/commands/monitoring/agent-metrics.md +0 -25
  112. package/claude-assets/commands/monitoring/agents.md +0 -44
  113. package/claude-assets/commands/monitoring/real-time-view.md +0 -25
  114. package/claude-assets/commands/monitoring/status.md +0 -46
  115. package/claude-assets/commands/monitoring/swarm-monitor.md +0 -25
  116. package/claude-assets/commands/neural.js +0 -572
  117. package/claude-assets/commands/optimization/README.md +0 -9
  118. package/claude-assets/commands/optimization/auto-topology.md +0 -62
  119. package/claude-assets/commands/optimization/cache-manage.md +0 -25
  120. package/claude-assets/commands/optimization/parallel-execute.md +0 -25
  121. package/claude-assets/commands/optimization/parallel-execution.md +0 -50
  122. package/claude-assets/commands/optimization/topology-optimize.md +0 -25
  123. package/claude-assets/commands/pair/README.md +0 -261
  124. package/claude-assets/commands/pair/commands.md +0 -546
  125. package/claude-assets/commands/pair/config.md +0 -510
  126. package/claude-assets/commands/pair/examples.md +0 -512
  127. package/claude-assets/commands/pair/modes.md +0 -348
  128. package/claude-assets/commands/pair/session.md +0 -407
  129. package/claude-assets/commands/pair/start.md +0 -209
  130. package/claude-assets/commands/parse-epic.js +0 -180
  131. package/claude-assets/commands/performance.js +0 -582
  132. package/claude-assets/commands/register-all-commands.js +0 -320
  133. package/claude-assets/commands/register-claude-md.js +0 -82
  134. package/claude-assets/commands/register-claude-soul.js +0 -80
  135. package/claude-assets/commands/sparc/analyzer.md +0 -52
  136. package/claude-assets/commands/sparc/architect.md +0 -53
  137. package/claude-assets/commands/sparc/batch-executor.md +0 -54
  138. package/claude-assets/commands/sparc/coder.md +0 -54
  139. package/claude-assets/commands/sparc/debugger.md +0 -54
  140. package/claude-assets/commands/sparc/designer.md +0 -53
  141. package/claude-assets/commands/sparc/documenter.md +0 -54
  142. package/claude-assets/commands/sparc/innovator.md +0 -54
  143. package/claude-assets/commands/sparc/memory-manager.md +0 -54
  144. package/claude-assets/commands/sparc/optimizer.md +0 -54
  145. package/claude-assets/commands/sparc/orchestrator.md +0 -132
  146. package/claude-assets/commands/sparc/researcher.md +0 -54
  147. package/claude-assets/commands/sparc/reviewer.md +0 -54
  148. package/claude-assets/commands/sparc/sparc-modes.md +0 -174
  149. package/claude-assets/commands/sparc/swarm-coordinator.md +0 -54
  150. package/claude-assets/commands/sparc/tdd.md +0 -54
  151. package/claude-assets/commands/sparc/tester.md +0 -54
  152. package/claude-assets/commands/sparc/workflow-manager.md +0 -54
  153. package/claude-assets/commands/sparc.js +0 -110
  154. package/claude-assets/commands/stream-chain/pipeline.md +0 -121
  155. package/claude-assets/commands/stream-chain/run.md +0 -70
  156. package/claude-assets/commands/swarm/README.md +0 -15
  157. package/claude-assets/commands/swarm/analysis.md +0 -95
  158. package/claude-assets/commands/swarm/development.md +0 -96
  159. package/claude-assets/commands/swarm/examples.md +0 -168
  160. package/claude-assets/commands/swarm/maintenance.md +0 -102
  161. package/claude-assets/commands/swarm/optimization.md +0 -117
  162. package/claude-assets/commands/swarm/research.md +0 -136
  163. package/claude-assets/commands/swarm/swarm-analysis.md +0 -8
  164. package/claude-assets/commands/swarm/swarm-background.md +0 -8
  165. package/claude-assets/commands/swarm/swarm-init.md +0 -19
  166. package/claude-assets/commands/swarm/swarm-modes.md +0 -8
  167. package/claude-assets/commands/swarm/swarm-monitor.md +0 -8
  168. package/claude-assets/commands/swarm/swarm-spawn.md +0 -19
  169. package/claude-assets/commands/swarm/swarm-status.md +0 -8
  170. package/claude-assets/commands/swarm/swarm-strategies.md +0 -8
  171. package/claude-assets/commands/swarm/swarm.md +0 -27
  172. package/claude-assets/commands/swarm/testing.md +0 -131
  173. package/claude-assets/commands/swarm.js +0 -423
  174. package/claude-assets/commands/testing/playwright-e2e.md +0 -288
  175. package/claude-assets/commands/training/README.md +0 -9
  176. package/claude-assets/commands/training/model-update.md +0 -25
  177. package/claude-assets/commands/training/neural-patterns.md +0 -74
  178. package/claude-assets/commands/training/neural-train.md +0 -25
  179. package/claude-assets/commands/training/pattern-learn.md +0 -25
  180. package/claude-assets/commands/training/specialization.md +0 -63
  181. package/claude-assets/commands/truth/start.md +0 -143
  182. package/claude-assets/commands/validate-commands.js +0 -223
  183. package/claude-assets/commands/verify/check.md +0 -50
  184. package/claude-assets/commands/verify/start.md +0 -128
  185. package/claude-assets/commands/workflow.js +0 -606
  186. package/claude-assets/commands/workflows/README.md +0 -9
  187. package/claude-assets/commands/workflows/development.md +0 -78
  188. package/claude-assets/commands/workflows/research.md +0 -63
  189. package/claude-assets/commands/workflows/workflow-create.md +0 -25
  190. package/claude-assets/commands/workflows/workflow-execute.md +0 -25
  191. package/claude-assets/commands/workflows/workflow-export.md +0 -25
  192. package/claude-assets/hooks/post-edit.config.json +0 -12
  193. package/claude-assets/skills/team-provider-routing/spawn-worker.sh +0 -91
@@ -1,442 +0,0 @@
1
- # Workflow Automation - GitHub Actions Integration
2
-
3
- ## Overview
4
- Integrate AI swarms with GitHub Actions to create intelligent, self-organizing CI/CD pipelines that adapt to your codebase.
5
-
6
- ## Core Features
7
-
8
- ### 1. Swarm-Powered Actions
9
- ```yaml
10
- # .github/workflows/swarm-ci.yml
11
- name: Intelligent CI with Swarms
12
- on: [push, pull_request]
13
-
14
- jobs:
15
- swarm-analysis:
16
- runs-on: ubuntu-latest
17
- steps:
18
- - uses: actions/checkout@v3
19
-
20
- - name: Initialize Swarm
21
- uses: ruvnet/swarm-action@v1
22
- with:
23
- topology: mesh
24
- max-agents: 6
25
-
26
- - name: Analyze Changes
27
- run: |
28
- npx ruv-swarm actions analyze \
29
- --commit ${{ github.sha }} \
30
- --suggest-tests \
31
- --optimize-pipeline
32
- ```
33
-
34
- ### 2. Dynamic Workflow Generation
35
- ```bash
36
- # Generate workflows based on code analysis
37
- npx ruv-swarm actions generate-workflow \
38
- --analyze-codebase \
39
- --detect-languages \
40
- --create-optimal-pipeline
41
- ```
42
-
43
- ### 3. Intelligent Test Selection
44
- ```yaml
45
- # Smart test runner
46
- - name: Swarm Test Selection
47
- run: |
48
- npx ruv-swarm actions smart-test \
49
- --changed-files ${{ steps.files.outputs.all }} \
50
- --impact-analysis \
51
- --parallel-safe
52
- ```
53
-
54
- ## Workflow Templates
55
-
56
- ### Multi-Language Detection
57
- ```yaml
58
- # .github/workflows/polyglot-swarm.yml
59
- name: Polyglot Project Handler
60
- on: push
61
-
62
- jobs:
63
- detect-and-build:
64
- runs-on: ubuntu-latest
65
- steps:
66
- - uses: actions/checkout@v3
67
-
68
- - name: Detect Languages
69
- id: detect
70
- run: |
71
- npx ruv-swarm actions detect-stack \
72
- --output json > stack.json
73
-
74
- - name: Dynamic Build Matrix
75
- run: |
76
- npx ruv-swarm actions create-matrix \
77
- --from stack.json \
78
- --parallel-builds
79
- ```
80
-
81
- ### Adaptive Security Scanning
82
- ```yaml
83
- # .github/workflows/security-swarm.yml
84
- name: Intelligent Security Scan
85
- on:
86
- schedule:
87
- - cron: '0 0 * * *'
88
- workflow_dispatch:
89
-
90
- jobs:
91
- security-swarm:
92
- runs-on: ubuntu-latest
93
- steps:
94
- - name: Security Analysis Swarm
95
- run: |
96
- # Use gh CLI for issue creation
97
- SECURITY_ISSUES=$(npx ruv-swarm actions security \
98
- --deep-scan \
99
- --format json)
100
-
101
- # Create issues for complex security problems
102
- echo "$SECURITY_ISSUES" | jq -r '.issues[]? | @base64' | while read -r issue; do
103
- _jq() {
104
- echo ${issue} | base64 --decode | jq -r ${1}
105
- }
106
- gh issue create \
107
- --title "$(_jq '.title')" \
108
- --body "$(_jq '.body')" \
109
- --label "security,critical"
110
- done
111
- ```
112
-
113
- ## Action Commands
114
-
115
- ### Pipeline Optimization
116
- ```bash
117
- # Optimize existing workflows
118
- npx ruv-swarm actions optimize \
119
- --workflow ".github/workflows/ci.yml" \
120
- --suggest-parallelization \
121
- --reduce-redundancy \
122
- --estimate-savings
123
- ```
124
-
125
- ### Failure Analysis
126
- ```bash
127
- # Analyze failed runs using gh CLI
128
- gh run view ${{ github.run_id }} --json jobs,conclusion | \
129
- npx ruv-swarm actions analyze-failure \
130
- --suggest-fixes \
131
- --auto-retry-flaky
132
-
133
- # Create issue for persistent failures
134
- if [ $? -ne 0 ]; then
135
- gh issue create \
136
- --title "CI Failure: Run ${{ github.run_id }}" \
137
- --body "Automated analysis detected persistent failures" \
138
- --label "ci-failure"
139
- fi
140
- ```
141
-
142
- ### Resource Management
143
- ```bash
144
- # Optimize resource usage
145
- npx ruv-swarm actions resources \
146
- --analyze-usage \
147
- --suggest-runners \
148
- --cost-optimize
149
- ```
150
-
151
- ## Advanced Workflows
152
-
153
- ### 1. Self-Healing CI/CD
154
- ```yaml
155
- # Auto-fix common CI failures
156
- name: Self-Healing Pipeline
157
- on: workflow_run
158
-
159
- jobs:
160
- heal-pipeline:
161
- if: ${{ github.event.workflow_run.conclusion == 'failure' }}
162
- runs-on: ubuntu-latest
163
- steps:
164
- - name: Diagnose and Fix
165
- run: |
166
- npx ruv-swarm actions self-heal \
167
- --run-id ${{ github.event.workflow_run.id }} \
168
- --auto-fix-common \
169
- --create-pr-complex
170
- ```
171
-
172
- ### 2. Progressive Deployment
173
- ```yaml
174
- # Intelligent deployment strategy
175
- name: Smart Deployment
176
- on:
177
- push:
178
- branches: [main]
179
-
180
- jobs:
181
- progressive-deploy:
182
- runs-on: ubuntu-latest
183
- steps:
184
- - name: Analyze Risk
185
- id: risk
186
- run: |
187
- npx ruv-swarm actions deploy-risk \
188
- --changes ${{ github.sha }} \
189
- --history 30d
190
-
191
- - name: Choose Strategy
192
- run: |
193
- npx ruv-swarm actions deploy-strategy \
194
- --risk ${{ steps.risk.outputs.level }} \
195
- --auto-execute
196
- ```
197
-
198
- ### 3. Performance Regression Detection
199
- ```yaml
200
- # Automatic performance testing
201
- name: Performance Guard
202
- on: pull_request
203
-
204
- jobs:
205
- perf-swarm:
206
- runs-on: ubuntu-latest
207
- steps:
208
- - name: Performance Analysis
209
- run: |
210
- npx ruv-swarm actions perf-test \
211
- --baseline main \
212
- --threshold 10% \
213
- --auto-profile-regression
214
- ```
215
-
216
- ## Custom Actions
217
-
218
- ### Swarm Action Development
219
- ```javascript
220
- // action.yml
221
- name: 'Swarm Custom Action'
222
- description: 'Custom swarm-powered action'
223
- inputs:
224
- task:
225
- description: 'Task for swarm'
226
- required: true
227
- runs:
228
- using: 'node16'
229
- main: 'dist/index.js'
230
-
231
- // index.js
232
- const { SwarmAction } = require('ruv-swarm');
233
-
234
- async function run() {
235
- const swarm = new SwarmAction({
236
- topology: 'mesh',
237
- agents: ['analyzer', 'optimizer']
238
- });
239
-
240
- await swarm.execute(core.getInput('task'));
241
- }
242
- ```
243
-
244
- ## Matrix Strategies
245
-
246
- ### Dynamic Test Matrix
247
- ```yaml
248
- # Generate test matrix from code analysis
249
- jobs:
250
- generate-matrix:
251
- outputs:
252
- matrix: ${{ steps.set-matrix.outputs.matrix }}
253
- steps:
254
- - id: set-matrix
255
- run: |
256
- MATRIX=$(npx ruv-swarm actions test-matrix \
257
- --detect-frameworks \
258
- --optimize-coverage)
259
- echo "matrix=${MATRIX}" >> $GITHUB_OUTPUT
260
-
261
- test:
262
- needs: generate-matrix
263
- strategy:
264
- matrix: ${{fromJson(needs.generate-matrix.outputs.matrix)}}
265
- ```
266
-
267
- ### Intelligent Parallelization
268
- ```bash
269
- # Determine optimal parallelization
270
- npx ruv-swarm actions parallel-strategy \
271
- --analyze-dependencies \
272
- --time-estimates \
273
- --cost-aware
274
- ```
275
-
276
- ## Monitoring & Insights
277
-
278
- ### Workflow Analytics
279
- ```bash
280
- # Analyze workflow performance
281
- npx ruv-swarm actions analytics \
282
- --workflow "ci.yml" \
283
- --period 30d \
284
- --identify-bottlenecks \
285
- --suggest-improvements
286
- ```
287
-
288
- ### Cost Optimization
289
- ```bash
290
- # Optimize GitHub Actions costs
291
- npx ruv-swarm actions cost-optimize \
292
- --analyze-usage \
293
- --suggest-caching \
294
- --recommend-self-hosted
295
- ```
296
-
297
- ### Failure Patterns
298
- ```bash
299
- # Identify failure patterns
300
- npx ruv-swarm actions failure-patterns \
301
- --period 90d \
302
- --classify-failures \
303
- --suggest-preventions
304
- ```
305
-
306
- ## Integration Examples
307
-
308
- ### 1. PR Validation Swarm
309
- ```yaml
310
- name: PR Validation Swarm
311
- on: pull_request
312
-
313
- jobs:
314
- validate:
315
- runs-on: ubuntu-latest
316
- steps:
317
- - name: Multi-Agent Validation
318
- run: |
319
- # Get PR details using gh CLI
320
- PR_DATA=$(gh pr view ${{ github.event.pull_request.number }} --json files,labels)
321
-
322
- # Run validation with swarm
323
- RESULTS=$(npx ruv-swarm actions pr-validate \
324
- --spawn-agents "linter,tester,security,docs" \
325
- --parallel \
326
- --pr-data "$PR_DATA")
327
-
328
- # Post results as PR comment
329
- gh pr comment ${{ github.event.pull_request.number }} \
330
- --body "$RESULTS"
331
- ```
332
-
333
- ### 2. Release Automation
334
- ```yaml
335
- name: Intelligent Release
336
- on:
337
- push:
338
- tags: ['v*']
339
-
340
- jobs:
341
- release:
342
- runs-on: ubuntu-latest
343
- steps:
344
- - name: Release Swarm
345
- run: |
346
- npx ruv-swarm actions release \
347
- --analyze-changes \
348
- --generate-notes \
349
- --create-artifacts \
350
- --publish-smart
351
- ```
352
-
353
- ### 3. Documentation Updates
354
- ```yaml
355
- name: Auto Documentation
356
- on:
357
- push:
358
- paths: ['src/**']
359
-
360
- jobs:
361
- docs:
362
- runs-on: ubuntu-latest
363
- steps:
364
- - name: Documentation Swarm
365
- run: |
366
- npx ruv-swarm actions update-docs \
367
- --analyze-changes \
368
- --update-api-docs \
369
- --check-examples
370
- ```
371
-
372
- ## Best Practices
373
-
374
- ### 1. Workflow Organization
375
- - Use reusable workflows for swarm operations
376
- - Implement proper caching strategies
377
- - Set appropriate timeouts
378
- - Use workflow dependencies wisely
379
-
380
- ### 2. Security
381
- - Store swarm configs in secrets
382
- - Use OIDC for authentication
383
- - Implement least-privilege principles
384
- - Audit swarm operations
385
-
386
- ### 3. Performance
387
- - Cache swarm dependencies
388
- - Use appropriate runner sizes
389
- - Implement early termination
390
- - Optimize parallel execution
391
-
392
- ## Advanced Features
393
-
394
- ### Predictive Failures
395
- ```bash
396
- # Predict potential failures
397
- npx ruv-swarm actions predict \
398
- --analyze-history \
399
- --identify-risks \
400
- --suggest-preventive
401
- ```
402
-
403
- ### Workflow Recommendations
404
- ```bash
405
- # Get workflow recommendations
406
- npx ruv-swarm actions recommend \
407
- --analyze-repo \
408
- --suggest-workflows \
409
- --industry-best-practices
410
- ```
411
-
412
- ### Automated Optimization
413
- ```bash
414
- # Continuously optimize workflows
415
- npx ruv-swarm actions auto-optimize \
416
- --monitor-performance \
417
- --apply-improvements \
418
- --track-savings
419
- ```
420
-
421
- ## Debugging & Troubleshooting
422
-
423
- ### Debug Mode
424
- ```yaml
425
- - name: Debug Swarm
426
- run: |
427
- npx ruv-swarm actions debug \
428
- --verbose \
429
- --trace-agents \
430
- --export-logs
431
- ```
432
-
433
- ### Performance Profiling
434
- ```bash
435
- # Profile workflow performance
436
- npx ruv-swarm actions profile \
437
- --workflow "ci.yml" \
438
- --identify-slow-steps \
439
- --suggest-optimizations
440
- ```
441
-
442
- See also: [swarm-pr.md](./swarm-pr.md), [release-swarm.md](./release-swarm.md)