Ruflo - Nutzer- und Entwickler-Guide
Ruflo ist eine Multi-Agent-Orchestrierungsschicht fuer Werkzeuge wie Claude Code und Codex. Es erweitert sie um Swarms, gemeinsame Memory, Hooks, Plugins, Sicherheitskontrollen und auf Wunsch sogar um Federation ueber mehrere Maschinen. Dieser Guide erklaert, wofuer Ruflo gut ist, wann es zu viel des Guten ist und wie du es sinnvoll einfuehrst.
1. Was ist Ruflo?​
Ruflo ist das Projekt, das frueher Claude Flow hiess. Die Kernidee ist einfach:
- dein Coding-Agent macht weiterhin die eigentliche Coding-Arbeit
- Ruflo koordiniert zusaetzliche Agents, Memory, Routing und Automation darum herum
- die Orchestrierung ist ueber CLI-Befehle, MCP-Server, Plugins, Hooks und Background-Worker erreichbar
Das offizielle README beschreibt Ruflo als Harness fuer Claude Code und Codex mit 100+ spezialisierten Agents, plugin-basierten Faehigkeiten, selbstlernender Memory und Zero-Trust-Federation ueber Maschinen und Teams hinweg.
Das richtige mentale Modell​
| Ebene | Rolle |
|---|---|
| Claude Code / Codex | Der Worker, der Dateien liest, Code aendert, Kommandos ausfuehrt und Aufgaben loest |
| Ruflo | Der Orchestrator, der Arbeit routet, Muster merkt, Swarms koordiniert und Automation ergaenzt |
| LLM-Provider | Claude, GPT, Gemini, Ollama und andere Modell-Backends |
Wenn du erwartest, dass Ruflo selbst deine Features Ende-zu-Ende baut, missverstehst du das Produkt. Sogar Ruflos eigenes AGENTS.md macht das deutlich: Der Coding-Agent fuehrt die Arbeit aus, Ruflo verfolgt und koordiniert sie.
2. Warum Leute Ruflo nutzen​
Ruflo ist attraktiv, weil es versucht, aus einem einzelnen Coding-Agenten ein System zu machen.
Die wichtigsten Vorteile​
| Vorteil | Warum das wichtig ist |
|---|---|
| Multi-Agent-Orchestrierung | Erlaubt die Aufteilung in Planer, Coder, Reviewer, Tester, Security, Docs und weitere Rollen |
| Persistente Memory | Speichert Muster und fruehere Resultate, damit spaetere Laeufe Wiederverwendung bekommen |
| Plugin-Marketplace | Du kannst gezielt Faehigkeiten wie Swarm-Koordination, RAG-Memory, Test-Generierung, Doku, Security oder Observability aktivieren |
| Hooks und Background-Worker | Automation kann vor, waehrend und nach dem normalen Coding-Loop passieren |
| MCP-Server | Stellt Ruflo-Faehigkeiten ueber das Standard-Tool-Protokoll fuer Agent-Clients bereit |
| Sicherheits-Schicht | Das Projekt dokumentiert Input-Validierung, Schutz vor Path Traversal, Schutz vor Command Injection und einen Vulnerability-Workflow |
| Federation | Teams koennen Agent-Installationen ueber Maschinen hinweg verbinden, ohne alles in einen flachen Shared State zu kippen |
Was im Vergleich zu normalen Coding-Agents heraussticht​
Die meisten Coding-Agents sind fuer einen Agent, eine Session, ein Repo optimiert. Ruflo verschiebt den Fokus in Richtung:
- Team-Workflows
- wiederholbare Orchestrierung
- wiederverwendbare Memory
- langlaufende Automation
- spezialisierte Plugins statt eines einzigen Monolithen
Das ist der eigentliche Mehrwert. Ruflo ist weniger "ein besserer Chat" und mehr "eine Betriebsschicht fuer agentische Softwarearbeit".
3. Wo Ruflo gut passt, und wo nicht​
Ruflo passt gut, wenn...​
- du Claude Code oder Codex schon nutzt und mehr Struktur fuer wiederholte Arbeit willst
- du Planer + Coder + Reviewer + Tester-Koordination moechtest
- dein Team gemeinsame Konventionen, Hooks, Memory und Automation braucht
- dir MCP-basierte Erweiterbarkeit wichtig ist
- du lieber mit Plugins arbeitest, statt jeden Workflow selbst zu bauen
- du mit einem System leben kannst, das viele bewegliche Teile hat
Ruflo passt schlecht, wenn...​
- du nur eine schnelle, einfache Single-Agent-CLI willst
- du die Grundlagen von Claude Code oder Codex noch lernst
- du keine Zusatzordner, Hooks, Daemons oder Orchestrierungszustand im Workspace willst
- du minimale operative Komplexitaet willst
- du vor allem Inline-Completion im Editor brauchst statt Workflow-Orchestrierung
Wenn sich Claude Code oder Codex alleine fuer dich schon "zu viel" anfuehlen, ist Ruflo wahrscheinlich gerade auch zu viel. Wenn diese Tools dir dagegen zu isoliert oder zu repetitiv sind, wird Ruflo interessant.
4. Die wichtigste Entscheidung: Plugin-Pfad vs. Vollinstallation​
Ruflo hat zwei sehr unterschiedliche Onboarding-Pfade.
| Pfad | Was du bekommst | Gut fuer | Hauptnachteil |
|---|---|---|---|
| Plugin-Installation | Slash-Commands, einige Skills, Agent-Definitionen | Erstes Ausprobieren mit wenig Commitment | Kein voller MCP-Loop, keine vollstaendige Hook-Orchestrierung |
npx ruflo init | Vollstaendiges Workspace-Setup, MCP-Server, Hooks, Daemon, Helper, Settings | Echte Einfuehrung und produktionsnahe Nutzung | Mehr Dateien, mehr Komplexitaet, mehr Verhaltensaenderungen |
Starte mit dem Plugin-Pfad, wenn...​
- du das Oekosystem erst ansehen willst
- du noch kein Repo veraendern moechtest
- du nur einen schmalen Funktionsbereich brauchst
Starte mit init wizard, wenn...​
- du wirklich das Orchestrierungsmodell willst, das Ruflo bewirbt
- du Memory, Hooks, Background-Worker und vollen MCP-Zugriff willst
- du Ruflo ernsthaft als Teil deines Workflows evaluierst
Empfohlene erste Kommandos​
# Gefuehrte, plattformuebergreifende Einrichtung
npx ruflo@latest init wizard
# Ruflo als MCP-Server in Claude Code eintragen
claude mcp add ruflo -- npx ruflo@latest mcp start
Die Paket-Metadaten im Repo zeigen aktuell an einigen Stellen noch das alte Claude Flow-Naming. Nimm das Rebranding als echt, rechne aber weiter mit Namens-Ueberlappungen in Kommandos, Doku, Dependencies oder Paket-Interna.
5. Wie du Ruflo sinnvoll nutzen solltest​
Der beste Weg ist inkrementell.
5.1 Solo-Developer-Pfad​
- Lerne zuerst deinen Basis-Agenten: Claude Code oder Codex.
- Probiere Ruflo in einem Wegwerf-Repo mit
npx ruflo@latest init wizard. - Nutze eine Woche lang nur Core-Orchestrierung und Memory.
- Fuege Plugins eins nach dem anderen hinzu, statt alles gleichzeitig mental zu installieren.
- Beobachte genau, was Hooks und Background-Worker wirklich tun.
Gute erste Plugins​
| Plugin | Warum hier anfangen |
|---|---|
ruflo-core | Basis-Runtime, Health-Checks, Discovery |
ruflo-swarm | Die Kernidee der Koordination |
ruflo-rag-memory | Macht Memory praktisch statt nur theoretisch |
ruflo-docs | Hilfreich fuer dokumentationslastige Repos |
ruflo-testgen | Gut, wenn du Hilfe bei fehlenden Tests willst |
ruflo-metaharness | Sinnvoll, sobald du das Agent-Setup selbst auditieren willst |
5.2 Team-Pfad​
Ruflo wird besonders dann spannend, wenn ein Team Folgendes moechte:
- standardisierte Hooks
- konsistente Agent-Rollen
- gemeinsame operative Muster
- sichere Grenzen zwischen Installationen
- Auditierbarkeit rund um Agent-Verhalten
Fuer Teams ist der groesste Mehrwert nicht rohe Coding-Geschwindigkeit. Es ist Workflow-Standardisierung.
5.3 Was Codex-Nutzer erwarten sollten​
Ruflo bewirbt oeffentlich Codex-Support, und im Repo gibt es Codex-bezogene Referenzen und Paket-Dependencies. Trotzdem sind Onboarding und Beispiele aktuell deutlich Claude-zentrierter als Codex-zentriert.
Das bedeutet:
- die Orchestrierungs-Ideen gelten trotzdem fuer Codex
- MCP bleibt die zentrale Interoperabilitaetsgeschichte
- aber ein Teil der oeffentlichen Doku, Beispiele und Plugin-Flows ist zuerst fuer Claude-Code-Nutzer geschrieben
Das ist kein Ausschlusskriterium, aber gut zu wissen, bevor du absolute Symmetrie erwartest.
6. Empfohlene Einfuehrungsstrategie​
Wenn du das meiste Signal bei moeglichst wenig Chaos willst, nimm diese Reihenfolge:
Phase 1 - Konzept evaluieren​
npx ruflo@latest init wizardin einem unkritischen Repo ausfuehren- Node 20+ auf deiner Maschine bestaetigen
- ansehen, welche Dateien Ruflo in den Workspace schreibt
- ein paar normale Aufgaben laufen lassen und beobachten, ob die Hooks helfen oder ablenken
Phase 2 - Konkreten Nutzen aufbauen​
- Memory- und Swarm-Funktionen aktiv nutzen
- Docs-/Test-/Security-Plugins an einem echten Schmerzpunkt ausprobieren
- entscheiden, ob das System Ergebnisse besser macht oder nur aufwendiger
Phase 3 - Operationalisieren​
- Observability und Cost Tracking hinzufuegen
- Metaharness und Security-Audit einbeziehen
- dokumentieren, welche Plugins im Team erlaubt sind und warum
Phase 4 - Erst dann Federation pruefen​
Federation ist interessant, aber nicht Schritt eins. Verteile kein System ueber mehrere Maschinen und Trust Boundaries, bevor du ihm auf einer Maschine vertraust.
7. Entwickler-Guide​
Wenn du auf Ruflo aufbauen und es nicht nur benutzen willst, konzentriere dich auf die Erweiterungspunkte.
7.1 Zuerst die Architektur verstehen​
Aus den oeffentlichen Docs und der Repo-Struktur sind diese Teile wichtig:
| Bereich | Wofuer er offenbar zustaendig ist |
|---|---|
docs/ | Grosser User Guide, Status, Roadmap, Validation und operatives Material |
plugins/ | Feature-spezifische Pakete wie Swarm, Memory, Docs, Security, Workflows und Observability |
.claude-plugin/ | Claude-Plugin-Paketierung und Marketplace-Metadaten |
v3/ | Aktuelle Paket-Implementierung fuer CLI, Shared Logic, Guidance und verwandte Module |
| MCP-Server | Tool-Schnittstelle fuer Agent-Clients |
7.2 Erst Plugin-Konsument, dann Plugin-Autor​
Ruflo bringt schon einen breiten Plugin-Katalog mit. Bevor du ein eigenes Plugin schreibst:
- pruefe, ob ein vorhandenes Plugin nah genug dran ist
- teste, wie Hooks, Kommandos und Memory zusammenspielen
- mappe die operative Mehrlast eines weiteren Plugins in deinem Workflow
Erst dann lohnt sich eigene Plugin-Arbeit.
7.3 Gute Kandidaten fuer eigene Plugins​
Eigene Plugins sind sinnvoll, wenn dein Team wiederholt braucht:
- Durchsetzung interner Standards
- repo-spezifische Review-Workflows
- eigene Architektur- oder ADR-Tools
- firmeninterne Connectoren oder MCP-Tools
- domaeinenspezifische Automation, die fuer Upstream zu speziell ist
7.4 Design-Regeln fuer sichere Erweiterungen​
- Plugins klein und fokussiert halten
- beobachtbares Verhalten statt magischem Verhalten bevorzugen
- Side Effects klar dokumentieren
- keine stillen Schreibaktionen
- Hooks wie Produktionscode behandeln, nicht wie niedlichen Glue
- Fehlermodi testen, nicht nur Happy Paths
7.5 Security ist hier wichtiger als bei normalen CLIs​
Weil Ruflo auf Orchestrierung, Automation und Cross-Tool-Ausfuehrung zielt, ist Security-Hygiene besonders wichtig. Die dokumentierte Sicherheitsposition des Projekts nennt:
- Schema-Validierung fuer oeffentliche Inputs
- Schutz vor Path Traversal
- Schutz vor Command Injection
- einen definierten Prozess fuer Vulnerability Reports
Wenn du Ruflo erweiterst, sollte dein Zusatz mindestens genauso streng sein.
8. Wichtige Vorbehalte vor einer festen Einfuehrung​
Ruflo ist beeindruckend, aber kein leichtgewichtiges Tool.
Die wichtigsten Stolpersteine​
| Vorbehalt | Warum das zaehlt |
|---|---|
| Grosse Surface Area | Man kann leicht mehr installieren, als man realistisch versteht |
| Naming-Ueberlappung | Repo, Paket und Docs zeigen teils noch Ruflo und Claude Flow gleichzeitig |
| Dokumentationsgroesse | Der sehr grosse User Guide und die vielen Bausteine erhoehen die Onboarding-Kosten |
| Claude-first Ergonomie | Codex-Support ist da, aber viele oeffentliche Beispiele sind Claude-orientiert |
| Operative Komplexitaet | Hooks, Daemons, Memory-Stores, Plugins und Federation vergroessern die Zahl der Fehlermodi |
Ruflo kann sehr schnell viel Power freilegen. Das bedeutet aber nicht automatisch, dass jede aktivierte Faehigkeit in deinen taeglichen Workflow gehoert.
9. Solltest du Ruflo also nutzen?​
Ja, wenn...​
- du eine Orchestrierungsschicht willst und nicht nur einen Coding-Chat
- du Multi-Agent-Workflows ernsthaft brauchst
- du Plugins, Memory und MCP-basierte Erweiterbarkeit willst
- du bereit bist, ein komplexeres System zu betreiben
Nein, wenn...​
- du hauptsaechlich "ein Modell, eine Aufgabe, ein Terminal" willst
- du keine Automation in deinem Workflow haben moechtest
- du gerade erst grundsaetzlich zwischen Claude Code, Codex, Copilot, Cursor oder OpenCode waehlst
Meine praktische Empfehlung​
Nutze Ruflo als Werkzeug der zweiten Schicht.
- Waehle zuerst deinen primaeren Coding-Agent.
- Entscheide dann, ob du Orchestrierung stark genug brauchst, um den Overhead zu rechtfertigen.
- Wenn ja, starte klein mit Core + Swarm + Memory und wachse von dort weiter.
So bekommst du Ruflos Staerken, ohne die ganze Komplexitaet auf einmal zu importieren.