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

rUvda2e24179d6c
diff --git a/.claude/agents/dual-mode/README.md b/.claude/agents/dual-mode/README.md
index 9746c5b954..46dd0b133c 100644
--- a/.claude/agents/dual-mode/README.md
+++ b/.claude/agents/dual-mode/README.md
@@ -1,62 +1,94 @@
# Dual-Mode Agents (Claude Code + Codex)
-Optional agent configurations for running Claude Code interactively alongside headless Codex workers.
+Optional agents for orchestrating hybrid workflows combining Claude Code (interactive) and Codex (headless) execution.
+
+## Available Agents
+
+| Agent | File | Platform | Purpose |
+|-------|------|----------|---------|
+| `dual-orchestrator` | dual-orchestrator.md | dual | Orchestrate hybrid Claude+Codex workflows |
+| `codex-coordinator` | codex-coordinator.md | dual | Coordinate multiple headless Codex workers |
+| `codex-worker` | codex-worker.md | codex | Headless background worker with self-learning |
## Architecture
```
-β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
-β”‚ CLAUDE CODE (Interactive) CODEX (Headless Background) β”‚
-β”‚ ──────────────────────── ──────────────────────────── β”‚
-β”‚ Direct conversation claude -p "task" & β”‚
-β”‚ Real-time feedback Parallel execution β”‚
-β”‚ Complex reasoning Batch processing β”‚
-β”‚ β”‚
-β”‚ CLAUDE-FLOW (Shared Orchestrator) β”‚
-β”‚ β€’ MCP tools shared by both β”‚
-β”‚ β€’ Vector memory persists across sessions β”‚
-β”‚ β€’ Patterns learned and reused β”‚
-β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
+β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
+β”‚ CLAUDE CODE (Interactive) β”‚
+β”‚ β”œβ”€ Complex reasoning β”‚
+β”‚ β”œβ”€ Architecture decisions β”‚
+β”‚ └─ Real-time review β”‚
+β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
+β”‚ dual-orchestrator β”‚
+β”‚ β”œβ”€ Routes tasks to appropriate platform β”‚
+β”‚ └─ Coordinates hybrid workflows β”‚
+β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
+β”‚ codex-coordinator β”‚
+β”‚ β”œβ”€ Spawns headless workers β”‚
+β”‚ β”œβ”€ Tracks progress via memory β”‚
+β”‚ └─ Aggregates results β”‚
+β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
+β”‚ CODEX (Headless) β”‚
+β”‚ β”œβ”€ codex-worker instances β”‚
+β”‚ β”œβ”€ Run in parallel via `claude -p` β”‚
+β”‚ └─ Store results in shared memory β”‚
+β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
```
-## Available Agents
-
-| Agent | File | Purpose |
-|-------|------|---------|
-| `codex-worker` | codex-worker.yaml | Headless background worker |
-| `codex-coordinator` | codex-coordinator.yaml | Coordinates headless swarm |
-| `dual-orchestrator` | dual-orchestrator.yaml | Claude+Codex coordination |
-
-## Usage
+## Quick Start
-### Spawn Headless Workers from Claude Code
+### 1. Hybrid Development Workflow
+```bash
+# Interactive design β†’ Parallel implementation β†’ Interactive review
+# Use dual-orchestrator agent
+```
+### 2. Spawn Parallel Workers
```bash
-# Spawn parallel Codex workers
-claude -p "Implement feature X" --session-id task-1 &
-claude -p "Write tests for X" --session-id task-2 &
-claude -p "Document feature X" --session-id task-3 &
+# Initialize coordination
+npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents 4
+
+# Spawn workers
+claude -p "Implement auth service" --session-id auth-1 &
+claude -p "Write auth tests" --session-id auth-2 &
wait
+
+# Collect results
+npx claude-flow@v3alpha memory list --namespace results
```
-### Coordinate via Shared Memory
+## When to Use Each Agent
-```bash
-# Initialize shared coordination
-npx claude-flow swarm init --topology hierarchical
+### dual-orchestrator
+- Starting a new feature that needs both design and implementation
+- Deciding whether a task needs interactive reasoning or can run headlessly
+- Coordinating end-to-end hybrid workflows
-# Workers store results
-npx claude-flow memory store --key "task-1-result" --value "..." --namespace results
+### codex-coordinator
+- Spawning multiple parallel workers for batch execution
+- Managing worker lifecycle and result aggregation
+- When the task is already well-defined and can be parallelized
-# Interactive Claude Code reads results
-npx claude-flow memory list --namespace results
-```
+### codex-worker
+- Individual headless execution units
+- Self-learning workers that check memory before/after tasks
+- Background implementation tasks
-## Installation
+## Related Skills
-These agents are optional. To use them:
+See `.claude/skills/dual-mode/` for skill commands:
+- `/dual-spawn` - Spawn headless workers
+- `/dual-coordinate` - Full hybrid workflow
+- `/dual-collect` - Collect worker results
-```bash
-# Already included in .claude/agents/dual-mode/
-# Reference in your workflows as needed
-```
+## Platform Routing
+
+| Task Type | Platform | Agent |
+|-----------|----------|-------|
+| Design/Architecture | Claude Code | dual-orchestrator |
+| Debugging | Claude Code | - |
+| Implementation | Codex | codex-worker |
+| Testing | Codex | codex-worker |
+| Documentation | Codex | codex-worker |
+| Code Review | Claude Code | - |
+| Hybrid Feature | Both | dual-orchestrator |