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: Edit /workspaces/claude-code-flow/.claude/agents/swarm/hierarchical-coordinator.md

rUvf31c4079f71f
diff --git a/.claude/agents/swarm/hierarchical-coordinator.md b/.claude/agents/swarm/hierarchical-coordinator.md
index a76a0af407..3c883686c7 100644
--- a/.claude/agents/swarm/hierarchical-coordinator.md
+++ b/.claude/agents/swarm/hierarchical-coordinator.md
@@ -142,6 +142,77 @@ WORKERS WORKERS WORKERS WORKERS
- Lessons learned documentation
```
+## 🚨 MANDATORY MEMORY COORDINATION PROTOCOL
+
+### Every spawned agent MUST follow this pattern:
+
+```javascript
+// 1️⃣ IMMEDIATELY write initial status
+mcp__claude-flow__memory_usage {
+ action: "store",
+ key: "swarm/hierarchical/status",
+ namespace: "coordination",
+ value: JSON.stringify({
+ agent: "hierarchical-coordinator",
+ status: "active",
+ workers: [],
+ tasks_assigned: [],
+ progress: 0
+ })
+}
+
+// 2️⃣ UPDATE progress after each delegation
+mcp__claude-flow__memory_usage {
+ action: "store",
+ key: "swarm/hierarchical/progress",
+ namespace: "coordination",
+ value: JSON.stringify({
+ completed: ["task1", "task2"],
+ in_progress: ["task3", "task4"],
+ workers_active: 5,
+ overall_progress: 45
+ })
+}
+
+// 3️⃣ SHARE command structure for workers
+mcp__claude-flow__memory_usage {
+ action: "store",
+ key: "swarm/shared/hierarchy",
+ namespace: "coordination",
+ value: JSON.stringify({
+ queen: "hierarchical-coordinator",
+ workers: ["worker1", "worker2"],
+ command_chain: {},
+ created_by: "hierarchical-coordinator"
+ })
+}
+
+// 4️⃣ CHECK worker status before assigning
+const workerStatus = mcp__claude-flow__memory_usage {
+ action: "retrieve",
+ key: "swarm/worker-1/status",
+ namespace: "coordination"
+}
+
+// 5️⃣ SIGNAL completion
+mcp__claude-flow__memory_usage {
+ action: "store",
+ key: "swarm/hierarchical/complete",
+ namespace: "coordination",
+ value: JSON.stringify({
+ status: "complete",
+ deliverables: ["final_product"],
+ metrics: {}
+ })
+}
+```
+
+### Memory Key Structure:
+- `swarm/hierarchical/*` - Coordinator's own data
+- `swarm/worker-*/` - Individual worker states
+- `swarm/shared/*` - Shared coordination data
+- ALL use namespace: "coordination"
+
## MCP Tool Integration
### Swarm Management
diff --git a/.claude/checkpoints/1758908164.json b/.claude/checkpoints/1758908164.json
new file mode 100644
index 0000000000..cc82357f47
--- /dev/null
+++ b/.claude/checkpoints/1758908164.json
@@ -0,0 +1 @@
+{"branch": "checkpoint/pre-edit-20250926-173604", "file": "/workspaces/claude-code-flow/.claude/agents/swarm/hierarchical-coordinator.md", "timestamp": "2025-09-26T17:36:04Z", "type": "pre-edit", "original_branch": "alpha-125"}
diff --git a/.claude/checkpoints/1758908166.json b/.claude/checkpoints/1758908166.json
new file mode 100644
index 0000000000..2a06b2b5fe
--- /dev/null
+++ b/.claude/checkpoints/1758908166.json
@@ -0,0 +1 @@
+{"tag": "checkpoint-20250926-173606", "file": "/workspaces/claude-code-flow/.claude/agents/swarm/hierarchical-coordinator.md", "timestamp": "2025-09-26T17:36:06Z", "type": "post-edit", "branch": "alpha-125", "diff_summary": " .claude-flow/metrics/performance.json | 2 +- .claude-flow/metrics/system-metrics.json | 144 +++++++++++++ .claude-flow/metrics/task-metrics.json | 6 +- .claude/agents/MIGRATION_SUMMARY.md | 222 -------------------- .claude/agents/README.md | 89 -------- .claude/agents/consensus/README.md | 253 ----------------------- .claude/agents/optimization/README.md | 250 ---------------------- .claude/agents/swarm/hierarchical-coordinator.md | 8 +- .claude/checkpoints/1758908110.json | 1 + .claude/checkpoints/1758908112.json | 1 + claude-flow-wiki | 0 11 files changed, 154 insertions(+), 822 deletions(-) "}