π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv6578c0416e1b
diff --git a/v3/docs/adr/README.md b/v3/docs/adr/README.mdindex 48c83c4c4f..ac0c312aaf 100644--- a/v3/docs/adr/README.md+++ b/v3/docs/adr/README.md@@ -26,7 +26,7 @@ All ADRs are located in [`/v3/implementation/adrs/`](../../implementation/adrs/)| [ADR-018](../../implementation/adrs/ADR-018-claude-code-integration.md) | Claude Code Integration | Complete || [ADR-019](../../implementation/adrs/ADR-019-headless-runtime-package.md) | Headless Runtime Package | Complete || [ADR-020](../../implementation/adrs/ADR-020-headless-worker-integration.md) | Headless Worker Integration | Complete |-| [ADR-046](../../implementation/adrs/ADR-046-ruvflow-rebrand.md) | Dual Umbrella: claude-flow + ruvflow | Accepted |+| [ADR-046](../../implementation/adrs/ADR-046-ruflo-rebrand.md) | Dual Umbrella: claude-flow + ruvflow | Accepted || [ADR-047](../../implementation/adrs/ADR-047-fast-mode-integration.md) | Fast Mode Integration | Proposed |## Summary Documentsdiff --git a/v3/implementation/adrs/ADR-046-ruvflow-rebrand.md b/v3/implementation/adrs/ADR-046-ruflo-rebrand.mdsimilarity index 71%rename from v3/implementation/adrs/ADR-046-ruvflow-rebrand.mdrename to v3/implementation/adrs/ADR-046-ruflo-rebrand.mdindex 742e8d567f..0178f96e7c 100644--- a/v3/implementation/adrs/ADR-046-ruvflow-rebrand.md+++ b/v3/implementation/adrs/ADR-046-ruflo-rebrand.md@@ -1,4 +1,4 @@-# ADR-046: Dual Umbrella Packages β claude-flow + ruvflow+# ADR-046: Dual Umbrella Packages β claude-flow + ruflo**Status:** Accepted**Date:** 2026-02-07@@ -7,7 +7,7 @@## Context-The umbrella package is published to npm as `claude-flow`. As the ecosystem grows and the product establishes its own identity, a second umbrella package `ruvflow` is introduced alongside the original.+The umbrella package is published to npm as `claude-flow`. As the ecosystem grows and the product establishes its own identity, a second umbrella package `ruflo` is introduced alongside the original.### Current State@@ -24,13 +24,13 @@ The umbrella package is published to npm as `claude-flow`. As the ecosystem grow1. **Brand Cohesion**: Aligns with the ruv ecosystem (ruv.io, @ruvector/*, ruv-swarm)2. **Trademark Safety**: Removes potential trademark concerns with "Claude" in product name3. **Product Identity**: Establishes independent product identity beyond Claude integration-4. **Discoverability**: "ruvflow" is unique, memorable, and searchable+4. **Discoverability**: "ruflo" is unique, memorable, and searchable5. **Future Flexibility**: Enables the platform to support multiple AI backends without name confusion6. **Zero Disruption**: Keeping `claude-flow` ensures no existing users are broken## Decision-Publish **two independent npm umbrella packages** β `claude-flow` (original) and `ruvflow` (new) β both backed by `@claude-flow/cli`.+Publish **two independent npm umbrella packages** β `claude-flow` (original) and `ruflo` (new) β both backed by `@claude-flow/cli`.### Package Architecture@@ -38,8 +38,8 @@ Publish **two independent npm umbrella packages** β `claude-flow` (original) anpm registryβββ claude-flow β original umbrella (bundles @claude-flow/cli)β βββ bin: claude-flow β v3/@claude-flow/cli/bin/cli.js-βββ ruvflow β new umbrella (depends on @claude-flow/cli)-β βββ bin: ruvflow β @claude-flow/cli/bin/cli.js+βββ ruflo β new umbrella (depends on @claude-flow/cli)+β βββ bin: ruflo β @claude-flow/cli/bin/cli.jsβββ @claude-flow/cli β shared CLI implementation```@@ -47,11 +47,11 @@ npm registry| Aspect | Before | After ||--------|--------|-------|-| npm packages | `claude-flow` only | `claude-flow` + `ruvflow` |-| CLI binaries | `claude-flow` | `claude-flow` + `ruvflow` |-| Install commands | `npx claude-flow@latest` | Both `npx claude-flow@latest` and `npx ruvflow@latest` |-| README branding | "Claude-Flow" | "RuvFlow" (primary), "claude-flow" (supported) |-| Product name | Claude-Flow | RuvFlow (with claude-flow alias) |+| npm packages | `claude-flow` only | `claude-flow` + `ruflo` |+| CLI binaries | `claude-flow` | `claude-flow` + `ruflo` |+| Install commands | `npx claude-flow@latest` | Both `npx claude-flow@latest` and `npx ruflo@latest` |+| README branding | "Claude-Flow" | "Ruflo" (primary), "claude-flow" (supported) |+| Product name | Claude-Flow | Ruflo (with claude-flow alias) |### What Stays the Same@@ -69,7 +69,7 @@ npm registry### Positive1. **Zero Disruption**: Existing `claude-flow` users unaffected-2. **Unified Brand**: New `ruvflow` package for the ruv ecosystem+2. **Unified Brand**: New `ruflo` package for the ruv ecosystem3. **Trademark Safety**: Users can choose the non-"Claude" branded package4. **Dual Discovery**: Package discoverable under both names on npm5. **Future Proof**: Can add non-Claude integrations without name confusion@@ -94,22 +94,22 @@ npm registryβββ package.json # name: "claude-flow" (original umbrella)β # bin: claude-flow β v3/@claude-flow/cli/bin/cli.jsβ # bundles CLI files directly-βββ ruvflow/- βββ package.json # name: "ruvflow" (new umbrella)- β # bin: ruvflow β ./bin/ruvflow.js+βββ ruflo/+ βββ package.json # name: "ruflo" (new umbrella)+ β # bin: ruflo β ./bin/ruflo.jsβ # depends on @claude-flow/cliβββ bin/- β βββ ruvflow.js # thin wrapper, imports @claude-flow/cli- βββ README.md # RuvFlow-branded docs+ β βββ ruflo.js # thin wrapper, imports @claude-flow/cli+ βββ README.md # Ruflo-branded docs```### Phase 1: Preparation (This PR)1. Create ADR-046 (this document)2. Keep root `package.json` as `claude-flow` (original umbrella)-3. Create `ruvflow/` directory with new umbrella package-4. Update main README.md with RuvFlow branding-5. Update install scripts to reference `ruvflow`+3. Create `ruflo/` directory with new umbrella package+4. Update main README.md with Ruflo branding+5. Update install scripts to reference `ruflo`### Phase 2: Publishing@@ -124,10 +124,10 @@ npm publish --tag v3alphanpm dist-tag add claude-flow@<version> latestnpm dist-tag add claude-flow@<version> alpha-# 3. Publish ruvflow umbrella (new)-cd /workspaces/claude-flow/ruvflow+# 3. Publish ruflo umbrella (new)+cd /workspaces/claude-flow/ruflonpm publish --tag alpha-npm dist-tag add ruvflow@<version> latest+npm dist-tag add ruflo@<version> latest```### Phase 3: Ongoing@@ -135,7 +135,7 @@ npm dist-tag add ruvflow@<version> latest1. Both packages maintained indefinitely2. Version numbers kept in sync3. README shows both install options-4. `ruvflow` promoted as primary in new documentation+4. `ruflo` promoted as primary in new documentation## Publishing Checklist@@ -145,11 +145,11 @@ When publishing updates, **all three packages** must be published:|-------|---------|---------|------|| 1 | `@claude-flow/cli` | `npm publish --tag alpha` | alpha, latest || 2 | `claude-flow` | `npm publish --tag v3alpha` | v3alpha, alpha, latest |-| 3 | `ruvflow` | `npm publish --tag alpha` | alpha, latest |+| 3 | `ruflo` | `npm publish --tag alpha` | alpha, latest |## Alternatives Considered-### 1. Replace claude-flow with ruvflow (single package)+### 1. Replace claude-flow with ruflo (single package)**Pros:** Simpler, one package to maintain**Cons:** Breaks existing users, loses download history@@ -159,9 +159,9 @@ When publishing updates, **all three packages** must be published:**Pros:** Matches ruv-swarm pattern**Cons:** Inconsistent with @ruvector (no hyphen)-**Decision:** Rejected - "ruvflow" is cleaner and matches ruvector pattern+**Decision:** Rejected - "ruflo" is cleaner and matches ruvector pattern-### 3. Rename internal packages too (@ruvflow/*)+### 3. Rename internal packages too (@ruflo/*)**Pros:** Complete rebrand**Cons:** Major breaking change, complex migration, npm scope registration@@ -169,7 +169,7 @@ When publishing updates, **all three packages** must be published:### 4. Deprecate claude-flow-**Pros:** Forces migration to ruvflow+**Pros:** Forces migration to ruflo**Cons:** Breaks existing users, bad developer experience**Decision:** Rejected - both packages coexist permanently@@ -179,7 +179,7 @@ When publishing updates, **all three packages** must be published:```bash# Recommended-npx ruvflow@latest init --wizard+npx ruflo@latest init --wizard# Also worksnpx claude-flow@latest init --wizard@@ -192,13 +192,13 @@ No migration required. `claude-flow` continues to work. Optionally switch:```bash# Switch MCP server (optional)claude mcp remove claude-flow-claude mcp add ruvflow npx ruvflow@latest mcp start+claude mcp add ruflo npx ruflo@latest mcp start```### For Contributors1. Root `package.json` is the `claude-flow` umbrella-2. `ruvflow/package.json` is the `ruvflow` umbrella+2. `ruflo/package.json` is the `ruflo` umbrella3. Internal imports remain `@claude-flow/*`4. GitHub repo remains `ruvnet/claude-flow`@@ -209,12 +209,12 @@ claude mcp add ruvflow npx ruvflow@latest mcp start| Combined npm downloads | Maintain or grow | npm weekly stats (both packages) || GitHub stars | Maintain or grow | GitHub metrics || Issues from confusion | < 10 in 30 days | GitHub issues |-| ruvflow adoption | 50%+ new installs in 90 days | npm stats |+| ruflo adoption | 50%+ new installs in 90 days | npm stats |## References- GitHub Issue: #1101-- npm: https://npmjs.com/package/ruvflow+- npm: https://npmjs.com/package/ruflo- npm: https://npmjs.com/package/claude-flow- Related: ADR-017 (RuVector Integration)@@ -224,18 +224,18 @@ claude mcp add ruvflow npx ruvflow@latest mcp start| Context | Use ||---------|-----|-| npm packages | `ruvflow` and `claude-flow` (both lowercase) |-| README title | "RuvFlow" (PascalCase) |-| CLI binaries | `ruvflow` or `claude-flow` (both lowercase) |-| In prose | "RuvFlow" (PascalCase) |+| npm packages | `ruflo` and `claude-flow` (both lowercase) |+| README title | "Ruflo" (PascalCase) |+| CLI binaries | `ruflo` or `claude-flow` (both lowercase) |+| In prose | "Ruflo" (PascalCase) |### Command Examples```bash# New recommended style-npx ruvflow@latest init-npx ruvflow@latest agent spawn -t coder-npx ruvflow@latest swarm init --topology hierarchical+npx ruflo@latest init+npx ruflo@latest agent spawn -t coder+npx ruflo@latest swarm init --topology hierarchical# Legacy style (still fully supported)npx claude-flow@latest init