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

rUv7718b17cb455
diff --git a/README.md b/README.md
index a1ff31a2ae..9af97c82fd 100644
--- a/README.md
+++ b/README.md
@@ -276,6 +276,201 @@ Claude-Flow v3 is built on rigorous architectural specifications with full trace
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
```
+### πŸ—οΈ Architecture Diagrams
+
+<details open>
+<summary>πŸ“Š <strong>System Overview</strong> β€” High-level architecture</summary>
+
+```mermaid
+flowchart TB
+ subgraph User["πŸ‘€ User Layer"]
+ CC[Claude Code]
+ CLI[CLI Commands]
+ end
+
+ subgraph Orchestration["🎯 Orchestration Layer"]
+ MCP[MCP Server]
+ Router[Intelligent Router]
+ Hooks[Self-Learning Hooks]
+ end
+
+ subgraph Agents["πŸ€– Agent Layer"]
+ Queen[Queen Coordinator]
+ Workers[54+ Specialized Agents]
+ Swarm[Swarm Manager]
+ end
+
+ subgraph Intelligence["🧠 Intelligence Layer"]
+ SONA[SONA Learning]
+ MoE[Mixture of Experts]
+ HNSW[HNSW Vector Search]
+ end
+
+ subgraph Providers["☁️ Provider Layer"]
+ Anthropic[Anthropic]
+ OpenAI[OpenAI]
+ Google[Google]
+ Ollama[Ollama]
+ end
+
+ CC --> MCP
+ CLI --> MCP
+ MCP --> Router
+ Router --> Hooks
+ Hooks --> Queen
+ Queen --> Workers
+ Queen --> Swarm
+ Workers --> Intelligence
+ Intelligence --> Providers
+```
+
+</details>
+
+<details>
+<summary>πŸ”„ <strong>Request Flow</strong> β€” How tasks are processed</summary>
+
+```mermaid
+sequenceDiagram
+ participant U as User
+ participant R as Router
+ participant H as Hooks
+ participant A as Agent Pool
+ participant M as Memory
+ participant P as Provider
+
+ U->>R: Submit Task
+ R->>H: pre-task hook
+ H->>H: Analyze complexity
+
+ alt Simple Task
+ H->>A: Agent Booster (WASM)
+ A-->>U: Result (<1ms)
+ else Medium Task
+ H->>A: Spawn Haiku Agent
+ A->>M: Check patterns
+ M-->>A: Cached context
+ A->>P: LLM Call
+ P-->>A: Response
+ A->>H: post-task hook
+ H->>M: Store patterns
+ A-->>U: Result
+ else Complex Task
+ H->>A: Spawn Swarm
+ A->>A: Coordinate agents
+ A->>P: Multiple LLM calls
+ P-->>A: Responses
+ A->>H: post-task hook
+ A-->>U: Result
+ end
+```
+
+</details>
+
+<details>
+<summary>🧠 <strong>Memory Architecture</strong> β€” How knowledge is stored and retrieved</summary>
+
+```mermaid
+flowchart LR
+ subgraph Input["πŸ“₯ Input"]
+ Query[Query/Pattern]
+ end
+
+ subgraph Processing["βš™οΈ Processing"]
+ Embed[ONNX Embeddings]
+ Normalize[Normalization]
+ end
+
+ subgraph Storage["πŸ’Ύ Storage"]
+ HNSW[(HNSW Index<br/>150x faster)]
+ SQLite[(SQLite Cache)]
+ AgentDB[(AgentDB)]
+ end
+
+ subgraph Retrieval["πŸ” Retrieval"]
+ Vector[Vector Search]
+ Semantic[Semantic Match]
+ Results[Top-K Results]
+ end
+
+ Query --> Embed
+ Embed --> Normalize
+ Normalize --> HNSW
+ Normalize --> SQLite
+ HNSW --> Vector
+ SQLite --> Vector
+ AgentDB --> Semantic
+ Vector --> Results
+ Semantic --> Results
+```
+
+</details>
+
+<details>
+<summary>🐝 <strong>Swarm Topology</strong> β€” Multi-agent coordination patterns</summary>
+
+```mermaid
+flowchart TB
+ subgraph Hierarchical["πŸ‘‘ Hierarchical (Default)"]
+ Q1[Queen] --> W1[Worker 1]
+ Q1 --> W2[Worker 2]
+ Q1 --> W3[Worker 3]
+ end
+
+ subgraph Mesh["πŸ•ΈοΈ Mesh"]
+ M1[Agent] <--> M2[Agent]
+ M2 <--> M3[Agent]
+ M3 <--> M1[Agent]
+ end
+
+ subgraph Ring["πŸ’ Ring"]
+ R1[Agent] --> R2[Agent]
+ R2 --> R3[Agent]
+ R3 --> R1
+ end
+
+ subgraph Star["⭐ Star"]
+ S1[Hub] --> S2[Agent]
+ S1 --> S3[Agent]
+ S1 --> S4[Agent]
+ end
+```
+
+</details>
+
+<details>
+<summary>πŸ”’ <strong>Security Layer</strong> β€” Threat detection and prevention</summary>
+
+```mermaid
+flowchart TB
+ subgraph Input["πŸ“₯ Input Validation"]
+ Req[Request] --> Scan[AIDefence Scan]
+ Scan --> PII[PII Detection]
+ Scan --> Inject[Injection Check]
+ Scan --> Jailbreak[Jailbreak Detection]
+ end
+
+ subgraph Decision["βš–οΈ Decision"]
+ PII --> Risk{Risk Level}
+ Inject --> Risk
+ Jailbreak --> Risk
+ end
+
+ subgraph Action["🎬 Action"]
+ Risk -->|Safe| Allow[βœ… Allow]
+ Risk -->|Warning| Sanitize[🧹 Sanitize]
+ Risk -->|Threat| Block[β›” Block]
+ end
+
+ subgraph Learn["πŸ“š Learning"]
+ Allow --> Log[Log Pattern]
+ Sanitize --> Log
+ Block --> Log
+ Log --> Update[Update Model]
+ end
+```
+
+</details>
+
---
<details>