agentic-qe 1.1.0 → 1.2.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.
- package/.claude/agents/qe-coverage-analyzer.md +8 -0
- package/.claude/agents/qe-flaky-test-hunter.md +9 -1
- package/.claude/agents/qe-test-generator.md +7 -0
- package/.claude/agents/reasoning/agent.md +816 -0
- package/.claude/agents/reasoning/goal-planner.md +73 -0
- package/.claude/settings.json +21 -20
- package/.claude/skills/README.md +124 -0
- package/.claude/skills/agentdb-advanced/SKILL.md +550 -0
- package/.claude/skills/agentdb-learning/SKILL.md +545 -0
- package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -0
- package/.claude/skills/agentdb-optimization/SKILL.md +509 -0
- package/.claude/skills/agentdb-vector-search/SKILL.md +339 -0
- package/.claude/skills/agentic-quality-engineering/SKILL.md +604 -0
- package/.claude/skills/api-testing-patterns/SKILL.md +686 -0
- package/.claude/skills/bug-reporting-excellence/SKILL.md +632 -0
- package/.claude/skills/code-review-quality/SKILL.md +683 -0
- package/.claude/skills/consultancy-practices/SKILL.md +540 -0
- package/.claude/skills/context-driven-testing/SKILL.md +466 -0
- package/.claude/skills/exploratory-testing-advanced/SKILL.md +676 -0
- package/.claude/skills/flow-nexus-neural/SKILL.md +738 -0
- package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -0
- package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -0
- package/.claude/skills/github-code-review/SKILL.md +1140 -0
- package/.claude/skills/github-multi-repo/SKILL.md +874 -0
- package/.claude/skills/github-project-management/SKILL.md +1277 -0
- package/.claude/skills/github-release-management/SKILL.md +1081 -0
- package/.claude/skills/github-workflow-automation/SKILL.md +1065 -0
- package/.claude/skills/hive-mind-advanced/SKILL.md +712 -0
- package/.claude/skills/holistic-testing-pact/SKILL.md +225 -0
- package/.claude/skills/hooks-automation/SKILL.md +1201 -0
- package/.claude/skills/pair-programming/SKILL.md +1202 -0
- package/.claude/skills/performance-analysis/SKILL.md +563 -0
- package/.claude/skills/performance-testing/SKILL.md +662 -0
- package/.claude/skills/quality-metrics/SKILL.md +592 -0
- package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -0
- package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -0
- package/.claude/skills/refactoring-patterns/SKILL.md +778 -0
- package/.claude/skills/risk-based-testing/SKILL.md +721 -0
- package/.claude/skills/security-testing/SKILL.md +651 -0
- package/.claude/skills/skill-builder/SKILL.md +910 -0
- package/.claude/skills/sparc-methodology/SKILL.md +1115 -0
- package/.claude/skills/stream-chain/SKILL.md +563 -0
- package/.claude/skills/swarm-advanced/SKILL.md +973 -0
- package/.claude/skills/swarm-orchestration/SKILL.md +179 -0
- package/.claude/skills/tdd-london-chicago/SKILL.md +567 -0
- package/.claude/skills/technical-writing/SKILL.md +235 -0
- package/.claude/skills/test-automation-strategy/SKILL.md +842 -0
- package/.claude/skills/verification-quality/SKILL.md +649 -0
- package/.claude/skills/xp-practices/SKILL.md +671 -0
- package/.claude/statusline-command.sh +176 -0
- package/CHANGELOG.md +536 -1
- package/README.md +92 -3
- package/config/improvement-loop.config.ts +323 -0
- package/config/neural-agent.config.ts +197 -0
- package/dist/adapters/MemoryStoreAdapter.d.ts +16 -16
- package/dist/adapters/MemoryStoreAdapter.d.ts.map +1 -1
- package/dist/adapters/MemoryStoreAdapter.js +16 -16
- package/dist/adapters/MemoryStoreAdapter.js.map +1 -1
- package/dist/agents/BaseAgent.d.ts +69 -0
- package/dist/agents/BaseAgent.d.ts.map +1 -1
- package/dist/agents/BaseAgent.js +382 -1
- package/dist/agents/BaseAgent.js.map +1 -1
- package/dist/agents/CoverageAnalyzerAgent.d.ts +13 -2
- package/dist/agents/CoverageAnalyzerAgent.d.ts.map +1 -1
- package/dist/agents/CoverageAnalyzerAgent.js +105 -6
- package/dist/agents/CoverageAnalyzerAgent.js.map +1 -1
- package/dist/agents/DeploymentReadinessAgent.d.ts.map +1 -1
- package/dist/agents/DeploymentReadinessAgent.js +13 -13
- package/dist/agents/DeploymentReadinessAgent.js.map +1 -1
- package/dist/agents/FlakyTestHunterAgent.d.ts +28 -0
- package/dist/agents/FlakyTestHunterAgent.d.ts.map +1 -1
- package/dist/agents/FlakyTestHunterAgent.js +159 -4
- package/dist/agents/FlakyTestHunterAgent.js.map +1 -1
- package/dist/agents/FleetCommanderAgent.d.ts.map +1 -1
- package/dist/agents/FleetCommanderAgent.js +2 -2
- package/dist/agents/FleetCommanderAgent.js.map +1 -1
- package/dist/agents/LearningAgent.d.ts +14 -5
- package/dist/agents/LearningAgent.d.ts.map +1 -1
- package/dist/agents/LearningAgent.js +36 -16
- package/dist/agents/LearningAgent.js.map +1 -1
- package/dist/agents/NeuralAgentExtension.d.ts +117 -0
- package/dist/agents/NeuralAgentExtension.d.ts.map +1 -0
- package/dist/agents/NeuralAgentExtension.js +288 -0
- package/dist/agents/NeuralAgentExtension.js.map +1 -0
- package/dist/agents/PerformanceTesterAgent.d.ts.map +1 -1
- package/dist/agents/PerformanceTesterAgent.js +4 -3
- package/dist/agents/PerformanceTesterAgent.js.map +1 -1
- package/dist/agents/ProductionIntelligenceAgent.js +7 -7
- package/dist/agents/ProductionIntelligenceAgent.js.map +1 -1
- package/dist/agents/QualityAnalyzerAgent.d.ts.map +1 -1
- package/dist/agents/QualityAnalyzerAgent.js +2 -2
- package/dist/agents/QualityAnalyzerAgent.js.map +1 -1
- package/dist/agents/QualityGateAgent.js +5 -5
- package/dist/agents/QualityGateAgent.js.map +1 -1
- package/dist/agents/RegressionRiskAnalyzerAgent.js +7 -7
- package/dist/agents/RegressionRiskAnalyzerAgent.js.map +1 -1
- package/dist/agents/RequirementsValidatorAgent.d.ts.map +1 -1
- package/dist/agents/RequirementsValidatorAgent.js +1 -1
- package/dist/agents/RequirementsValidatorAgent.js.map +1 -1
- package/dist/agents/SecurityScannerAgent.js +6 -6
- package/dist/agents/SecurityScannerAgent.js.map +1 -1
- package/dist/agents/TestExecutorAgent.d.ts.map +1 -1
- package/dist/agents/TestExecutorAgent.js +1 -3
- package/dist/agents/TestExecutorAgent.js.map +1 -1
- package/dist/agents/TestGeneratorAgent.d.ts +15 -4
- package/dist/agents/TestGeneratorAgent.d.ts.map +1 -1
- package/dist/agents/TestGeneratorAgent.js +165 -43
- package/dist/agents/TestGeneratorAgent.js.map +1 -1
- package/dist/agents/mixins/NeuralCapableMixin.d.ts +130 -0
- package/dist/agents/mixins/NeuralCapableMixin.d.ts.map +1 -0
- package/dist/agents/mixins/NeuralCapableMixin.js +358 -0
- package/dist/agents/mixins/NeuralCapableMixin.js.map +1 -0
- package/dist/agents/mixins/QUICCapableMixin.d.ts +34 -0
- package/dist/agents/mixins/QUICCapableMixin.d.ts.map +1 -0
- package/dist/agents/mixins/QUICCapableMixin.js +346 -0
- package/dist/agents/mixins/QUICCapableMixin.js.map +1 -0
- package/dist/cli/commands/agent/index.d.ts +5 -0
- package/dist/cli/commands/agent/index.d.ts.map +1 -1
- package/dist/cli/commands/agent/index.js +11 -6
- package/dist/cli/commands/agent/index.js.map +1 -1
- package/dist/cli/commands/agent/kill.d.ts +13 -0
- package/dist/cli/commands/agent/kill.d.ts.map +1 -0
- package/dist/cli/commands/agent/kill.js +65 -0
- package/dist/cli/commands/agent/kill.js.map +1 -0
- package/dist/cli/commands/agent/list.d.ts +19 -0
- package/dist/cli/commands/agent/list.d.ts.map +1 -0
- package/dist/cli/commands/agent/list.js +92 -0
- package/dist/cli/commands/agent/list.js.map +1 -0
- package/dist/cli/commands/agent/logs.d.ts +14 -0
- package/dist/cli/commands/agent/logs.d.ts.map +1 -0
- package/dist/cli/commands/agent/logs.js +77 -0
- package/dist/cli/commands/agent/logs.js.map +1 -0
- package/dist/cli/commands/agent/metrics.d.ts +21 -0
- package/dist/cli/commands/agent/metrics.d.ts.map +1 -0
- package/dist/cli/commands/agent/metrics.js +87 -0
- package/dist/cli/commands/agent/metrics.js.map +1 -0
- package/dist/cli/commands/agent/spawn.d.ts +28 -0
- package/dist/cli/commands/agent/spawn.d.ts.map +1 -0
- package/dist/cli/commands/agent/spawn.js +83 -0
- package/dist/cli/commands/agent/spawn.js.map +1 -0
- package/dist/cli/commands/init.d.ts +24 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +475 -7
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/skills/index.d.ts +51 -0
- package/dist/cli/commands/skills/index.d.ts.map +1 -0
- package/dist/cli/commands/skills/index.js +364 -0
- package/dist/cli/commands/skills/index.js.map +1 -0
- package/dist/cli/index.js +92 -1
- package/dist/cli/index.js.map +1 -1
- package/dist/core/EventBus.d.ts +38 -0
- package/dist/core/EventBus.d.ts.map +1 -1
- package/dist/core/EventBus.js +176 -31
- package/dist/core/EventBus.js.map +1 -1
- package/dist/core/FleetManager.d.ts +35 -1
- package/dist/core/FleetManager.d.ts.map +1 -1
- package/dist/core/FleetManager.js +121 -45
- package/dist/core/FleetManager.js.map +1 -1
- package/dist/core/MemoryManager.d.ts +19 -1
- package/dist/core/MemoryManager.d.ts.map +1 -1
- package/dist/core/MemoryManager.js +25 -1
- package/dist/core/MemoryManager.js.map +1 -1
- package/dist/core/embeddings/EmbeddingCache.d.ts +134 -0
- package/dist/core/embeddings/EmbeddingCache.d.ts.map +1 -0
- package/dist/core/embeddings/EmbeddingCache.js +239 -0
- package/dist/core/embeddings/EmbeddingCache.js.map +1 -0
- package/dist/core/embeddings/EmbeddingGenerator.d.ts +224 -0
- package/dist/core/embeddings/EmbeddingGenerator.d.ts.map +1 -0
- package/dist/core/embeddings/EmbeddingGenerator.js +459 -0
- package/dist/core/embeddings/EmbeddingGenerator.js.map +1 -0
- package/dist/core/embeddings/index.d.ts +15 -0
- package/dist/core/embeddings/index.d.ts.map +1 -0
- package/dist/core/embeddings/index.js +22 -0
- package/dist/core/embeddings/index.js.map +1 -0
- package/dist/core/memory/AgentDBIntegration.d.ts +35 -0
- package/dist/core/memory/AgentDBIntegration.d.ts.map +1 -0
- package/dist/core/memory/AgentDBIntegration.js +75 -0
- package/dist/core/memory/AgentDBIntegration.js.map +1 -0
- package/dist/core/memory/AgentDBManager.d.ts +200 -0
- package/dist/core/memory/AgentDBManager.d.ts.map +1 -0
- package/dist/core/memory/AgentDBManager.js +263 -0
- package/dist/core/memory/AgentDBManager.js.map +1 -0
- package/dist/core/memory/AgentDBService.d.ts +160 -0
- package/dist/core/memory/AgentDBService.d.ts.map +1 -0
- package/dist/core/memory/AgentDBService.js +450 -0
- package/dist/core/memory/AgentDBService.js.map +1 -0
- package/dist/core/memory/RealAgentDBAdapter.d.ts +51 -0
- package/dist/core/memory/RealAgentDBAdapter.d.ts.map +1 -0
- package/dist/core/memory/RealAgentDBAdapter.js +230 -0
- package/dist/core/memory/RealAgentDBAdapter.js.map +1 -0
- package/dist/core/memory/ReasoningBankAdapter.d.ts +58 -0
- package/dist/core/memory/ReasoningBankAdapter.d.ts.map +1 -0
- package/dist/core/memory/ReasoningBankAdapter.js +80 -0
- package/dist/core/memory/ReasoningBankAdapter.js.map +1 -0
- package/dist/core/memory/SwarmMemoryManager.d.ts +75 -3
- package/dist/core/memory/SwarmMemoryManager.d.ts.map +1 -1
- package/dist/core/memory/SwarmMemoryManager.js +236 -52
- package/dist/core/memory/SwarmMemoryManager.js.map +1 -1
- package/dist/core/memory/index.d.ts +4 -0
- package/dist/core/memory/index.d.ts.map +1 -1
- package/dist/core/memory/index.js +9 -1
- package/dist/core/memory/index.js.map +1 -1
- package/dist/core/neural/NeuralTrainer.d.ts +137 -0
- package/dist/core/neural/NeuralTrainer.d.ts.map +1 -0
- package/dist/core/neural/NeuralTrainer.js +543 -0
- package/dist/core/neural/NeuralTrainer.js.map +1 -0
- package/dist/core/neural/index.d.ts +8 -0
- package/dist/core/neural/index.d.ts.map +1 -0
- package/dist/core/neural/index.js +24 -0
- package/dist/core/neural/index.js.map +1 -0
- package/dist/core/neural/types.d.ts +216 -0
- package/dist/core/neural/types.d.ts.map +1 -0
- package/dist/core/neural/types.js +8 -0
- package/dist/core/neural/types.js.map +1 -0
- package/dist/core/security/CertificateValidator.d.ts +130 -0
- package/dist/core/security/CertificateValidator.d.ts.map +1 -0
- package/dist/core/security/CertificateValidator.js +376 -0
- package/dist/core/security/CertificateValidator.js.map +1 -0
- package/dist/core/transport/QUICTransport.d.ts +62 -0
- package/dist/core/transport/QUICTransport.d.ts.map +1 -0
- package/dist/core/transport/QUICTransport.js +381 -0
- package/dist/core/transport/QUICTransport.js.map +1 -0
- package/dist/core/transport/SecureQUICTransport.d.ts +71 -0
- package/dist/core/transport/SecureQUICTransport.d.ts.map +1 -0
- package/dist/core/transport/SecureQUICTransport.js +253 -0
- package/dist/core/transport/SecureQUICTransport.js.map +1 -0
- package/dist/learning/AdvancedFeatureExtractor.d.ts +123 -0
- package/dist/learning/AdvancedFeatureExtractor.d.ts.map +1 -0
- package/dist/learning/AdvancedFeatureExtractor.js +423 -0
- package/dist/learning/AdvancedFeatureExtractor.js.map +1 -0
- package/dist/learning/FlakyPredictionModel.d.ts +11 -1
- package/dist/learning/FlakyPredictionModel.d.ts.map +1 -1
- package/dist/learning/FlakyPredictionModel.js +82 -35
- package/dist/learning/FlakyPredictionModel.js.map +1 -1
- package/dist/learning/FlakyTestDetector.d.ts +9 -0
- package/dist/learning/FlakyTestDetector.d.ts.map +1 -1
- package/dist/learning/FlakyTestDetector.js +28 -6
- package/dist/learning/FlakyTestDetector.js.map +1 -1
- package/dist/learning/ImprovementLoop.d.ts +16 -2
- package/dist/learning/ImprovementLoop.d.ts.map +1 -1
- package/dist/learning/ImprovementLoop.js +67 -8
- package/dist/learning/ImprovementLoop.js.map +1 -1
- package/dist/learning/ImprovementWorker.d.ts +83 -0
- package/dist/learning/ImprovementWorker.d.ts.map +1 -0
- package/dist/learning/ImprovementWorker.js +164 -0
- package/dist/learning/ImprovementWorker.js.map +1 -0
- package/dist/learning/NeuralPatternMatcher.d.ts +184 -0
- package/dist/learning/NeuralPatternMatcher.d.ts.map +1 -0
- package/dist/learning/NeuralPatternMatcher.js +702 -0
- package/dist/learning/NeuralPatternMatcher.js.map +1 -0
- package/dist/learning/NeuralTrainer.d.ts +209 -0
- package/dist/learning/NeuralTrainer.d.ts.map +1 -0
- package/dist/learning/NeuralTrainer.js +478 -0
- package/dist/learning/NeuralTrainer.js.map +1 -0
- package/dist/learning/index.d.ts +13 -7
- package/dist/learning/index.d.ts.map +1 -1
- package/dist/learning/index.js +27 -11
- package/dist/learning/index.js.map +1 -1
- package/dist/learning/types.d.ts +1 -0
- package/dist/learning/types.d.ts.map +1 -1
- package/dist/learning/types.js +16 -0
- package/dist/learning/types.js.map +1 -1
- package/dist/mcp/MCPToolRegistry.d.ts +34 -0
- package/dist/mcp/MCPToolRegistry.d.ts.map +1 -0
- package/dist/mcp/MCPToolRegistry.js +48 -0
- package/dist/mcp/MCPToolRegistry.js.map +1 -0
- package/dist/mcp/server.d.ts +4 -4
- package/dist/mcp/services/AgentRegistry.d.ts.map +1 -1
- package/dist/mcp/services/AgentRegistry.js +7 -1
- package/dist/mcp/services/AgentRegistry.js.map +1 -1
- package/dist/transport/QUICTransport.d.ts +340 -0
- package/dist/transport/QUICTransport.d.ts.map +1 -0
- package/dist/transport/QUICTransport.js +814 -0
- package/dist/transport/QUICTransport.js.map +1 -0
- package/dist/transport/UDPTransport.d.ts +348 -0
- package/dist/transport/UDPTransport.d.ts.map +1 -0
- package/dist/transport/UDPTransport.js +820 -0
- package/dist/transport/UDPTransport.js.map +1 -0
- package/dist/types/errors.d.ts +1 -1
- package/dist/types/index.d.ts +37 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js +2 -0
- package/dist/types/index.js.map +1 -1
- package/dist/types/quic.d.ts +339 -0
- package/dist/types/quic.d.ts.map +1 -0
- package/dist/types/quic.js +48 -0
- package/dist/types/quic.js.map +1 -0
- package/dist/utils/Config.js +1 -1
- package/dist/utils/Config.js.map +1 -1
- package/dist/utils/Database.d.ts +14 -0
- package/dist/utils/Database.d.ts.map +1 -1
- package/dist/utils/Database.js +51 -4
- package/dist/utils/Database.js.map +1 -1
- package/dist/utils/Logger.d.ts.map +1 -1
- package/dist/utils/Logger.js +111 -26
- package/dist/utils/Logger.js.map +1 -1
- package/package.json +30 -7
|
@@ -0,0 +1,1065 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: github-workflow-automation
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
category: github
|
|
5
|
+
description: Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
|
|
6
|
+
tags:
|
|
7
|
+
- github
|
|
8
|
+
- github-actions
|
|
9
|
+
- ci-cd
|
|
10
|
+
- workflow-automation
|
|
11
|
+
- swarm-coordination
|
|
12
|
+
- deployment
|
|
13
|
+
- security
|
|
14
|
+
authors:
|
|
15
|
+
- claude-flow
|
|
16
|
+
requires:
|
|
17
|
+
- gh (GitHub CLI)
|
|
18
|
+
- git
|
|
19
|
+
- claude-flow@alpha
|
|
20
|
+
- node (v16+)
|
|
21
|
+
priority: high
|
|
22
|
+
progressive_disclosure: true
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
# GitHub Workflow Automation Skill
|
|
26
|
+
|
|
27
|
+
## Overview
|
|
28
|
+
|
|
29
|
+
This skill provides comprehensive GitHub Actions automation with AI swarm coordination. It integrates intelligent CI/CD pipelines, workflow orchestration, and repository management to create self-organizing, adaptive GitHub workflows.
|
|
30
|
+
|
|
31
|
+
## Quick Start
|
|
32
|
+
|
|
33
|
+
<details>
|
|
34
|
+
<summary>💡 Basic Usage - Click to expand</summary>
|
|
35
|
+
|
|
36
|
+
### Initialize GitHub Workflow Automation
|
|
37
|
+
```bash
|
|
38
|
+
# Start with a simple workflow
|
|
39
|
+
npx ruv-swarm actions generate-workflow \
|
|
40
|
+
--analyze-codebase \
|
|
41
|
+
--detect-languages \
|
|
42
|
+
--create-optimal-pipeline
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Common Commands
|
|
46
|
+
```bash
|
|
47
|
+
# Optimize existing workflow
|
|
48
|
+
npx ruv-swarm actions optimize \
|
|
49
|
+
--workflow ".github/workflows/ci.yml" \
|
|
50
|
+
--suggest-parallelization
|
|
51
|
+
|
|
52
|
+
# Analyze failed runs
|
|
53
|
+
gh run view <run-id> --json jobs,conclusion | \
|
|
54
|
+
npx ruv-swarm actions analyze-failure \
|
|
55
|
+
--suggest-fixes
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
</details>
|
|
59
|
+
|
|
60
|
+
## Core Capabilities
|
|
61
|
+
|
|
62
|
+
### 🤖 Swarm-Powered GitHub Modes
|
|
63
|
+
|
|
64
|
+
<details>
|
|
65
|
+
<summary>Available GitHub Integration Modes</summary>
|
|
66
|
+
|
|
67
|
+
#### 1. gh-coordinator
|
|
68
|
+
**GitHub workflow orchestration and coordination**
|
|
69
|
+
- **Coordination Mode**: Hierarchical
|
|
70
|
+
- **Max Parallel Operations**: 10
|
|
71
|
+
- **Batch Optimized**: Yes
|
|
72
|
+
- **Best For**: Complex GitHub workflows, multi-repo coordination
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Usage example
|
|
76
|
+
npx claude-flow@alpha github gh-coordinator \
|
|
77
|
+
"Coordinate multi-repo release across 5 repositories"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
#### 2. pr-manager
|
|
81
|
+
**Pull request management and review coordination**
|
|
82
|
+
- **Review Mode**: Automated
|
|
83
|
+
- **Multi-reviewer**: Yes
|
|
84
|
+
- **Conflict Resolution**: Intelligent
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
# Create PR with automated review
|
|
88
|
+
gh pr create --title "Feature: New capability" \
|
|
89
|
+
--body "Automated PR with swarm review" | \
|
|
90
|
+
npx ruv-swarm actions pr-validate \
|
|
91
|
+
--spawn-agents "linter,tester,security,docs"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
#### 3. issue-tracker
|
|
95
|
+
**Issue management and project coordination**
|
|
96
|
+
- **Issue Workflow**: Automated
|
|
97
|
+
- **Label Management**: Smart
|
|
98
|
+
- **Progress Tracking**: Real-time
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Create coordinated issue workflow
|
|
102
|
+
npx claude-flow@alpha github issue-tracker \
|
|
103
|
+
"Manage sprint issues with automated tracking"
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
#### 4. release-manager
|
|
107
|
+
**Release coordination and deployment**
|
|
108
|
+
- **Release Pipeline**: Automated
|
|
109
|
+
- **Versioning**: Semantic
|
|
110
|
+
- **Deployment**: Multi-stage
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# Automated release management
|
|
114
|
+
npx claude-flow@alpha github release-manager \
|
|
115
|
+
"Create v2.0.0 release with changelog and deployment"
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
#### 5. repo-architect
|
|
119
|
+
**Repository structure and organization**
|
|
120
|
+
- **Structure Optimization**: Yes
|
|
121
|
+
- **Multi-repo Support**: Yes
|
|
122
|
+
- **Template Management**: Advanced
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
# Optimize repository structure
|
|
126
|
+
npx claude-flow@alpha github repo-architect \
|
|
127
|
+
"Restructure monorepo with optimal organization"
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
#### 6. code-reviewer
|
|
131
|
+
**Automated code review and quality assurance**
|
|
132
|
+
- **Review Quality**: Deep
|
|
133
|
+
- **Security Analysis**: Yes
|
|
134
|
+
- **Performance Check**: Automated
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
# Automated code review
|
|
138
|
+
gh pr view 123 --json files | \
|
|
139
|
+
npx ruv-swarm actions pr-validate \
|
|
140
|
+
--deep-review \
|
|
141
|
+
--security-scan
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
#### 7. ci-orchestrator
|
|
145
|
+
**CI/CD pipeline coordination**
|
|
146
|
+
- **Pipeline Management**: Advanced
|
|
147
|
+
- **Test Coordination**: Parallel
|
|
148
|
+
- **Deployment**: Automated
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
# Orchestrate CI/CD pipeline
|
|
152
|
+
npx claude-flow@alpha github ci-orchestrator \
|
|
153
|
+
"Setup parallel test execution with smart caching"
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
#### 8. security-guardian
|
|
157
|
+
**Security and compliance management**
|
|
158
|
+
- **Security Scan**: Automated
|
|
159
|
+
- **Compliance Check**: Continuous
|
|
160
|
+
- **Vulnerability Management**: Proactive
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
# Security audit
|
|
164
|
+
npx ruv-swarm actions security \
|
|
165
|
+
--deep-scan \
|
|
166
|
+
--compliance-check \
|
|
167
|
+
--create-issues
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
</details>
|
|
171
|
+
|
|
172
|
+
### 🔧 Workflow Templates
|
|
173
|
+
|
|
174
|
+
<details>
|
|
175
|
+
<summary>Production-Ready GitHub Actions Templates</summary>
|
|
176
|
+
|
|
177
|
+
#### 1. Intelligent CI with Swarms
|
|
178
|
+
```yaml
|
|
179
|
+
# .github/workflows/swarm-ci.yml
|
|
180
|
+
name: Intelligent CI with Swarms
|
|
181
|
+
on: [push, pull_request]
|
|
182
|
+
|
|
183
|
+
jobs:
|
|
184
|
+
swarm-analysis:
|
|
185
|
+
runs-on: ubuntu-latest
|
|
186
|
+
steps:
|
|
187
|
+
- uses: actions/checkout@v3
|
|
188
|
+
|
|
189
|
+
- name: Initialize Swarm
|
|
190
|
+
uses: ruvnet/swarm-action@v1
|
|
191
|
+
with:
|
|
192
|
+
topology: mesh
|
|
193
|
+
max-agents: 6
|
|
194
|
+
|
|
195
|
+
- name: Analyze Changes
|
|
196
|
+
run: |
|
|
197
|
+
npx ruv-swarm actions analyze \
|
|
198
|
+
--commit ${{ github.sha }} \
|
|
199
|
+
--suggest-tests \
|
|
200
|
+
--optimize-pipeline
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
#### 2. Multi-Language Detection
|
|
204
|
+
```yaml
|
|
205
|
+
# .github/workflows/polyglot-swarm.yml
|
|
206
|
+
name: Polyglot Project Handler
|
|
207
|
+
on: push
|
|
208
|
+
|
|
209
|
+
jobs:
|
|
210
|
+
detect-and-build:
|
|
211
|
+
runs-on: ubuntu-latest
|
|
212
|
+
steps:
|
|
213
|
+
- uses: actions/checkout@v3
|
|
214
|
+
|
|
215
|
+
- name: Detect Languages
|
|
216
|
+
id: detect
|
|
217
|
+
run: |
|
|
218
|
+
npx ruv-swarm actions detect-stack \
|
|
219
|
+
--output json > stack.json
|
|
220
|
+
|
|
221
|
+
- name: Dynamic Build Matrix
|
|
222
|
+
run: |
|
|
223
|
+
npx ruv-swarm actions create-matrix \
|
|
224
|
+
--from stack.json \
|
|
225
|
+
--parallel-builds
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
#### 3. Adaptive Security Scanning
|
|
229
|
+
```yaml
|
|
230
|
+
# .github/workflows/security-swarm.yml
|
|
231
|
+
name: Intelligent Security Scan
|
|
232
|
+
on:
|
|
233
|
+
schedule:
|
|
234
|
+
- cron: '0 0 * * *'
|
|
235
|
+
workflow_dispatch:
|
|
236
|
+
|
|
237
|
+
jobs:
|
|
238
|
+
security-swarm:
|
|
239
|
+
runs-on: ubuntu-latest
|
|
240
|
+
steps:
|
|
241
|
+
- name: Security Analysis Swarm
|
|
242
|
+
run: |
|
|
243
|
+
SECURITY_ISSUES=$(npx ruv-swarm actions security \
|
|
244
|
+
--deep-scan \
|
|
245
|
+
--format json)
|
|
246
|
+
|
|
247
|
+
echo "$SECURITY_ISSUES" | jq -r '.issues[]? | @base64' | while read -r issue; do
|
|
248
|
+
_jq() {
|
|
249
|
+
echo ${issue} | base64 --decode | jq -r ${1}
|
|
250
|
+
}
|
|
251
|
+
gh issue create \
|
|
252
|
+
--title "$(_jq '.title')" \
|
|
253
|
+
--body "$(_jq '.body')" \
|
|
254
|
+
--label "security,critical"
|
|
255
|
+
done
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
#### 4. Self-Healing Pipeline
|
|
259
|
+
```yaml
|
|
260
|
+
# .github/workflows/self-healing.yml
|
|
261
|
+
name: Self-Healing Pipeline
|
|
262
|
+
on: workflow_run
|
|
263
|
+
|
|
264
|
+
jobs:
|
|
265
|
+
heal-pipeline:
|
|
266
|
+
if: ${{ github.event.workflow_run.conclusion == 'failure' }}
|
|
267
|
+
runs-on: ubuntu-latest
|
|
268
|
+
steps:
|
|
269
|
+
- name: Diagnose and Fix
|
|
270
|
+
run: |
|
|
271
|
+
npx ruv-swarm actions self-heal \
|
|
272
|
+
--run-id ${{ github.event.workflow_run.id }} \
|
|
273
|
+
--auto-fix-common \
|
|
274
|
+
--create-pr-complex
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
#### 5. Progressive Deployment
|
|
278
|
+
```yaml
|
|
279
|
+
# .github/workflows/smart-deployment.yml
|
|
280
|
+
name: Smart Deployment
|
|
281
|
+
on:
|
|
282
|
+
push:
|
|
283
|
+
branches: [main]
|
|
284
|
+
|
|
285
|
+
jobs:
|
|
286
|
+
progressive-deploy:
|
|
287
|
+
runs-on: ubuntu-latest
|
|
288
|
+
steps:
|
|
289
|
+
- name: Analyze Risk
|
|
290
|
+
id: risk
|
|
291
|
+
run: |
|
|
292
|
+
npx ruv-swarm actions deploy-risk \
|
|
293
|
+
--changes ${{ github.sha }} \
|
|
294
|
+
--history 30d
|
|
295
|
+
|
|
296
|
+
- name: Choose Strategy
|
|
297
|
+
run: |
|
|
298
|
+
npx ruv-swarm actions deploy-strategy \
|
|
299
|
+
--risk ${{ steps.risk.outputs.level }} \
|
|
300
|
+
--auto-execute
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
#### 6. Performance Regression Detection
|
|
304
|
+
```yaml
|
|
305
|
+
# .github/workflows/performance-guard.yml
|
|
306
|
+
name: Performance Guard
|
|
307
|
+
on: pull_request
|
|
308
|
+
|
|
309
|
+
jobs:
|
|
310
|
+
perf-swarm:
|
|
311
|
+
runs-on: ubuntu-latest
|
|
312
|
+
steps:
|
|
313
|
+
- name: Performance Analysis
|
|
314
|
+
run: |
|
|
315
|
+
npx ruv-swarm actions perf-test \
|
|
316
|
+
--baseline main \
|
|
317
|
+
--threshold 10% \
|
|
318
|
+
--auto-profile-regression
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
#### 7. PR Validation Swarm
|
|
322
|
+
```yaml
|
|
323
|
+
# .github/workflows/pr-validation.yml
|
|
324
|
+
name: PR Validation Swarm
|
|
325
|
+
on: pull_request
|
|
326
|
+
|
|
327
|
+
jobs:
|
|
328
|
+
validate:
|
|
329
|
+
runs-on: ubuntu-latest
|
|
330
|
+
steps:
|
|
331
|
+
- name: Multi-Agent Validation
|
|
332
|
+
run: |
|
|
333
|
+
PR_DATA=$(gh pr view ${{ github.event.pull_request.number }} --json files,labels)
|
|
334
|
+
|
|
335
|
+
RESULTS=$(npx ruv-swarm actions pr-validate \
|
|
336
|
+
--spawn-agents "linter,tester,security,docs" \
|
|
337
|
+
--parallel \
|
|
338
|
+
--pr-data "$PR_DATA")
|
|
339
|
+
|
|
340
|
+
gh pr comment ${{ github.event.pull_request.number }} \
|
|
341
|
+
--body "$RESULTS"
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
#### 8. Intelligent Release
|
|
345
|
+
```yaml
|
|
346
|
+
# .github/workflows/intelligent-release.yml
|
|
347
|
+
name: Intelligent Release
|
|
348
|
+
on:
|
|
349
|
+
push:
|
|
350
|
+
tags: ['v*']
|
|
351
|
+
|
|
352
|
+
jobs:
|
|
353
|
+
release:
|
|
354
|
+
runs-on: ubuntu-latest
|
|
355
|
+
steps:
|
|
356
|
+
- name: Release Swarm
|
|
357
|
+
run: |
|
|
358
|
+
npx ruv-swarm actions release \
|
|
359
|
+
--analyze-changes \
|
|
360
|
+
--generate-notes \
|
|
361
|
+
--create-artifacts \
|
|
362
|
+
--publish-smart
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
</details>
|
|
366
|
+
|
|
367
|
+
### 📊 Monitoring & Analytics
|
|
368
|
+
|
|
369
|
+
<details>
|
|
370
|
+
<summary>Workflow Analysis & Optimization</summary>
|
|
371
|
+
|
|
372
|
+
#### Workflow Analytics
|
|
373
|
+
```bash
|
|
374
|
+
# Analyze workflow performance
|
|
375
|
+
npx ruv-swarm actions analytics \
|
|
376
|
+
--workflow "ci.yml" \
|
|
377
|
+
--period 30d \
|
|
378
|
+
--identify-bottlenecks \
|
|
379
|
+
--suggest-improvements
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
#### Cost Optimization
|
|
383
|
+
```bash
|
|
384
|
+
# Optimize GitHub Actions costs
|
|
385
|
+
npx ruv-swarm actions cost-optimize \
|
|
386
|
+
--analyze-usage \
|
|
387
|
+
--suggest-caching \
|
|
388
|
+
--recommend-self-hosted
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
#### Failure Pattern Analysis
|
|
392
|
+
```bash
|
|
393
|
+
# Identify failure patterns
|
|
394
|
+
npx ruv-swarm actions failure-patterns \
|
|
395
|
+
--period 90d \
|
|
396
|
+
--classify-failures \
|
|
397
|
+
--suggest-preventions
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
#### Resource Management
|
|
401
|
+
```bash
|
|
402
|
+
# Optimize resource usage
|
|
403
|
+
npx ruv-swarm actions resources \
|
|
404
|
+
--analyze-usage \
|
|
405
|
+
--suggest-runners \
|
|
406
|
+
--cost-optimize
|
|
407
|
+
```
|
|
408
|
+
|
|
409
|
+
</details>
|
|
410
|
+
|
|
411
|
+
## Advanced Features
|
|
412
|
+
|
|
413
|
+
### 🧪 Dynamic Test Strategies
|
|
414
|
+
|
|
415
|
+
<details>
|
|
416
|
+
<summary>Intelligent Test Selection & Execution</summary>
|
|
417
|
+
|
|
418
|
+
#### Smart Test Selection
|
|
419
|
+
```yaml
|
|
420
|
+
# Automatically select relevant tests
|
|
421
|
+
- name: Swarm Test Selection
|
|
422
|
+
run: |
|
|
423
|
+
npx ruv-swarm actions smart-test \
|
|
424
|
+
--changed-files ${{ steps.files.outputs.all }} \
|
|
425
|
+
--impact-analysis \
|
|
426
|
+
--parallel-safe
|
|
427
|
+
```
|
|
428
|
+
|
|
429
|
+
#### Dynamic Test Matrix
|
|
430
|
+
```yaml
|
|
431
|
+
# Generate test matrix from code analysis
|
|
432
|
+
jobs:
|
|
433
|
+
generate-matrix:
|
|
434
|
+
outputs:
|
|
435
|
+
matrix: ${{ steps.set-matrix.outputs.matrix }}
|
|
436
|
+
steps:
|
|
437
|
+
- id: set-matrix
|
|
438
|
+
run: |
|
|
439
|
+
MATRIX=$(npx ruv-swarm actions test-matrix \
|
|
440
|
+
--detect-frameworks \
|
|
441
|
+
--optimize-coverage)
|
|
442
|
+
echo "matrix=${MATRIX}" >> $GITHUB_OUTPUT
|
|
443
|
+
|
|
444
|
+
test:
|
|
445
|
+
needs: generate-matrix
|
|
446
|
+
strategy:
|
|
447
|
+
matrix: ${{fromJson(needs.generate-matrix.outputs.matrix)}}
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
#### Intelligent Parallelization
|
|
451
|
+
```bash
|
|
452
|
+
# Determine optimal parallelization
|
|
453
|
+
npx ruv-swarm actions parallel-strategy \
|
|
454
|
+
--analyze-dependencies \
|
|
455
|
+
--time-estimates \
|
|
456
|
+
--cost-aware
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
</details>
|
|
460
|
+
|
|
461
|
+
### 🔮 Predictive Analysis
|
|
462
|
+
|
|
463
|
+
<details>
|
|
464
|
+
<summary>AI-Powered Workflow Predictions</summary>
|
|
465
|
+
|
|
466
|
+
#### Predictive Failures
|
|
467
|
+
```bash
|
|
468
|
+
# Predict potential failures
|
|
469
|
+
npx ruv-swarm actions predict \
|
|
470
|
+
--analyze-history \
|
|
471
|
+
--identify-risks \
|
|
472
|
+
--suggest-preventive
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
#### Workflow Recommendations
|
|
476
|
+
```bash
|
|
477
|
+
# Get workflow recommendations
|
|
478
|
+
npx ruv-swarm actions recommend \
|
|
479
|
+
--analyze-repo \
|
|
480
|
+
--suggest-workflows \
|
|
481
|
+
--industry-best-practices
|
|
482
|
+
```
|
|
483
|
+
|
|
484
|
+
#### Automated Optimization
|
|
485
|
+
```bash
|
|
486
|
+
# Continuously optimize workflows
|
|
487
|
+
npx ruv-swarm actions auto-optimize \
|
|
488
|
+
--monitor-performance \
|
|
489
|
+
--apply-improvements \
|
|
490
|
+
--track-savings
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
</details>
|
|
494
|
+
|
|
495
|
+
### 🎯 Custom Actions Development
|
|
496
|
+
|
|
497
|
+
<details>
|
|
498
|
+
<summary>Build Your Own Swarm Actions</summary>
|
|
499
|
+
|
|
500
|
+
#### Custom Swarm Action Template
|
|
501
|
+
```javascript
|
|
502
|
+
// action.yml
|
|
503
|
+
name: 'Swarm Custom Action'
|
|
504
|
+
description: 'Custom swarm-powered action'
|
|
505
|
+
inputs:
|
|
506
|
+
task:
|
|
507
|
+
description: 'Task for swarm'
|
|
508
|
+
required: true
|
|
509
|
+
runs:
|
|
510
|
+
using: 'node16'
|
|
511
|
+
main: 'dist/index.js'
|
|
512
|
+
|
|
513
|
+
// index.js
|
|
514
|
+
const { SwarmAction } = require('ruv-swarm');
|
|
515
|
+
|
|
516
|
+
async function run() {
|
|
517
|
+
const swarm = new SwarmAction({
|
|
518
|
+
topology: 'mesh',
|
|
519
|
+
agents: ['analyzer', 'optimizer']
|
|
520
|
+
});
|
|
521
|
+
|
|
522
|
+
await swarm.execute(core.getInput('task'));
|
|
523
|
+
}
|
|
524
|
+
|
|
525
|
+
run().catch(error => core.setFailed(error.message));
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
</details>
|
|
529
|
+
|
|
530
|
+
## Integration with Claude-Flow
|
|
531
|
+
|
|
532
|
+
### 🔄 Swarm Coordination Patterns
|
|
533
|
+
|
|
534
|
+
<details>
|
|
535
|
+
<summary>MCP-Based GitHub Workflow Coordination</summary>
|
|
536
|
+
|
|
537
|
+
#### Initialize GitHub Swarm
|
|
538
|
+
```javascript
|
|
539
|
+
// Step 1: Initialize swarm coordination
|
|
540
|
+
mcp__claude-flow__swarm_init {
|
|
541
|
+
topology: "hierarchical",
|
|
542
|
+
maxAgents: 8
|
|
543
|
+
}
|
|
544
|
+
|
|
545
|
+
// Step 2: Spawn specialized agents
|
|
546
|
+
mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
|
|
547
|
+
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
|
|
548
|
+
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
|
|
549
|
+
mcp__claude-flow__agent_spawn { type: "analyst", name: "Security Analyst" }
|
|
550
|
+
|
|
551
|
+
// Step 3: Orchestrate GitHub workflow
|
|
552
|
+
mcp__claude-flow__task_orchestrate {
|
|
553
|
+
task: "Complete PR review and merge workflow",
|
|
554
|
+
strategy: "parallel",
|
|
555
|
+
priority: "high"
|
|
556
|
+
}
|
|
557
|
+
```
|
|
558
|
+
|
|
559
|
+
#### GitHub Hooks Integration
|
|
560
|
+
```bash
|
|
561
|
+
# Pre-task: Setup GitHub context
|
|
562
|
+
npx claude-flow@alpha hooks pre-task \
|
|
563
|
+
--description "PR review workflow" \
|
|
564
|
+
--context "pr-123"
|
|
565
|
+
|
|
566
|
+
# During task: Track progress
|
|
567
|
+
npx claude-flow@alpha hooks notify \
|
|
568
|
+
--message "Completed security scan" \
|
|
569
|
+
--type "github-action"
|
|
570
|
+
|
|
571
|
+
# Post-task: Export results
|
|
572
|
+
npx claude-flow@alpha hooks post-task \
|
|
573
|
+
--task-id "pr-review-123" \
|
|
574
|
+
--export-github-summary
|
|
575
|
+
```
|
|
576
|
+
|
|
577
|
+
</details>
|
|
578
|
+
|
|
579
|
+
### 📦 Batch Operations
|
|
580
|
+
|
|
581
|
+
<details>
|
|
582
|
+
<summary>Concurrent GitHub Operations</summary>
|
|
583
|
+
|
|
584
|
+
#### Parallel GitHub CLI Commands
|
|
585
|
+
```javascript
|
|
586
|
+
// Single message with all GitHub operations
|
|
587
|
+
[Concurrent Execution]:
|
|
588
|
+
Bash("gh issue create --title 'Feature A' --body 'Description A' --label 'enhancement'")
|
|
589
|
+
Bash("gh issue create --title 'Feature B' --body 'Description B' --label 'enhancement'")
|
|
590
|
+
Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
|
|
591
|
+
Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
|
|
592
|
+
Bash("gh pr checks 123 --watch")
|
|
593
|
+
TodoWrite { todos: [
|
|
594
|
+
{content: "Review security scan results", status: "pending"},
|
|
595
|
+
{content: "Merge approved PRs", status: "pending"},
|
|
596
|
+
{content: "Update changelog", status: "pending"}
|
|
597
|
+
]}
|
|
598
|
+
```
|
|
599
|
+
|
|
600
|
+
</details>
|
|
601
|
+
|
|
602
|
+
## Best Practices
|
|
603
|
+
|
|
604
|
+
### 🏗️ Workflow Organization
|
|
605
|
+
|
|
606
|
+
<details>
|
|
607
|
+
<summary>Structure Your GitHub Workflows</summary>
|
|
608
|
+
|
|
609
|
+
#### 1. Use Reusable Workflows
|
|
610
|
+
```yaml
|
|
611
|
+
# .github/workflows/reusable-swarm.yml
|
|
612
|
+
name: Reusable Swarm Workflow
|
|
613
|
+
on:
|
|
614
|
+
workflow_call:
|
|
615
|
+
inputs:
|
|
616
|
+
topology:
|
|
617
|
+
required: true
|
|
618
|
+
type: string
|
|
619
|
+
|
|
620
|
+
jobs:
|
|
621
|
+
swarm-task:
|
|
622
|
+
runs-on: ubuntu-latest
|
|
623
|
+
steps:
|
|
624
|
+
- name: Initialize Swarm
|
|
625
|
+
run: |
|
|
626
|
+
npx ruv-swarm init --topology ${{ inputs.topology }}
|
|
627
|
+
```
|
|
628
|
+
|
|
629
|
+
#### 2. Implement Proper Caching
|
|
630
|
+
```yaml
|
|
631
|
+
- name: Cache Swarm Dependencies
|
|
632
|
+
uses: actions/cache@v3
|
|
633
|
+
with:
|
|
634
|
+
path: ~/.npm
|
|
635
|
+
key: ${{ runner.os }}-swarm-${{ hashFiles('**/package-lock.json') }}
|
|
636
|
+
```
|
|
637
|
+
|
|
638
|
+
#### 3. Set Appropriate Timeouts
|
|
639
|
+
```yaml
|
|
640
|
+
jobs:
|
|
641
|
+
swarm-task:
|
|
642
|
+
timeout-minutes: 30
|
|
643
|
+
steps:
|
|
644
|
+
- name: Swarm Operation
|
|
645
|
+
timeout-minutes: 10
|
|
646
|
+
```
|
|
647
|
+
|
|
648
|
+
#### 4. Use Workflow Dependencies
|
|
649
|
+
```yaml
|
|
650
|
+
jobs:
|
|
651
|
+
setup:
|
|
652
|
+
runs-on: ubuntu-latest
|
|
653
|
+
|
|
654
|
+
test:
|
|
655
|
+
needs: setup
|
|
656
|
+
runs-on: ubuntu-latest
|
|
657
|
+
|
|
658
|
+
deploy:
|
|
659
|
+
needs: [setup, test]
|
|
660
|
+
runs-on: ubuntu-latest
|
|
661
|
+
```
|
|
662
|
+
|
|
663
|
+
</details>
|
|
664
|
+
|
|
665
|
+
### 🔒 Security Best Practices
|
|
666
|
+
|
|
667
|
+
<details>
|
|
668
|
+
<summary>Secure Your GitHub Workflows</summary>
|
|
669
|
+
|
|
670
|
+
#### 1. Store Configurations Securely
|
|
671
|
+
```yaml
|
|
672
|
+
- name: Setup Swarm
|
|
673
|
+
env:
|
|
674
|
+
SWARM_CONFIG: ${{ secrets.SWARM_CONFIG }}
|
|
675
|
+
API_KEY: ${{ secrets.API_KEY }}
|
|
676
|
+
run: |
|
|
677
|
+
npx ruv-swarm init --config "$SWARM_CONFIG"
|
|
678
|
+
```
|
|
679
|
+
|
|
680
|
+
#### 2. Use OIDC Authentication
|
|
681
|
+
```yaml
|
|
682
|
+
permissions:
|
|
683
|
+
id-token: write
|
|
684
|
+
contents: read
|
|
685
|
+
|
|
686
|
+
- name: Configure AWS Credentials
|
|
687
|
+
uses: aws-actions/configure-aws-credentials@v2
|
|
688
|
+
with:
|
|
689
|
+
role-to-assume: arn:aws:iam::123456789012:role/GitHubAction
|
|
690
|
+
aws-region: us-east-1
|
|
691
|
+
```
|
|
692
|
+
|
|
693
|
+
#### 3. Implement Least-Privilege
|
|
694
|
+
```yaml
|
|
695
|
+
permissions:
|
|
696
|
+
contents: read
|
|
697
|
+
pull-requests: write
|
|
698
|
+
issues: write
|
|
699
|
+
```
|
|
700
|
+
|
|
701
|
+
#### 4. Audit Swarm Operations
|
|
702
|
+
```yaml
|
|
703
|
+
- name: Audit Swarm Actions
|
|
704
|
+
run: |
|
|
705
|
+
npx ruv-swarm actions audit \
|
|
706
|
+
--export-logs \
|
|
707
|
+
--compliance-report
|
|
708
|
+
```
|
|
709
|
+
|
|
710
|
+
</details>
|
|
711
|
+
|
|
712
|
+
### ⚡ Performance Optimization
|
|
713
|
+
|
|
714
|
+
<details>
|
|
715
|
+
<summary>Maximize Workflow Performance</summary>
|
|
716
|
+
|
|
717
|
+
#### 1. Cache Swarm Dependencies
|
|
718
|
+
```yaml
|
|
719
|
+
- uses: actions/cache@v3
|
|
720
|
+
with:
|
|
721
|
+
path: |
|
|
722
|
+
~/.npm
|
|
723
|
+
node_modules
|
|
724
|
+
key: ${{ runner.os }}-swarm-${{ hashFiles('**/package-lock.json') }}
|
|
725
|
+
```
|
|
726
|
+
|
|
727
|
+
#### 2. Use Appropriate Runner Sizes
|
|
728
|
+
```yaml
|
|
729
|
+
jobs:
|
|
730
|
+
heavy-task:
|
|
731
|
+
runs-on: ubuntu-latest-4-cores
|
|
732
|
+
steps:
|
|
733
|
+
- name: Intensive Swarm Operation
|
|
734
|
+
```
|
|
735
|
+
|
|
736
|
+
#### 3. Implement Early Termination
|
|
737
|
+
```yaml
|
|
738
|
+
- name: Quick Fail Check
|
|
739
|
+
run: |
|
|
740
|
+
if ! npx ruv-swarm actions pre-check; then
|
|
741
|
+
echo "Pre-check failed, terminating early"
|
|
742
|
+
exit 1
|
|
743
|
+
fi
|
|
744
|
+
```
|
|
745
|
+
|
|
746
|
+
#### 4. Optimize Parallel Execution
|
|
747
|
+
```yaml
|
|
748
|
+
strategy:
|
|
749
|
+
matrix:
|
|
750
|
+
include:
|
|
751
|
+
- runner: ubuntu-latest
|
|
752
|
+
task: test
|
|
753
|
+
- runner: ubuntu-latest
|
|
754
|
+
task: lint
|
|
755
|
+
- runner: ubuntu-latest
|
|
756
|
+
task: security
|
|
757
|
+
max-parallel: 3
|
|
758
|
+
```
|
|
759
|
+
|
|
760
|
+
</details>
|
|
761
|
+
|
|
762
|
+
## Debugging & Troubleshooting
|
|
763
|
+
|
|
764
|
+
### 🐛 Debug Tools
|
|
765
|
+
|
|
766
|
+
<details>
|
|
767
|
+
<summary>Debug GitHub Workflow Issues</summary>
|
|
768
|
+
|
|
769
|
+
#### Debug Mode
|
|
770
|
+
```yaml
|
|
771
|
+
- name: Debug Swarm
|
|
772
|
+
run: |
|
|
773
|
+
npx ruv-swarm actions debug \
|
|
774
|
+
--verbose \
|
|
775
|
+
--trace-agents \
|
|
776
|
+
--export-logs
|
|
777
|
+
env:
|
|
778
|
+
ACTIONS_STEP_DEBUG: true
|
|
779
|
+
```
|
|
780
|
+
|
|
781
|
+
#### Performance Profiling
|
|
782
|
+
```bash
|
|
783
|
+
# Profile workflow performance
|
|
784
|
+
npx ruv-swarm actions profile \
|
|
785
|
+
--workflow "ci.yml" \
|
|
786
|
+
--identify-slow-steps \
|
|
787
|
+
--suggest-optimizations
|
|
788
|
+
```
|
|
789
|
+
|
|
790
|
+
#### Failure Analysis
|
|
791
|
+
```bash
|
|
792
|
+
# Analyze failed runs
|
|
793
|
+
gh run view <run-id> --json jobs,conclusion | \
|
|
794
|
+
npx ruv-swarm actions analyze-failure \
|
|
795
|
+
--suggest-fixes \
|
|
796
|
+
--auto-retry-flaky
|
|
797
|
+
```
|
|
798
|
+
|
|
799
|
+
#### Log Analysis
|
|
800
|
+
```bash
|
|
801
|
+
# Download and analyze logs
|
|
802
|
+
gh run download <run-id>
|
|
803
|
+
npx ruv-swarm actions analyze-logs \
|
|
804
|
+
--directory ./logs \
|
|
805
|
+
--identify-errors
|
|
806
|
+
```
|
|
807
|
+
|
|
808
|
+
</details>
|
|
809
|
+
|
|
810
|
+
## Real-World Examples
|
|
811
|
+
|
|
812
|
+
### 🚀 Complete Workflows
|
|
813
|
+
|
|
814
|
+
<details>
|
|
815
|
+
<summary>Production-Ready Integration Examples</summary>
|
|
816
|
+
|
|
817
|
+
#### Example 1: Full-Stack Application CI/CD
|
|
818
|
+
```yaml
|
|
819
|
+
name: Full-Stack CI/CD with Swarms
|
|
820
|
+
on:
|
|
821
|
+
push:
|
|
822
|
+
branches: [main, develop]
|
|
823
|
+
pull_request:
|
|
824
|
+
|
|
825
|
+
jobs:
|
|
826
|
+
initialize:
|
|
827
|
+
runs-on: ubuntu-latest
|
|
828
|
+
outputs:
|
|
829
|
+
swarm-id: ${{ steps.init.outputs.swarm-id }}
|
|
830
|
+
steps:
|
|
831
|
+
- id: init
|
|
832
|
+
run: |
|
|
833
|
+
SWARM_ID=$(npx ruv-swarm init --topology mesh --output json | jq -r '.id')
|
|
834
|
+
echo "swarm-id=${SWARM_ID}" >> $GITHUB_OUTPUT
|
|
835
|
+
|
|
836
|
+
backend:
|
|
837
|
+
needs: initialize
|
|
838
|
+
runs-on: ubuntu-latest
|
|
839
|
+
steps:
|
|
840
|
+
- uses: actions/checkout@v3
|
|
841
|
+
- name: Backend Tests
|
|
842
|
+
run: |
|
|
843
|
+
npx ruv-swarm agents spawn --type tester \
|
|
844
|
+
--task "Run backend test suite" \
|
|
845
|
+
--swarm-id ${{ needs.initialize.outputs.swarm-id }}
|
|
846
|
+
|
|
847
|
+
frontend:
|
|
848
|
+
needs: initialize
|
|
849
|
+
runs-on: ubuntu-latest
|
|
850
|
+
steps:
|
|
851
|
+
- uses: actions/checkout@v3
|
|
852
|
+
- name: Frontend Tests
|
|
853
|
+
run: |
|
|
854
|
+
npx ruv-swarm agents spawn --type tester \
|
|
855
|
+
--task "Run frontend test suite" \
|
|
856
|
+
--swarm-id ${{ needs.initialize.outputs.swarm-id }}
|
|
857
|
+
|
|
858
|
+
security:
|
|
859
|
+
needs: initialize
|
|
860
|
+
runs-on: ubuntu-latest
|
|
861
|
+
steps:
|
|
862
|
+
- uses: actions/checkout@v3
|
|
863
|
+
- name: Security Scan
|
|
864
|
+
run: |
|
|
865
|
+
npx ruv-swarm agents spawn --type security \
|
|
866
|
+
--task "Security audit" \
|
|
867
|
+
--swarm-id ${{ needs.initialize.outputs.swarm-id }}
|
|
868
|
+
|
|
869
|
+
deploy:
|
|
870
|
+
needs: [backend, frontend, security]
|
|
871
|
+
if: github.ref == 'refs/heads/main'
|
|
872
|
+
runs-on: ubuntu-latest
|
|
873
|
+
steps:
|
|
874
|
+
- name: Deploy
|
|
875
|
+
run: |
|
|
876
|
+
npx ruv-swarm actions deploy \
|
|
877
|
+
--strategy progressive \
|
|
878
|
+
--swarm-id ${{ needs.initialize.outputs.swarm-id }}
|
|
879
|
+
```
|
|
880
|
+
|
|
881
|
+
#### Example 2: Monorepo Management
|
|
882
|
+
```yaml
|
|
883
|
+
name: Monorepo Coordination
|
|
884
|
+
on: push
|
|
885
|
+
|
|
886
|
+
jobs:
|
|
887
|
+
detect-changes:
|
|
888
|
+
runs-on: ubuntu-latest
|
|
889
|
+
outputs:
|
|
890
|
+
packages: ${{ steps.detect.outputs.packages }}
|
|
891
|
+
steps:
|
|
892
|
+
- uses: actions/checkout@v3
|
|
893
|
+
with:
|
|
894
|
+
fetch-depth: 0
|
|
895
|
+
|
|
896
|
+
- id: detect
|
|
897
|
+
run: |
|
|
898
|
+
PACKAGES=$(npx ruv-swarm actions detect-changes \
|
|
899
|
+
--monorepo \
|
|
900
|
+
--output json)
|
|
901
|
+
echo "packages=${PACKAGES}" >> $GITHUB_OUTPUT
|
|
902
|
+
|
|
903
|
+
build-packages:
|
|
904
|
+
needs: detect-changes
|
|
905
|
+
runs-on: ubuntu-latest
|
|
906
|
+
strategy:
|
|
907
|
+
matrix:
|
|
908
|
+
package: ${{ fromJson(needs.detect-changes.outputs.packages) }}
|
|
909
|
+
steps:
|
|
910
|
+
- name: Build Package
|
|
911
|
+
run: |
|
|
912
|
+
npx ruv-swarm actions build \
|
|
913
|
+
--package ${{ matrix.package }} \
|
|
914
|
+
--parallel-deps
|
|
915
|
+
```
|
|
916
|
+
|
|
917
|
+
#### Example 3: Multi-Repo Synchronization
|
|
918
|
+
```bash
|
|
919
|
+
# Synchronize multiple repositories
|
|
920
|
+
npx claude-flow@alpha github sync-coordinator \
|
|
921
|
+
"Synchronize version updates across:
|
|
922
|
+
- github.com/org/repo-a
|
|
923
|
+
- github.com/org/repo-b
|
|
924
|
+
- github.com/org/repo-c
|
|
925
|
+
|
|
926
|
+
Update dependencies, align versions, create PRs"
|
|
927
|
+
```
|
|
928
|
+
|
|
929
|
+
</details>
|
|
930
|
+
|
|
931
|
+
## Command Reference
|
|
932
|
+
|
|
933
|
+
### 📚 Quick Command Guide
|
|
934
|
+
|
|
935
|
+
<details>
|
|
936
|
+
<summary>All Available Commands</summary>
|
|
937
|
+
|
|
938
|
+
#### Workflow Generation
|
|
939
|
+
```bash
|
|
940
|
+
npx ruv-swarm actions generate-workflow [options]
|
|
941
|
+
--analyze-codebase Analyze repository structure
|
|
942
|
+
--detect-languages Detect programming languages
|
|
943
|
+
--create-optimal-pipeline Generate optimized workflow
|
|
944
|
+
```
|
|
945
|
+
|
|
946
|
+
#### Optimization
|
|
947
|
+
```bash
|
|
948
|
+
npx ruv-swarm actions optimize [options]
|
|
949
|
+
--workflow <path> Path to workflow file
|
|
950
|
+
--suggest-parallelization Suggest parallel execution
|
|
951
|
+
--reduce-redundancy Remove redundant steps
|
|
952
|
+
--estimate-savings Estimate time/cost savings
|
|
953
|
+
```
|
|
954
|
+
|
|
955
|
+
#### Analysis
|
|
956
|
+
```bash
|
|
957
|
+
npx ruv-swarm actions analyze [options]
|
|
958
|
+
--commit <sha> Analyze specific commit
|
|
959
|
+
--suggest-tests Suggest test improvements
|
|
960
|
+
--optimize-pipeline Optimize pipeline structure
|
|
961
|
+
```
|
|
962
|
+
|
|
963
|
+
#### Testing
|
|
964
|
+
```bash
|
|
965
|
+
npx ruv-swarm actions smart-test [options]
|
|
966
|
+
--changed-files <files> Files that changed
|
|
967
|
+
--impact-analysis Analyze test impact
|
|
968
|
+
--parallel-safe Only parallel-safe tests
|
|
969
|
+
```
|
|
970
|
+
|
|
971
|
+
#### Security
|
|
972
|
+
```bash
|
|
973
|
+
npx ruv-swarm actions security [options]
|
|
974
|
+
--deep-scan Deep security analysis
|
|
975
|
+
--format <format> Output format (json/text)
|
|
976
|
+
--create-issues Auto-create GitHub issues
|
|
977
|
+
```
|
|
978
|
+
|
|
979
|
+
#### Deployment
|
|
980
|
+
```bash
|
|
981
|
+
npx ruv-swarm actions deploy [options]
|
|
982
|
+
--strategy <type> Deployment strategy
|
|
983
|
+
--risk <level> Risk assessment level
|
|
984
|
+
--auto-execute Execute automatically
|
|
985
|
+
```
|
|
986
|
+
|
|
987
|
+
#### Monitoring
|
|
988
|
+
```bash
|
|
989
|
+
npx ruv-swarm actions analytics [options]
|
|
990
|
+
--workflow <name> Workflow to analyze
|
|
991
|
+
--period <duration> Analysis period
|
|
992
|
+
--identify-bottlenecks Find bottlenecks
|
|
993
|
+
--suggest-improvements Improvement suggestions
|
|
994
|
+
```
|
|
995
|
+
|
|
996
|
+
</details>
|
|
997
|
+
|
|
998
|
+
## Integration Checklist
|
|
999
|
+
|
|
1000
|
+
### ✅ Setup Verification
|
|
1001
|
+
|
|
1002
|
+
<details>
|
|
1003
|
+
<summary>Verify Your Setup</summary>
|
|
1004
|
+
|
|
1005
|
+
- [ ] GitHub CLI (`gh`) installed and authenticated
|
|
1006
|
+
- [ ] Git configured with user credentials
|
|
1007
|
+
- [ ] Node.js v16+ installed
|
|
1008
|
+
- [ ] `claude-flow@alpha` package available
|
|
1009
|
+
- [ ] Repository has `.github/workflows` directory
|
|
1010
|
+
- [ ] GitHub Actions enabled on repository
|
|
1011
|
+
- [ ] Necessary secrets configured
|
|
1012
|
+
- [ ] Runner permissions verified
|
|
1013
|
+
|
|
1014
|
+
#### Quick Setup Script
|
|
1015
|
+
```bash
|
|
1016
|
+
#!/bin/bash
|
|
1017
|
+
# setup-github-automation.sh
|
|
1018
|
+
|
|
1019
|
+
# Install dependencies
|
|
1020
|
+
npm install -g claude-flow@alpha
|
|
1021
|
+
|
|
1022
|
+
# Verify GitHub CLI
|
|
1023
|
+
gh auth status || gh auth login
|
|
1024
|
+
|
|
1025
|
+
# Create workflow directory
|
|
1026
|
+
mkdir -p .github/workflows
|
|
1027
|
+
|
|
1028
|
+
# Generate initial workflow
|
|
1029
|
+
npx ruv-swarm actions generate-workflow \
|
|
1030
|
+
--analyze-codebase \
|
|
1031
|
+
--create-optimal-pipeline > .github/workflows/ci.yml
|
|
1032
|
+
|
|
1033
|
+
echo "✅ GitHub workflow automation setup complete"
|
|
1034
|
+
```
|
|
1035
|
+
|
|
1036
|
+
</details>
|
|
1037
|
+
|
|
1038
|
+
## Related Skills
|
|
1039
|
+
|
|
1040
|
+
- `github-pr-enhancement` - Advanced PR management
|
|
1041
|
+
- `release-coordination` - Release automation
|
|
1042
|
+
- `swarm-coordination` - Multi-agent orchestration
|
|
1043
|
+
- `ci-cd-optimization` - Pipeline optimization
|
|
1044
|
+
|
|
1045
|
+
## Support & Documentation
|
|
1046
|
+
|
|
1047
|
+
- **GitHub CLI Docs**: https://cli.github.com/manual/
|
|
1048
|
+
- **GitHub Actions**: https://docs.github.com/en/actions
|
|
1049
|
+
- **Claude-Flow**: https://github.com/ruvnet/claude-flow
|
|
1050
|
+
- **Ruv-Swarm**: https://github.com/ruvnet/ruv-swarm
|
|
1051
|
+
|
|
1052
|
+
## Version History
|
|
1053
|
+
|
|
1054
|
+
- **v1.0.0** (2025-01-19): Initial skill consolidation
|
|
1055
|
+
- Merged workflow-automation.md (441 lines)
|
|
1056
|
+
- Merged github-modes.md (146 lines)
|
|
1057
|
+
- Added progressive disclosure
|
|
1058
|
+
- Enhanced with swarm coordination patterns
|
|
1059
|
+
- Added comprehensive examples and best practices
|
|
1060
|
+
|
|
1061
|
+
---
|
|
1062
|
+
|
|
1063
|
+
**Skill Status**: ✅ Production Ready
|
|
1064
|
+
**Last Updated**: 2025-01-19
|
|
1065
|
+
**Maintainer**: claude-flow team
|