claude-flow 3.27.4 → 3.29.0

package/.claude/skills/worker-benchmarks/SKILL.md

@@ -1,129 +1,129 @@
----
-name: worker-benchmarks
-description: Run comprehensive worker system benchmarks and performance analysis
-user-invocable: true
----
-
-# Worker Benchmarks Skill
-
-Run comprehensive performance benchmarks for the agentic-flow worker system.
-
-## Quick Start
-
-```bash
-# Run full benchmark suite
-npx agentic-flow workers benchmark
-
-# Run specific benchmark
-npx agentic-flow workers benchmark --type trigger-detection
-npx agentic-flow workers benchmark --type registry
-npx agentic-flow workers benchmark --type agent-selection
-npx agentic-flow workers benchmark --type concurrent
-```
-
-## Benchmark Types
-
-### 1. Trigger Detection (`trigger-detection`)
-Tests keyword detection speed across 12 worker triggers.
-- **Target**: p95 < 5ms
-- **Iterations**: 1000
-- **Metrics**: latency, throughput, histogram
-
-### 2. Worker Registry (`registry`)
-Tests CRUD operations on worker entries.
-- **Target**: p95 < 10ms
-- **Iterations**: 500 creates, gets, updates
-- **Metrics**: per-operation latency breakdown
-
-### 3. Agent Selection (`agent-selection`)
-Tests performance-based agent selection.
-- **Target**: p95 < 1ms
-- **Iterations**: 1000
-- **Metrics**: selection confidence, agent scores
-
-### 4. Model Cache (`cache`)
-Tests model caching performance.
-- **Target**: p95 < 0.5ms
-- **Metrics**: hit rate, cache size, eviction stats
-
-### 5. Concurrent Workers (`concurrent`)
-Tests parallel worker creation and updates.
-- **Target**: < 1000ms for 10 workers
-- **Metrics**: per-worker latency, memory usage
-
-### 6. Memory Key Generation (`memory-keys`)
-Tests memory pattern key generation.
-- **Target**: p95 < 0.1ms
-- **Iterations**: 5000
-- **Metrics**: unique patterns, throughput
-
-## Output Format
-
-```
-═══════════════════════════════════════════════════════════
-📈 BENCHMARK RESULTS
-═══════════════════════════════════════════════════════════
-
-✅ Trigger Detection
-   Operation: detect
-   Count: 1,000
-   Avg: 0.045ms | p95: 0.120ms (target: 5ms)
-   Throughput: 22,222 ops/s
-   Memory Δ: 0.12MB
-
-✅ Worker Registry
-   Operation: crud
-   Count: 1,500
-   Avg: 1.234ms | p95: 3.456ms (target: 10ms)
-   Throughput: 810 ops/s
-   Memory Δ: 2.34MB
-
-───────────────────────────────────────────────────────────
-📊 SUMMARY
-───────────────────────────────────────────────────────────
-Total Tests: 6
-Passed: 6 | Failed: 0
-Avg Latency: 0.567ms
-Total Duration: 2345ms
-Peak Memory: 8.90MB
-═══════════════════════════════════════════════════════════
-```
-
-## Integration with Settings
-
-Benchmark thresholds are configured in `.claude/settings.json`:
-
-```json
-{
-  "performance": {
-    "benchmarkThresholds": {
-      "triggerDetection": { "p95Ms": 5 },
-      "workerRegistry": { "p95Ms": 10 },
-      "agentSelection": { "p95Ms": 1 },
-      "memoryKeyGeneration": { "p95Ms": 0.1 },
-      "concurrentWorkers": { "totalMs": 1000 }
-    }
-  }
-}
-```
-
-## Programmatic Usage
-
-```typescript
-import { workerBenchmarks, runBenchmarks } from 'agentic-flow/workers/worker-benchmarks';
-
-// Run full suite
-const suite = await runBenchmarks();
-console.log(suite.summary);
-
-// Run individual benchmarks
-const triggerResult = await workerBenchmarks.benchmarkTriggerDetection(1000);
-const registryResult = await workerBenchmarks.benchmarkRegistryOperations(500);
-```
-
-## Performance Optimization Tips
-
-1. **Model Cache**: Enable with `CLAUDE_FLOW_MODEL_CACHE_MB=512`
-2. **Parallel Workers**: Enable with `CLAUDE_FLOW_WORKER_PARALLEL=true`
-3. **Warning Suppression**: Enable with `CLAUDE_FLOW_SUPPRESS_WARNINGS=true`
-4. **SQLite WAL Mode**: Automatic for better concurrent performance
+---
+name: worker-benchmarks
+description: Run comprehensive worker system benchmarks and performance analysis
+user-invocable: true
+---
+
+# Worker Benchmarks Skill
+
+Run comprehensive performance benchmarks for the agentic-flow worker system.
+
+## Quick Start
+
+```bash
+# Run full benchmark suite
+npx agentic-flow workers benchmark
+
+# Run specific benchmark
+npx agentic-flow workers benchmark --type trigger-detection
+npx agentic-flow workers benchmark --type registry
+npx agentic-flow workers benchmark --type agent-selection
+npx agentic-flow workers benchmark --type concurrent
+```
+
+## Benchmark Types
+
+### 1. Trigger Detection (`trigger-detection`)
+Tests keyword detection speed across 12 worker triggers.
+- **Target**: p95 < 5ms
+- **Iterations**: 1000
+- **Metrics**: latency, throughput, histogram
+
+### 2. Worker Registry (`registry`)
+Tests CRUD operations on worker entries.
+- **Target**: p95 < 10ms
+- **Iterations**: 500 creates, gets, updates
+- **Metrics**: per-operation latency breakdown
+
+### 3. Agent Selection (`agent-selection`)
+Tests performance-based agent selection.
+- **Target**: p95 < 1ms
+- **Iterations**: 1000
+- **Metrics**: selection confidence, agent scores
+
+### 4. Model Cache (`cache`)
+Tests model caching performance.
+- **Target**: p95 < 0.5ms
+- **Metrics**: hit rate, cache size, eviction stats
+
+### 5. Concurrent Workers (`concurrent`)
+Tests parallel worker creation and updates.
+- **Target**: < 1000ms for 10 workers
+- **Metrics**: per-worker latency, memory usage
+
+### 6. Memory Key Generation (`memory-keys`)
+Tests memory pattern key generation.
+- **Target**: p95 < 0.1ms
+- **Iterations**: 5000
+- **Metrics**: unique patterns, throughput
+
+## Output Format
+
+```
+═══════════════════════════════════════════════════════════
+📈 BENCHMARK RESULTS
+═══════════════════════════════════════════════════════════
+
+✅ Trigger Detection
+   Operation: detect
+   Count: 1,000
+   Avg: 0.045ms | p95: 0.120ms (target: 5ms)
+   Throughput: 22,222 ops/s
+   Memory Δ: 0.12MB
+
+✅ Worker Registry
+   Operation: crud
+   Count: 1,500
+   Avg: 1.234ms | p95: 3.456ms (target: 10ms)
+   Throughput: 810 ops/s
+   Memory Δ: 2.34MB
+
+───────────────────────────────────────────────────────────
+📊 SUMMARY
+───────────────────────────────────────────────────────────
+Total Tests: 6
+Passed: 6 | Failed: 0
+Avg Latency: 0.567ms
+Total Duration: 2345ms
+Peak Memory: 8.90MB
+═══════════════════════════════════════════════════════════
+```
+
+## Integration with Settings
+
+Benchmark thresholds are configured in `.claude/settings.json`:
+
+```json
+{
+  "performance": {
+    "benchmarkThresholds": {
+      "triggerDetection": { "p95Ms": 5 },
+      "workerRegistry": { "p95Ms": 10 },
+      "agentSelection": { "p95Ms": 1 },
+      "memoryKeyGeneration": { "p95Ms": 0.1 },
+      "concurrentWorkers": { "totalMs": 1000 }
+    }
+  }
+}
+```
+
+## Programmatic Usage
+
+```typescript
+import { workerBenchmarks, runBenchmarks } from 'agentic-flow/workers/worker-benchmarks';
+
+// Run full suite
+const suite = await runBenchmarks();
+console.log(suite.summary);
+
+// Run individual benchmarks
+const triggerResult = await workerBenchmarks.benchmarkTriggerDetection(1000);
+const registryResult = await workerBenchmarks.benchmarkRegistryOperations(500);
+```
+
+## Performance Optimization Tips
+
+1. **Model Cache**: Enable with `CLAUDE_FLOW_MODEL_CACHE_MB=512`
+2. **Parallel Workers**: Enable with `CLAUDE_FLOW_WORKER_PARALLEL=true`
+3. **Warning Suppression**: Enable with `CLAUDE_FLOW_SUPPRESS_WARNINGS=true`
+4. **SQLite WAL Mode**: Automatic for better concurrent performance

