custom-workers

name	Custom Workers
description	Create and run custom background analysis workers with composable phases. Use when you need automated code analysis, security scanning, pattern learning, or API documentation generation.
hooks	{"pre":"echo \"🔧 Custom Workers activated\"\n.claude/agentic-flow-fast.sh workers stats 2>/dev/null || true\n","post":"echo \"✅ Custom Workers complete\"\n.claude/agentic-flow-fast.sh workers results --json 2>/dev/null | head -20 || true\n"}

Custom Workers

Build composable background analysis workers with 24 phase executors and 6 presets.

Quick Start

# List available presets
npx ruvector workers presets

# List available phase executors
npx ruvector workers phases

# Create a custom worker from preset
npx ruvector workers create my-scanner --preset security-scan

# Run the worker
npx ruvector workers run my-scanner --path ./src

Available Presets

Preset	Description	Phases
quick-scan	Fast file discovery and stats	file-discovery → summarization
deep-analysis	Comprehensive code analysis	file-discovery → static-analysis → complexity-analysis → import-analysis → pattern-extraction → graph-build → vectorization → summarization
security-scan	Security-focused analysis	file-discovery → security-analysis → secret-detection → dependency-discovery → report-generation
learning	Pattern learning and memory	file-discovery → pattern-extraction → embedding-generation → pattern-storage → sona-training
api-docs	API endpoint documentation	file-discovery → api-discovery → type-analysis → report-generation
test-analysis	Test coverage analysis	file-discovery → static-analysis → pattern-extraction → summarization

Phase Executors (24 total)

Discovery Phases

• file-discovery - Find files matching patterns
• pattern-discovery - Discover code patterns
• dependency-discovery - Map dependencies
• api-discovery - Find API endpoints

Analysis Phases

• static-analysis - AST-based code analysis
• complexity-analysis - Cyclomatic complexity
• security-analysis - Security vulnerability scan
• performance-analysis - Performance bottlenecks
• import-analysis - Import/export mapping
• type-analysis - TypeScript type extraction

Pattern Phases

• pattern-extraction - Extract code patterns
• todo-extraction - Find TODOs/FIXMEs
• secret-detection - Detect hardcoded secrets
• code-smell-detection - Identify code smells

Build Phases

• graph-build - Build code graph
• call-graph - Function call graph
• dependency-graph - Dependency graph

Learning Phases

• vectorization - Convert to vectors
• embedding-generation - ONNX embeddings (384d)
• pattern-storage - Store in VectorDB
• sona-training - SONA reinforcement learning

Output Phases

• summarization - Generate summary
• report-generation - Create report
• indexing - Index for search

YAML Configuration

Create workers.yaml in your project:

version: '1.0'
workers:
  - name: auth-scanner
    triggers: [auth-scan, scan-auth]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/auth/**", "**/login/**"]
      - type: security-analysis
      - type: secret-detection
      - type: report-generation
    capabilities:
      onnxEmbeddings: true
      vectorDb: true

  - name: api-documenter
    triggers: [api-docs, document-api]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/routes/**", "**/api/**"]
      - type: api-discovery
      - type: type-analysis
      - type: report-generation

Load configuration:

npx ruvector workers load-config --file workers.yaml

CLI Commands

# Core commands
npx ruvector workers presets       # List presets
npx ruvector workers phases        # List phases
npx ruvector workers create <name> --preset <preset>
npx ruvector workers run <name> --path <path>

# Configuration
npx ruvector workers init-config   # Generate workers.yaml
npx ruvector workers load-config   # Load from workers.yaml
npx ruvector workers custom        # List registered workers

# Monitoring
npx ruvector workers status        # Worker status
npx ruvector workers results       # Analysis results
npx ruvector workers stats         # Statistics

MCP Tools

Available via ruvector MCP server:

Tool	Description
workers_presets	List available presets
workers_phases	List phase executors
workers_create	Create custom worker
workers_run	Run worker on path
workers_custom	List custom workers
workers_init_config	Generate config
workers_load_config	Load config

Capabilities

Workers can use these capabilities:

• ONNX Embeddings: Real transformer embeddings (all-MiniLM-L6-v2, 384d, SIMD)
• VectorDB: Store and search embeddings with HNSW indexing
• SONA Learning: Self-Organizing Neural Architecture for pattern learning
• ReasoningBank: Trajectory tracking and meta-learning

Integration with Hooks

Workers auto-dispatch on UserPromptSubmit via trigger keywords:

• Type "audit this code" → triggers audit worker
• Type "security scan" → triggers security worker
• Type "learn patterns" → triggers learning worker

Example: Security Scanner

# Create from security-scan preset
npx ruvector workers create security-checker --preset security-scan --triggers "security,vuln,cve"

# Run on source
npx ruvector workers run security-checker --path ./src

# View results
npx ruvector workers results

Example: Custom Learning Worker

# workers.yaml
workers:
  - name: code-learner
    triggers: [learn, pattern-learn]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/*.ts", "**/*.js"]
          exclude: ["node_modules/**"]
      - type: static-analysis
      - type: pattern-extraction
      - type: embedding-generation
      - type: pattern-storage
      - type: sona-training
    capabilities:
      onnxEmbeddings: true
      vectorDb: true
      sonaLearning: true