Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUv8c350b3a06ed
diff --git a/agents/architect.yaml b/agents/architect.yaml
index 80fa184c44..33ed004484 100644
--- a/agents/architect.yaml
+++ b/agents/architect.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- context-caching
- memory-persistence
-createdAt: "2026-01-15T22:58:23.531Z"
+createdAt: "2026-01-15T23:07:42.622Z"
diff --git a/agents/coder.yaml b/agents/coder.yaml
index bbf1ab10db..c4a6fe547c 100644
--- a/agents/coder.yaml
+++ b/agents/coder.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- flash-attention
- token-reduction
-createdAt: "2026-01-15T22:58:23.531Z"
+createdAt: "2026-01-15T23:07:42.622Z"
diff --git a/agents/reviewer.yaml b/agents/reviewer.yaml
index f97ed842cc..7c2fb2c365 100644
--- a/agents/reviewer.yaml
+++ b/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- incremental-analysis
-createdAt: "2026-01-15T22:58:23.532Z"
+createdAt: "2026-01-15T23:07:42.622Z"
diff --git a/agents/security-architect.yaml b/agents/security-architect.yaml
index 0a03db4881..2e0674592c 100644
--- a/agents/security-architect.yaml
+++ b/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- pattern-matching
-createdAt: "2026-01-15T22:58:23.532Z"
+createdAt: "2026-01-15T23:07:42.622Z"
diff --git a/agents/tester.yaml b/agents/tester.yaml
index 5962c59016..d1b4c2e03e 100644
--- a/agents/tester.yaml
+++ b/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-15T22:58:23.532Z"
+createdAt: "2026-01-15T23:07:42.622Z"
diff --git a/v3/@claude-flow/cli/src/init/executor.ts b/v3/@claude-flow/cli/src/init/executor.ts
index 8eae0f9ad2..f99f039de1 100644
--- a/v3/@claude-flow/cli/src/init/executor.ts
+++ b/v3/@claude-flow/cli/src/init/executor.ts
@@ -735,6 +735,406 @@ neural/
fs.writeFileSync(gitignorePath, gitignore, 'utf-8');
result.created.files.push('.claude-flow/.gitignore');
}
+
+ // Write CAPABILITIES.md with full system overview
+ await writeCapabilitiesDoc(targetDir, options, result);
+}
+
+/**
+ * Write CAPABILITIES.md - comprehensive overview of all Claude Flow features
+ */
+async function writeCapabilitiesDoc(
+ targetDir: string,
+ options: InitOptions,
+ result: InitResult
+): Promise<void> {
+ const capabilitiesPath = path.join(targetDir, '.claude-flow', 'CAPABILITIES.md');
+
+ if (fs.existsSync(capabilitiesPath) && !options.force) {
+ result.skipped.push('.claude-flow/CAPABILITIES.md');
+ return;
+ }
+
+ const capabilities = `# Claude Flow V3 - Complete Capabilities Reference
+> Generated: ${new Date().toISOString()}
+> Full documentation: https://github.com/ruvnet/claude-flow
+
+## πŸ“‹ Table of Contents
+
+1. [Overview](#overview)
+2. [Swarm Orchestration](#swarm-orchestration)
+3. [Available Agents (60+)](#available-agents)
+4. [CLI Commands (26 Commands, 140+ Subcommands)](#cli-commands)
+5. [Hooks System (27 Hooks + 12 Workers)](#hooks-system)
+6. [Memory & Intelligence (RuVector)](#memory--intelligence)
+7. [Hive-Mind Consensus](#hive-mind-consensus)
+8. [Performance Targets](#performance-targets)
+9. [Integration Ecosystem](#integration-ecosystem)
+
+---
+
+## Overview
+
+Claude Flow V3 is a domain-driven design architecture for multi-agent AI coordination with:
+
+- **15-Agent Swarm Coordination** with hierarchical and mesh topologies
+- **HNSW Vector Search** - 150x-12,500x faster pattern retrieval
+- **SONA Neural Learning** - Self-optimizing with <0.05ms adaptation
+- **Byzantine Fault Tolerance** - Queen-led consensus mechanisms
+- **MCP Server Integration** - Model Context Protocol support
+
+### Current Configuration
+| Setting | Value |
+|---------|-------|
+| Topology | ${options.runtime.topology} |
+| Max Agents | ${options.runtime.maxAgents} |
+| Memory Backend | ${options.runtime.memoryBackend} |
+| HNSW Indexing | ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'} |
+| Neural Learning | ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'} |
+
+---
+
+## Swarm Orchestration
+
+### Topologies
+| Topology | Description | Best For |
+|----------|-------------|----------|
+| \`hierarchical\` | Queen controls workers directly | Anti-drift, tight control |
+| \`mesh\` | Fully connected peer network | Distributed tasks |
+| \`hierarchical-mesh\` | V3 hybrid (recommended) | 10+ agents |
+| \`ring\` | Circular communication | Sequential workflows |
+| \`star\` | Central coordinator | Simple coordination |
+| \`adaptive\` | Dynamic based on load | Variable workloads |
+
+### Strategies
+- \`balanced\` - Even distribution across agents
+- \`specialized\` - Clear roles, no overlap (anti-drift)
+- \`adaptive\` - Dynamic task routing
+
+### Quick Commands
+\`\`\`bash
+# Initialize swarm
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
+
+# Check status
+npx @claude-flow/cli@latest swarm status
+
+# Monitor activity
+npx @claude-flow/cli@latest swarm monitor
+\`\`\`
+
+---
+
+## Available Agents
+
+### Core Development (5)
+\`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
+
+### V3 Specialized (4)
+\`security-architect\`, \`security-auditor\`, \`memory-specialist\`, \`performance-engineer\`
+
+### Swarm Coordination (5)
+\`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`, \`collective-intelligence-coordinator\`, \`swarm-memory-manager\`
+
+### Consensus & Distributed (7)
+\`byzantine-coordinator\`, \`raft-manager\`, \`gossip-coordinator\`, \`consensus-builder\`, \`crdt-synchronizer\`, \`quorum-manager\`, \`security-manager\`
+
+### Performance & Optimization (5)
+\`perf-analyzer\`, \`performance-benchmarker\`, \`task-orchestrator\`, \`memory-coordinator\`, \`smart-agent\`
+
+### GitHub & Repository (9)
+\`github-modes\`, \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`, \`workflow-automation\`, \`project-board-sync\`, \`repo-architect\`, \`multi-repo-swarm\`
+
+### SPARC Methodology (6)
+\`sparc-coord\`, \`sparc-coder\`, \`specification\`, \`pseudocode\`, \`architecture\`, \`refinement\`
+
+### Specialized Development (8)
+\`backend-dev\`, \`mobile-dev\`, \`ml-developer\`, \`cicd-engineer\`, \`api-docs\`, \`system-architect\`, \`code-analyzer\`, \`base-template-generator\`
+
+### Testing & Validation (2)
+\`tdd-london-swarm\`, \`production-validator\`
+
+### Agent Routing by Task
+| Task Type | Recommended Agents | Topology |
+|-----------|-------------------|----------|
+| Bug Fix | researcher, coder, tester | mesh |
+| New Feature | coordinator, architect, coder, tester, reviewer | hierarchical |
+| Refactoring | architect, coder, reviewer | mesh |
+| Performance | researcher, perf-engineer, coder | hierarchical |
+| Security | security-architect, auditor, reviewer | hierarchical |
+| Docs | researcher, api-docs | mesh |
+
+---
+
+## CLI Commands
+
+### Core Commands (12)
+| Command | Subcommands | Description |
+|---------|-------------|-------------|
+| \`init\` | 4 | Project initialization |
+| \`agent\` | 8 | Agent lifecycle management |
+| \`swarm\` | 6 | Multi-agent coordination |
+| \`memory\` | 11 | AgentDB with HNSW search |
+| \`mcp\` | 9 | MCP server management |
+| \`task\` | 6 | Task assignment |
+| \`session\` | 7 | Session persistence |
+| \`config\` | 7 | Configuration |
+| \`status\` | 3 | System monitoring |
+| \`workflow\` | 6 | Workflow templates |
+| \`hooks\` | 17 | Self-learning hooks |
+| \`hive-mind\` | 6 | Consensus coordination |
+
+### Advanced Commands (14)
+| Command | Subcommands | Description |
+|---------|-------------|-------------|
+| \`daemon\` | 5 | Background workers |
+| \`neural\` | 5 | Pattern training |
+| \`security\` | 6 | Security scanning |
+| \`performance\` | 5 | Profiling & benchmarks |
+| \`providers\` | 5 | AI provider config |
+| \`plugins\` | 5 | Plugin management |
+| \`deployment\` | 5 | Deploy management |
+| \`embeddings\` | 4 | Vector embeddings |
+| \`claims\` | 4 | Authorization |
+| \`migrate\` | 5 | V2β†’V3 migration |
+| \`process\` | 4 | Process management |
+| \`doctor\` | 1 | Health diagnostics |
+| \`completions\` | 4 | Shell completions |
+
+### Example Commands
+\`\`\`bash
+# Initialize
+npx @claude-flow/cli@latest init --wizard
+
+# Spawn agent
+npx @claude-flow/cli@latest agent spawn -t coder --name my-coder
+
+# Memory operations
+npx @claude-flow/cli@latest memory store --key "pattern" --value "data" --namespace patterns
+npx @claude-flow/cli@latest memory search --query "authentication"
+
+# Diagnostics
+npx @claude-flow/cli@latest doctor --fix
+\`\`\`
+
+---
+
+## Hooks System
+
+### 27 Available Hooks
+
+#### Core Hooks (6)
+| Hook | Description |
+|------|-------------|
+| \`pre-edit\` | Context before file edits |
+| \`post-edit\` | Record edit outcomes |
+| \`pre-command\` | Risk assessment |
+| \`post-command\` | Command metrics |
+| \`pre-task\` | Task start + agent suggestions |
+| \`post-task\` | Task completion learning |
+
+#### Session Hooks (4)
+| Hook | Description |
+|------|-------------|
+| \`session-start\` | Start/restore session |
+| \`session-end\` | Persist state |
+| \`session-restore\` | Restore previous |
+| \`notify\` | Cross-agent notifications |
+
+#### Intelligence Hooks (5)
+| Hook | Description |
+|------|-------------|
+| \`route\` | Optimal agent routing |
+| \`explain\` | Routing decisions |
+| \`pretrain\` | Bootstrap intelligence |
+| \`build-agents\` | Generate configs |
+| \`transfer\` | Pattern transfer |
+
+#### Coverage Hooks (3)
+| Hook | Description |
+|------|-------------|
+| \`coverage-route\` | Coverage-based routing |
+| \`coverage-suggest\` | Improvement suggestions |
+| \`coverage-gaps\` | Gap analysis |
+
+### 12 Background Workers
+| Worker | Priority | Purpose |
+|--------|----------|---------|
+| \`ultralearn\` | normal | Deep knowledge |
+| \`optimize\` | high | Performance |
+| \`consolidate\` | low | Memory consolidation |
+| \`predict\` | normal | Predictive preload |
+| \`audit\` | critical | Security |
+| \`map\` | normal | Codebase mapping |
+| \`preload\` | low | Resource preload |
+| \`deepdive\` | normal | Deep analysis |
+| \`document\` | normal | Auto-docs |
+| \`refactor\` | normal | Suggestions |
+| \`benchmark\` | normal | Benchmarking |
+| \`testgaps\` | normal | Coverage gaps |
+
+---
+
+## Memory & Intelligence
+
+### RuVector Intelligence System
+- **SONA**: Self-Optimizing Neural Architecture (<0.05ms)
+- **MoE**: Mixture of Experts routing
+- **HNSW**: 150x-12,500x faster search
+- **EWC++**: Prevents catastrophic forgetting
+- **Flash Attention**: 2.49x-7.47x speedup
+- **Int8 Quantization**: 3.92x memory reduction
+
+### 4-Step Intelligence Pipeline
+1. **RETRIEVE** - HNSW pattern search
+2. **JUDGE** - Success/failure verdicts
+3. **DISTILL** - LoRA learning extraction
+4. **CONSOLIDATE** - EWC++ preservation
+
+### Memory Commands
+\`\`\`bash
+# Store pattern
+npx @claude-flow/cli@latest memory store --key "name" --value "data" --namespace patterns
+
+# Semantic search
+npx @claude-flow/cli@latest memory search --query "authentication"
+
+# List entries
+npx @claude-flow/cli@latest memory list --namespace patterns
+
+# Initialize database
+npx @claude-flow/cli@latest memory init --force
+\`\`\`
+
+---
+
+## Hive-Mind Consensus
+
+### Queen Types
+| Type | Role |
+|------|------|
+| Strategic Queen | Long-term planning |
+| Tactical Queen | Execution coordination |
+| Adaptive Queen | Dynamic optimization |
+
+### Worker Types (8)
+\`researcher\`, \`coder\`, \`analyst\`, \`tester\`, \`architect\`, \`reviewer\`, \`optimizer\`, \`documenter\`
+
+### Consensus Mechanisms
+| Mechanism | Fault Tolerance | Use Case |
+|-----------|-----------------|----------|
+| \`byzantine\` | f < n/3 faulty | Adversarial |
+| \`raft\` | f < n/2 failed | Leader-based |
+| \`gossip\` | Eventually consistent | Large scale |
+| \`crdt\` | Conflict-free | Distributed |
+| \`quorum\` | Configurable | Flexible |
+
+### Hive-Mind Commands
+\`\`\`bash
+# Initialize
+npx @claude-flow/cli@latest hive-mind init --queen-type strategic
+
+# Status
+npx @claude-flow/cli@latest hive-mind status
+
+# Spawn workers
+npx @claude-flow/cli@latest hive-mind spawn --count 5 --type worker
+
+# Consensus
+npx @claude-flow/cli@latest hive-mind consensus --propose "task"
+\`\`\`
+
+---
+
+## Performance Targets
+
+| Metric | Target | Status |
+|--------|--------|--------|
+| HNSW Search | 150x-12,500x faster | βœ… Implemented |
+| Memory Reduction | 50-75% | βœ… Implemented (3.92x) |
+| SONA Integration | Pattern learning | βœ… Implemented |
+| Flash Attention | 2.49x-7.47x | πŸ”„ In Progress |
+| MCP Response | <100ms | βœ… Achieved |
+| CLI Startup | <500ms | βœ… Achieved |
+| SONA Adaptation | <0.05ms | πŸ”„ In Progress |
+
+---
+
+## Integration Ecosystem
+
+### Integrated Packages
+| Package | Version | Purpose |
+|---------|---------|---------|
+| agentic-flow | 2.0.1-alpha | Core coordination |
+| agentdb | 2.0.0-alpha.3.4 | Vector database |
+| @ruvector/attention | 0.1.3 | Flash attention |
+| @ruvector/sona | 0.1.5 | Neural learning |
+
+### Optional Integrations
+| Package | Command |
+|---------|---------|
+| ruv-swarm | \`npx ruv-swarm mcp start\` |
+| flow-nexus | \`npx flow-nexus@latest mcp start\` |
+| agentic-jujutsu | \`npx agentic-jujutsu@latest\` |
+
+### MCP Server Setup
+\`\`\`bash
+# Add Claude Flow MCP
+claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
+
+# Optional servers
+claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start
+claude mcp add flow-nexus -- npx -y flow-nexus@latest mcp start
+\`\`\`
+
+---
+
+## Quick Reference
+
+### Essential Commands
+\`\`\`bash
+# Setup
+npx @claude-flow/cli@latest init --wizard
+npx @claude-flow/cli@latest daemon start
+npx @claude-flow/cli@latest doctor --fix
+
+# Swarm
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8
+npx @claude-flow/cli@latest swarm status
+
+# Agents
+npx @claude-flow/cli@latest agent spawn -t coder
+npx @claude-flow/cli@latest agent list
+
+# Memory
+npx @claude-flow/cli@latest memory search --query "patterns"
+
+# Hooks
+npx @claude-flow/cli@latest hooks pre-task --description "task"
+npx @claude-flow/cli@latest hooks worker dispatch --trigger optimize
+\`\`\`
+
+### File Structure
+\`\`\`
+.claude-flow/
+β”œβ”€β”€ config.yaml # Runtime configuration
+β”œβ”€β”€ CAPABILITIES.md # This file
+β”œβ”€β”€ data/ # Memory storage
+β”œβ”€β”€ logs/ # Operation logs
+β”œβ”€β”€ sessions/ # Session state
+β”œβ”€β”€ hooks/ # Custom hooks
+β”œβ”€β”€ agents/ # Agent configs
+└── workflows/ # Workflow templates
+\`\`\`
+
+---
+
+**Full Documentation**: https://github.com/ruvnet/claude-flow
+**Issues**: https://github.com/ruvnet/claude-flow/issues
+`;
+
+ fs.writeFileSync(capabilitiesPath, capabilities, 'utf-8');
+ result.created.files.push('.claude-flow/CAPABILITIES.md');
}
/**