package/.claude/skills/worker-integration/SKILL.md

@@ -1,147 +1,147 @@
----
-name: worker-integration
-description: Worker-Agent integration for intelligent task dispatch and performance tracking
-user-invocable: true
----
-
-# Worker-Agent Integration Skill
-
-Intelligent coordination between background workers and specialized agents.
-
-## Quick Start
-
-```bash
-# View agent recommendations for a trigger
-npx agentic-flow workers agents ultralearn
-npx agentic-flow workers agents optimize
-
-# View performance metrics
-npx agentic-flow workers metrics
-
-# View integration stats
-npx agentic-flow workers stats --integration
-```
-
-## Agent Mappings
-
-Workers automatically dispatch to optimal agents based on trigger type:
-
-| Trigger | Primary Agents | Fallback | Pipeline Phases |
-|---------|---------------|----------|-----------------|
-| `ultralearn` | researcher, coder | planner | discovery → patterns → vectorization → summary |
-| `optimize` | performance-analyzer, coder | researcher | static-analysis → performance → patterns |
-| `audit` | security-analyst, tester | reviewer | security → secrets → vulnerability-scan |
-| `benchmark` | performance-analyzer | coder, tester | performance → metrics → report |
-| `testgaps` | tester | coder | discovery → coverage → gaps |
-| `document` | documenter, researcher | coder | api-discovery → patterns → indexing |
-| `deepdive` | researcher, security-analyst | coder | call-graph → deps → trace |
-| `refactor` | coder, reviewer | researcher | complexity → smells → patterns |
-
-## Performance-Based Selection
-
-The system learns from execution history to improve agent selection:
-
-```typescript
-// Agent selection considers:
-// 1. Quality score (0-1)
-// 2. Success rate
-// 3. Average latency
-// 4. Execution count
-
-const { agent, confidence, reasoning } = selectBestAgent('optimize');
-// agent: "performance-analyzer"
-// confidence: 0.87
-// reasoning: "Selected based on 45 executions with 94.2% success"
-```
-
-## Memory Key Patterns
-
-Workers store results using consistent patterns:
-
-```
-{trigger}/{topic}/{phase}
-
-Examples:
-- ultralearn/auth-module/analysis
-- optimize/database/performance
-- audit/payment/vulnerabilities
-- benchmark/api/metrics
-```
-
-## Benchmark Thresholds
-
-Agents are monitored against performance thresholds:
-
-```json
-{
-  "researcher": {
-    "p95_latency": "<500ms",
-    "memory_mb": "<256MB"
-  },
-  "coder": {
-    "p95_latency": "<300ms",
-    "quality_score": ">0.85"
-  },
-  "security-analyst": {
-    "scan_coverage": ">95%",
-    "p95_latency": "<1000ms"
-  }
-}
-```
-
-## Feedback Loop
-
-Workers provide feedback for continuous improvement:
-
-```typescript
-import { workerAgentIntegration } from 'agentic-flow/workers/worker-agent-integration';
-
-// Record execution feedback
-workerAgentIntegration.recordFeedback(
-  'optimize',           // trigger
-  'coder',              // agent
-  true,                 // success
-  245,                  // latency ms
-  0.92                  // quality score
-);
-
-// Check compliance
-const { compliant, violations } = workerAgentIntegration.checkBenchmarkCompliance('coder');
-```
-
-## Integration Statistics
-
-```bash
-$ npx agentic-flow workers stats --integration
-
-Worker-Agent Integration Stats
-══════════════════════════════
-Total Agents:       6
-Tracked Agents:     4
-Total Feedback:     156
-Avg Quality Score:  0.89
-
-Model Cache Stats
-─────────────────
-Hits:     1,234
-Misses:   45
-Hit Rate: 96.5%
-```
-
-## Configuration
-
-Enable integration features in `.claude/settings.json`:
-
-```json
-{
-  "workers": {
-    "enabled": true,
-    "parallel": true,
-    "memoryDepositEnabled": true,
-    "agentMappings": {
-      "ultralearn": ["researcher", "coder"],
-      "optimize": ["performance-analyzer", "coder"]
-    }
-  }
-}
-```
+---
+name: worker-integration
+description: Worker-Agent integration for intelligent task dispatch and performance tracking
+user-invocable: true
+---
+
+# Worker-Agent Integration Skill
+
+Intelligent coordination between background workers and specialized agents.
+
+## Quick Start
+
+```bash
+# View agent recommendations for a trigger
+npx agentic-flow workers agents ultralearn
+npx agentic-flow workers agents optimize
+
+# View performance metrics
+npx agentic-flow workers metrics
+
+# View integration stats
+npx agentic-flow workers stats --integration
+```
+
+## Agent Mappings
+
+Workers automatically dispatch to optimal agents based on trigger type:
+
+| Trigger | Primary Agents | Fallback | Pipeline Phases |
+|---------|---------------|----------|-----------------|
+| `ultralearn` | researcher, coder | planner | discovery → patterns → vectorization → summary |
+| `optimize` | performance-analyzer, coder | researcher | static-analysis → performance → patterns |
+| `audit` | security-analyst, tester | reviewer | security → secrets → vulnerability-scan |
+| `benchmark` | performance-analyzer | coder, tester | performance → metrics → report |
+| `testgaps` | tester | coder | discovery → coverage → gaps |
+| `document` | documenter, researcher | coder | api-discovery → patterns → indexing |
+| `deepdive` | researcher, security-analyst | coder | call-graph → deps → trace |
+| `refactor` | coder, reviewer | researcher | complexity → smells → patterns |
+
+## Performance-Based Selection
+
+The system learns from execution history to improve agent selection:
+
+```typescript
+// Agent selection considers:
+// 1. Quality score (0-1)
+// 2. Success rate
+// 3. Average latency
+// 4. Execution count
+
+const { agent, confidence, reasoning } = selectBestAgent('optimize');
+// agent: "performance-analyzer"
+// confidence: 0.87
+// reasoning: "Selected based on 45 executions with 94.2% success"
+```
+
+## Memory Key Patterns
+
+Workers store results using consistent patterns:
+
+```
+{trigger}/{topic}/{phase}
+
+Examples:
+- ultralearn/auth-module/analysis
+- optimize/database/performance
+- audit/payment/vulnerabilities
+- benchmark/api/metrics
+```
+
+## Benchmark Thresholds
+
+Agents are monitored against performance thresholds:
+
+```json
+{
+  "researcher": {
+    "p95_latency": "<500ms",
+    "memory_mb": "<256MB"
+  },
+  "coder": {
+    "p95_latency": "<300ms",
+    "quality_score": ">0.85"
+  },
+  "security-analyst": {
+    "scan_coverage": ">95%",
+    "p95_latency": "<1000ms"
+  }
+}
+```
+
+## Feedback Loop
+
+Workers provide feedback for continuous improvement:
+
+```typescript
+import { workerAgentIntegration } from 'agentic-flow/workers/worker-agent-integration';
+
+// Record execution feedback
+workerAgentIntegration.recordFeedback(
+  'optimize',           // trigger
+  'coder',              // agent
+  true,                 // success
+  245,                  // latency ms
+  0.92                  // quality score
+);
+
+// Check compliance
+const { compliant, violations } = workerAgentIntegration.checkBenchmarkCompliance('coder');
+```
+
+## Integration Statistics
+
+```bash
+$ npx agentic-flow workers stats --integration
+
+Worker-Agent Integration Stats
+══════════════════════════════
+Total Agents:       6
+Tracked Agents:     4
+Total Feedback:     156
+Avg Quality Score:  0.89
+
+Model Cache Stats
+─────────────────
+Hits:     1,234
+Misses:   45
+Hit Rate: 96.5%
+```
+
+## Configuration
+
+Enable integration features in `.claude/settings.json`:
+
+```json
+{
+  "workers": {
+    "enabled": true,
+    "parallel": true,
+    "memoryDepositEnabled": true,
+    "agentMappings": {
+      "ultralearn": ["researcher", "coder"],
+      "optimize": ["performance-analyzer", "coder"]
+    }
+  }
+}
+```