Ruflo
- 추천0
- GitHub 별82K
- 개발라이선스MIT
Claude Code · Codex용 멀티 에이전트 메타 하네스. 에이전트 군집 조율 · 벡터 메모리 · 자기 학습 · MCP 서버 포함
원본:ruvnet/ruflo
요약
Claude Code · Codex용 멀티 에이전트 메타 하네스. 에이전트 군집 조율 · 벡터 메모리 · 자기 학습 · MCP 서버 포함
설명

Claude Code와 Codex를 위한 에이전트 메타 하네스예요.
명령 한 줄로 시작하기
프로젝트 폴더에서 이걸 실행하세요.
npx ruflo@latest init
그다음 같은 폴더에서 Claude Code를 열고 실제 작업을 시켜 보세요. 예를 들면 이렇게요.
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
init은 ruflo의 에이전트 · 훅 · 메모리 · MCP 서버를 프로젝트에 추가하고, Claude Code는 다음에 켤 때 이를 불러와요. Codex와 다른 MCP 클라이언트도 쓸 수 있어요. 이들은 npx -y ruflo@latest mcp start를 가리키게 하면 돼요.
첫 번째 쓸모 있는 작업, 단계별로 · 사용자 설명서 · 설치 방법 비교
다른 설치 방법 (Claude Code 플러그인만, MCP 전용 클라이언트, 터미널 UI)
Claude Code 플러그인만 쓰기. 이 방법은 핵심 도구, 시각 콘솔, 런타임 모드를 설치하고 프로젝트에 파일을 추가하지 않아요. Claude Code 2.1.287 이상이 필요해요. Claude Code 안에서 실행하세요.
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo
Claude Code 2.1.292 이상이면 터미널에서 이렇게도 돼요: claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo. 모드는 내 계정 권한으로 실행되니 설치 전에 코드를 검토하세요.
프로젝트 설정 없이 Codex나 다른 MCP 클라이언트에서 쓰기. 명령은 npx, 인자는 ["-y", "ruflo@latest", "mcp", "start"]로 설정하세요. 프로젝트를 대화형으로 설정하려면 npx ruflo@latest init wizard를 실행하세요.
그냥 터미널에서 쓰기. 콘솔은 Claude Code 없이 혼자서도 실행돼요: npx ruflo tui. 스크립트용으로 한 프레임만 출력하려면 --plain을 붙이세요. 터미널 UI 안내를 보세요.

선택 사항: ruOS Desktop
MCP로 ruOS를 ChatGPT나 Claude에 연결하기:
https://ruos.cognitum.one/mcp
npx ruvector
Ruflo
📖 RuFlo 해설 — 계획하고, 기억하고, 테스트하고, 개선하는 AI 팀 만들기 기본 개념에서 첫 번째 쓸모 있는 작업까지, 이어서 메모리 · 에이전트 팀 · 플러그인 · 비용 · 검증을 다루는 14장짜리 안내서예요.
에이전트 = 모델 + 하네스. 모델은 글을 쓰고, 하네스는 거기에 도구 · 메모리 · 반복 구조 · 샌드박스 · 통제 장치를 줘서 실제로 일하게 해요. Ruflo가 그 하네스예요. Claude Code와 Codex를 감싸는 실행 계층으로, 전문 에이전트 100개 이상, 조율되는 군집, 자기 학습 메모리, 기계 간 연합 통신, 기업용 보안 가드레일을 더해요. 에이전트가 그냥 실행되는 데서 끝나지 않고 서로 협력하게 하려는 거예요.
npx ruflo init 한 번이면 Claude Code에 신경계가 생겨요. 에이전트가 스스로 군집을 이루고, 작업마다 배우고, 세션이 끝나도 기억하고, 연합 기능을 쓰면 데이터를 새지 않으면서 다른 기계의 에이전트와 안전하게 대화해요. 코드는 계속 내가 쓰면 되고, 조율은 Ruflo가 맡아요.
개념으로 그린 학습 순환이에요. 로컬 벡터 검색과 대조 갱신은 LLM 없이 돌 수 있지만, 임베딩과 설정한 학습 모듈은 여전히 필요해요. RuVector 학습 연동과 궤적 대조 학습을 보세요.
글로 본 구조
사용자 → Ruflo(CLI/MCP) → 라우터 → 군집 → 에이전트 → 메모리 → LLM 제공자. 메모리는 쓸모 있는 경험을 라우팅으로 되돌려 보내요. 개념 흐름이지 실제 실행 기록은 아니에요.
Ruflo가 처음이라면? MCP 도구 406개와 CLI 명령 61개를 배울 필요는 없어요.
init을 한 뒤에는 Claude Code를 평소처럼 쓰면 돼요. 훅 시스템이 알아서 작업을 라우팅하고, 성공한 패턴에서 배우고, 뒤에서 에이전트를 조율해요.
직접 확인할 수 있는 출발점
Reuven Cohen(rUv)이 만들었고, 처음 이름은 Claude Flow였어요. 첫 커밋(2025년 6월 2일)은 재귀적인 에이전트 순환, 즉 Claude가 쓰고 · 고치고 · 테스트하고 · 개선하는 흐름을 위한 코드 오케스트레이션 계층을 설명해요. 6월 10일 소스 스냅샷에는 오케스트레이션 · 작업 스케줄링 · 메모리 · 터미널 모듈이 더해져요.
하네스는 모델 둘레의 작업대예요. 작업을 정리하고, 단계 사이에 맥락을 넘기고, 결과를 확인하도록 도와요. 이 내용은 Ruflo의 계보를 밝히는 것이지, 모든 Claude Code 도구를 통틀어 처음이라는 뜻은 아니에요. 그림 설명, 정확한 커밋, 앞선 생태계 맥락을 보세요.
Grok Build: npx ruflo init --grok는 프로젝트 호스트 표면(.grok/, 팀 버스, 운영자 안내서)을 쓰고 프로젝트 밖에는 아무것도 쓰지 않아요. 미리 보려면 --dry-run을 붙이세요. 설정, spawn_subagent 계약, 선택 사항인 상태 줄, Grok이 업데이트될 때 다시 확인할 것은 Grok 운영자 안내서에 있어요.
배경 — 이름의 유래
Claude Flow는 이제 Ruflo예요. 러스트와 몰입 상태, 그리고 피할 수 없을 것처럼 느껴지는 것을 만드는 일을 좋아하는
rUv가 지은 이름이에요. "Ru"는 rUv고, "flo"는 새벽 3시까지 일하는 거예요. 속에서는Cognitum.One에이전트 아키텍처가 받치고 있고, 한층 강화된 러스트 기반 AI 엔진 · 임베딩 · 메모리 · 플러그인 시스템이 돌아가요.
움직이는 데모 열기 · 테마 스튜디오 안내 · 워크플로 데모
내 에이전트의 조종석. 워크플로 · 에이전트 · 모델 · 토큰 · 비용을 Claude Code 옆에서 추적해요. 38초짜리 애니메이션은 부팅 점검, 여섯 가지 팔레트, 사용자 지정, 저장된 테마, JSON 가져오기, 크기 조정까지 오비탈과 테마 스튜디오를 실제 렌더러 프레임으로 보여 줘요. 용량을 줄인 3.84MB SVG에 456개 프레임이 모두 들어 있어요. 네이티브 호스트와 AI 제공자 실행은 시연하지 않아요.
어떤 실행이든 들여다보세요. 에이전트 로그와 결과를 열고, 검색하고, 실패를 가려내고, 다시 재생하고 비교해요.
npx ruflo init으로 시작해 Claude Code를 다시 켠 뒤 /ruflo를 입력하세요. 콘솔 전체 둘러보기.
Claude가 운전하고, 한계는 내가 정해요. 설정 → Claude 제어를 켜면 Claude가 콘솔을 이동하고 동작을 실행할 수 있어요. 권한 수준은
read, write, manage, full 중에서, 승인 방식은 ask나 auto로 고르세요. 지금 기본값은 read + ask이고, 수준을 올리는 건 내 선택이에요. 내 권한 수준을 넘는 동작은 거절되고, 네트워크 · 비용 · 되돌릴 수 없는 동작은 auto에서도 확인을 받아요. 실시간 동작 기록을 확인하거나 제어권 되찾기를 눌러 Claude 제어를 멈출 수 있어요. 자세히.
작업 하나: Claude로 미션 만들기

아래 녹화된 콘솔 세션을 보세요. Claude가 미션을 만들고, 학습 · 보안 페이지를 열고, 한 일을 개요에 보고해요.
- 경계를 정해요. 아래 명령으로 콘솔을 설치하고
/ruflo를 연 뒤 설정 → Claude 제어 → write + ask를 고르세요. - 구체적으로 요청해요. 이렇게 말해 보세요: “Create a mission to add a dark mode toggle. Show me the mission and its status.”
- 만들기를 승인해요. Claude가 미션 화면을 열고 목표를 정해요. 콘솔에 뜬 대기 중인 만들기 동작을 확인해 주세요.
- 결과를 확인해요. 미션 목록에 그 목표가 있고 개요에 그 동작이 기록됐는지 보세요. 미션을 만들었다고 해서 그 기능이 구현된 것은 아니에요.
- 통제권을 쥐고 있어요. 제어권 되찾기를 누르면 Claude의 콘솔 도구가 멈춰요. 그다음 호출은 제어권을 돌려줄 때까지 거절돼야 해요.
녹화가 보여 주는 것: write + auto로 돈 실제 Claude Haiku 세션, 미션 만들기, 페이지 이동, 거절된 군집 중지, 제어권 되찾기예요. 위 단계는 직접 만들기를 승인하도록 ask를 써요. 링크된 워크플로 애니메이션은 샘플 데이터를 쓰고, 테마 데모는 렌더러 프레임을 다시 재생한 거예요. 둘 다 군집 작업이 끝났다거나 메모리가 회수됐다는 증거는 아니에요.
ruflo 마켓플레이스에서 모드 설치하기 (Claude Code 2.1.287 이상. 모드는 내 계정 권한으로 실행되고 샌드박스가 없으니 먼저 코드를 읽어 보세요):
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
ruflo-console은 위의 조종석이고, ruflo-mods는 프롬프트를 라우팅하고 정책을 프로세스 안에서 적용하고, ruflo-swarm은 군집을 창 하나에 보여 주고, ruflo-ruos는 ruOS 상태 구간을 더해요. /plugin을 열어 활성 모드 줄에 나타나는지 확인하세요. 콘솔 안의 /ruflo market은 플러그인 카탈로그예요. ruflo의 모든 플러그인 · 모드 · 스킬과 그것들이 담은 것을 보여 주고, 설치 · 활성화 · 비활성화 · 업데이트 버튼이 있어요(각각 먼저 물어봐요).
빠른 시작
표면 범위가 아주 다른 설치 경로가 두 가지 있어요. 필요한 것에 맞춰 고르세요 (#1744):
| Claude Code 플러그인 | CLI 설치 (npx ruflo init) | |
|---|---|---|
| 무엇을 주나요 | 플러그인별 슬래시 명령 + 소수의 스킬 + 에이전트 정의 | 완전한 Ruflo 순환 — 에이전트 98개, 명령 60개 이상, 스킬 30개, MCP 서버, 훅, 데몬 |
| 작업 공간에 생기는 파일 | 없음 | .claude/, .claude-flow/, CLAUDE.md, 헬퍼, 설정 |
| MCP 서버 등록 | ruflo-core를 설치한 경우만(자체 .mcp.json을 들고 있어요). 다른 플러그인 대부분은 아니에요 | 예 |
| 훅 설치 | 아니요 | 예 |
| 잘 맞는 경우 | 전체 설치를 하지 않고 플러그인 하나의 명령만 써 보고 싶을 때 | 실제 사용 — 문서대로 모든 게 동작해요 |
경로 A — Claude Code 플러그인 (가벼운 방식, 슬래시 명령만)
# Add the marketplace
/plugin marketplace add ruvnet/ruflo
# Install core + any plugins you need
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo
이렇게 하면 슬래시 명령과 에이전트 정의가 추가돼요. (위에서 설치한) ruflo-core는 설치할 때 자체 MCP 서버를 등록해요. 그 도구는 CLI 방식의 뼈대가 쓰는 memory_store/swarm_init/agent_spawn 같은 이름이 아니라 mcp__plugin_ruflo-core_ruflo__*(예: mcp__plugin_ruflo-core_ruflo__memory_store)로 호출해요. 다른 플러그인은 대체로 자체 MCP 서버를 싣지 않아요. CLI 방식의 도구 이름으로 전체 순환을 쓰려면 아래 경로 B를 쓰세요.
플러그인 48개 전체 (외부 3개 포함)
핵심 · 오케스트레이션
| 플러그인 | 하는 일 |
|---|---|
| ruflo-core | 기반 — 서버, 상태 점검, 플러그인 탐색 |
| ruflo-swarm | 여러 에이전트를 한 팀으로 조율 |
| ruflo-autopilot | 에이전트가 반복 구조 안에서 자율적으로 실행 |
| ruflo-loop-workers | 배경 작업을 타이머로 예약 |
| ruflo-workflows | 재사용할 수 있는 다단계 작업 템플릿 |
| ruflo-federation | 서로 다른 기계의 에이전트가 안전하게 협업 |
| ruflo-console | Claude Code 안의 조종석, 그리고 ruflo 모드용 /ruflo 명령 |
| ruflo-mods | 프로세스 안에서 도는 Claude Code 모드 — 라우팅, 학습 신호, 정책 점검 |
| ruflo-ai-team | 테넌트가 분리된 팀. 일을 나누고 증거를 돌려줘요 |
| ruflo-agntcy | AGNTCY/Outshift 전송과 의도 범위 도구 권한 부여 |
| ruflo-bbs-federation | 다른 호스트의 에이전트가 협업할 수 있는 AgentBBS 방 |
| ruflo-chatgpt-federation | 자체 서명 키를 쓰는 ChatGPT 연합 게시자 |
| ruflo-x-gateway | 서명된 연합 메시지, 채널, 작업 선점 |
| ruflo-business-pods | 업무 분야별 파드 템플릿과 시험 실행(dry-run) 틱 러너 |
메모리 · 지식
| 플러그인 | 하는 일 |
|---|---|
| ruflo-agentdb | 에이전트 메모리를 위한 빠른 벡터 데이터베이스 |
| ruflo-rag-memory | 똑똑한 검색 — 하이브리드 검색, 그래프 홉, 다양성 순위 |
| ruflo-rvf | 세션이 바뀌어도 에이전트 메모리를 저장하고 복원 |
| ruflo-ruvector | ruvector — GPU 가속 검색, 그래프 RAG, 도구 103개 |
| ruflo-knowledge-graph | 개체 관계 지도를 만들고 탐색 |
지능 · 학습
| 플러그인 | 하는 일 |
|---|---|
| ruflo-intelligence | 에이전트가 지난 성공에서 배워 더 똑똑해져요 |
| ruflo-graph-intelligence | 준선형 그래프 추론 — 페이지랭크, 변경분 갱신, 복잡도를 따지는 실행 (ADR-123) |
| ruflo-daa | 동적 에이전트 행동과 인지 패턴 |
| ruflo-ruvllm | 로컬 LLM(Ollama 등)을 똑똑한 라우팅으로 실행 |
| ruflo-goals | 큰 목표를 계획으로 쪼개고 진행을 추적 |
| ruflo-deepseek-harness | DeepSeek 기반 워크플로를 위한 에이전트 · 명령 · 스킬 |
코드 품질 · 테스트
| 플러그인 | 하는 일 |
|---|---|
| ruflo-testgen | 빠진 테스트를 찾고 자동으로 생성 |
| ruflo-browser | Playwright로 브라우저 테스트 자동화 |
| ruflo-jujutsu | git diff를 분석하고, 위험을 점수로 매기고, 검토자를 제안 |
| ruflo-rure | 분석할 권한이 있는 로컬 JS/Electron 앱의 정적 분석. 파일과 줄 번호 근거를 제시 |
| ruflo-docs | 문서를 자동으로 생성하고 유지 |
| agentic-qe-fleet | 외부 플러그인으로 Agentic QE가 관리해요. QE 에이전트 11개, 테스트 생성 · 커버리지 · 카오스 · TDD 스킬, agentic-qe MCP 서버, AQE 학습 데이터 보호 장치를 담아요 (/plugin install agentic-qe-fleet@ruflo). agentic-qe와 ruflo 중 마켓플레이스 한 곳에서만 설치하세요. 둘 다에서 활성화하면 모드와 명령이 두 번 불러와져요 |
| agentdb | 외부 플러그인으로 ruvnet/agentdb에서 관리해요. agentdb 자체 MCP 서버(agentdb@3.2.0 고정: 키워드 + 벡터 하이브리드 검색, 선택형 교차 인코더 재순위), 메모리 전문 에이전트, 벡터 메모리 · 학습 · 진단 스킬, /agentdb-status, 비밀이 메모리에 들어가지 못하게 막고 허용하지 않으면 삭제 · 초기화를 거절하는 보호 장치를 담아요 (/plugin install agentdb@ruflo). ruflo 서버를 통해 AgentDB를 쓰려면 ruflo-agentdb를 쓰세요. 둘은 함께 쓸 수 있어요. agentdb와 ruflo 중 마켓플레이스 한 곳에서만 설치하세요 |
| agentic-flow | 외부 플러그인으로 ruvnet/agentic-flow에서 관리해요. agentic-flow MCP 서버(agentic-flow@3.1.0 고정, 기본은 readonly 프로필, 미리 승인된 것 없음), ReasoningBank와 모델 라우터 에이전트, 라우팅 · 학습 · 오토파일럿 스킬, /agentic-flow-status, agentic_flow_agent 보호 장치를 담아요 (/plugin install agentic-flow@ruflo). agentic-flow와 ruflo 중 마켓플레이스 한 곳에서만 설치하세요 |
보안 · 규정 준수
| 플러그인 | 하는 일 |
|---|---|
| ruflo-security-audit | 취약점과 CVE 검사 |
| ruflo-aidefence | 프롬프트 주입 차단, 개인정보(PII) 탐지, 안전 검사 |
| ruflo-protector | 사람이 지켜보지 않는 에이전트를 위한 선택형 감시 — 학습, 알림, 강제 중 선택 |
아키텍처 · 방법론
| 플러그인 | 하는 일 |
|---|---|
| ruflo-adr | 살아 있는 기록으로 아키텍처 결정을 추적 |
| ruflo-ddd | 도메인 주도 설계 뼈대 — 컨텍스트, 애그리거트, 이벤트 |
| ruflo-sparc | 품질 관문이 있는 5단계 개발 방법론 안내 |
| ruflo-metaharness | 에이전트 구성에 점수를 매기고, 도구 설정의 보안 위험을 검사하고, 시간에 따른 변화를 추적 (안내서) |
| ruflo-arena | 경쟁형 룰리올로지 — 에이전트 전략을 토너먼트에서 맞붙이고, 승자를 언덕 오르기와 공진화로 키워요 (ADR-147/148) |
데브옵스 · 관측
| 플러그인 | 하는 일 |
|---|---|
| ruflo-migrations | 데이터베이스 스키마 변경을 안전하게 관리 |
| ruflo-observability | 구조화된 로그 · 추적 · 지표를 한곳에서 |
| ruflo-cost-tracker | 토큰 사용량 추적, 예산 설정, 비용 경보 |
| ruflo-ruos | 내 ruOS 클라우드 데스크톱에서 군집 에이전트 실행 |
확장성
| 플러그인 | 하는 일 |
|---|---|
| ruflo-agent | 에이전트 실행 — 로컬 WASM 샌드박스(rvagent) + Anthropic Claude Managed Agents(클라우드). 선택형 제한된 동적 워크플로, 관문이 있는 세션 제어, 검증된 참고용 학습 포함 |
| ruflo-plugin-creator | 나만의 플러그인의 뼈대 만들기, 검증, 게시 |
특정 분야
| 플러그인 | 하는 일 |
|---|---|
| ruflo-iot-cognitum | IoT 기기 관리 — 신뢰 점수, 이상 탐지, 기기 군 |
| ruflo-neural-trader | neural-trader — 에이전트 4개, 백테스트, 도구 112개 이상의 AI 트레이딩 |
| ruflo-market-data | 시장 데이터 수집, OHLCV 벡터화, 패턴 탐지 |
| ruflo-music | Cognitum Music 계정으로 음악 작곡 · 생성 |
CLI 설치
macOS / Linux / WSL / Git-Bash:
# One-line install (POSIX shells only — see Windows note below)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
모든 플랫폼 (네이티브 Windows PowerShell / cmd 포함):
# Interactive setup wizard — runs identically on every platform
npx ruflo@latest init wizard
# Quick non-interactive init
# npx ruflo@latest init
# Or install globally
npm install -g ruflo@latest
💡 Windows 사용자:
curl ... | bash형태는 POSIX 셸(Git-Bash, WSL, MSYS)이 필요해요.npx ruflo@latest init wizard줄은 PowerShell과 cmd에서 그대로 돼요.'bash' is not recognized오류가 나면npx줄을 쓰세요. 둘 다 같은 초기화 흐름을 실행해요.
MCP 서버
# Add Ruflo as an MCP server in Claude Code
claude mcp add claude-flow -- npx ruflo@latest mcp start
로컬 애플리케이션과 바이너리를 정적으로 점검하려면 ruRE 플러그인 안내를 보세요.
얻는 것
| 기능 | 설명 |
|---|---|
| 에이전트 100개 이상 | 코딩 · 테스트 · 보안 · 문서 · 아키텍처를 맡는 전문 에이전트 |
| 통신 계층 | 무신뢰(zero-trust) 연합 — 기계와 조직을 넘나드는 에이전트가 서로 찾고, 인증하고, 안전하게 작업을 주고받아요 |
| 군집 조율 | 계층형 · 메시형 · 적응형 토폴로지와 합의 |
| 자기 학습 | SONA 신경 패턴, ReasoningBank, 궤적 학습 |
| 벡터 메모리 | HNSW 색인 AgentDB — 전수 비교보다 N=20k에서 약 1.9배, N=5k에서 약 3.2~4.7배 빠른 것으로 측정됐어요(recall@10 약 0.99). 교차점을 넘으면 ANN이 이기고, N이 작으면 비기거나 져요. 감사 문서와 scripts/benchmark-intelligence.mjs를 보세요 |
| 배경 작업자 | 자동으로 시작되는 작업자 12개(audit, optimize, testgaps 등) |
| 플러그인 마켓플레이스 | Claude Code 네이티브 플러그인 48개 + 저장소 안 npm 플러그인 14개 |
| 다중 제공자 | Claude, GPT, Gemini, Cohere, Ollama를 똑똑하게 라우팅 |
| 보안 | AIDefence, 입력 검증, CVE 조치, 경로 순회 방지 |
| 에이전트 연합 | 무신뢰 보안으로 설치 간 에이전트 협업 |
| MetaHarness | 내놓기 전에 AI 에이전트 구성을 점검해요. 준비도를 1~100점으로 매기고, 도구 설정의 보안 문제를 검사하고, 프로젝트 전체를 스냅샷으로 찍어 시간이 지나며 생기는 퇴행을 잡고, 내 저장소에 맞는 템플릿을 찾아요. ruflo eject는 ruflo 프로젝트를 자기 이름을 가진 독립 에이전트 도구 모음으로 바꿔요. 전체 안내서. |
경험에서 배우기
쓸모 있는 궤적과 작업 피드백은 이후 작업에 도움이 될 수 있어요. 결과는 설정한 메모리 · 학습 구성 요소와 피드백의 질에 따라 달라요. 학습 플러그인.
에이전트 연합 — 에이전트를 위한 Slack
Slack이 팀에 채널을 줬듯, 연합은 에이전트에게 같은 것을 줘요. 신뢰 경계를 넘는 공유 작업 공간이에요. 서로 다른 기계 · 조직 · 클라우드 지역의 에이전트가 서로를 찾고, 자신이 누구인지 증명하고, 작업을 함께해요.
다른 점은, 어떤 채널은 믿을 수 있고 어떤 채널은 아니라는 거예요. @claude-flow/plugin-agent-federation이 이를 자동으로 처리해요. 내 에이전트가 연합에 참여하면 mTLS + ed25519로 검증되고 작업을 주고받기 시작해요. 내 노드를 떠나기 전에 PII는 제거되고 모든 메시지는 감사할 수 있어요. 신뢰받지 못한 에이전트도 낮은 권한으로 참여할 수 있어요. 탐색 정보는 볼 수 있어도 내 메모리는 볼 수 없어요. 믿을 만하다고 증명되면 신뢰가 올라가고, 잘못 행동하면 즉시 내려가요. 사람이 끼어들 필요가 없어요.
핸드셰이크를 설정하거나 인증서를 관리할 필요가 없어요. federation init, federation join만 하면 에이전트가 대화를 시작해요. 신원은 프로토콜이, 데이터 안전은 PII 파이프라인이, 규정 준수는 감사 기록이 맡아요.
📘 전체 사용자 설명서:
docs/federation/— 설정, MCP 도구, 신뢰 수준, 서킷 브레이커, 패킷 계층 도달 가능성을 연합 신뢰에 묶는 (선택형) WireGuard 메시 계층. ADR-111 심층 해설은docs/federation/phase7-mesh-bringup.md에 있어요.
연합 기능
| 기능 | 동작 방식 | |
|---|---|---|
| 🔒 | 무신뢰 연합 | 원격 에이전트는 신뢰받지 못한 상태로 시작해요. 신원은 mTLS + ed25519 챌린지-응답으로 증명해요. API 키도 공유 비밀도 없어요. |
| 🛡️ | PII를 거르는 데이터 흐름 | 14가지 유형을 탐지하는 파이프라인이 나가는 메시지를 모두 검사해요. 신뢰 수준별 정책은 BLOCK, REDACT, HASH, PASS예요. 적응형 보정으로 오탐을 줄여요. |
| 📊 | 행동 기반 신뢰 점수 | 공식(0.4×성공 + 0.2×가동 시간 + 0.2×위협 + 0.2×무결성)으로 상대 노드를 계속 평가해요. 올라가려면 이력이 필요하고, 내려가는 건 즉시예요. |
| 📋 | 규정 준수 내장 | HIPAA, SOC2, GDPR 감사 기록이 규정 준수 모드로 들어 있어요. 모든 연합 이벤트가 HNSW로 검색할 수 있는 구조화 기록을 남겨요. |
| 🤝 | MCP 도구 9개 + CLI 명령 10개 | 전체 생애 주기: federation_init, federation_send, federation_trust, federation_audit 등. |
예시: 고객 데이터를 공유하지 않고 사기 신호를 나누는 두 팀
# Team A: initialize federation and generate keypair
npx claude-flow@latest federation init
# Team A: join Team B's federation endpoint
npx claude-flow@latest federation join wss://team-b.example.com:8443
# Team A: send a task — PII is stripped automatically before it leaves
npx claude-flow@latest federation send --to team-b --type task-request \
--message "Analyze transaction patterns for account anomalies"
# Team A: check peer trust levels and session health
npx claude-flow@latest federation status
전체 아키텍처, 신뢰 모델, 구현 로드맵은 이슈 #1669를 보세요.
# Claude Code plugin
/plugin install ruflo-federation@ruflo
# Or via CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation
Claude Code 단독 vs Ruflo와 함께
| 기능 | Claude Code 단독 | + Ruflo |
|---|---|---|
| 에이전트 협업 | 따로 놀고 공유 맥락 없음 | 공유 메모리와 합의가 있는 군집 |
| 조율 | 수동 오케스트레이션 | 여왕이 이끄는 계층(Raft, 비잔틴, 가십) |
| 메모리 | 세션 안에서만 | 1ms 미만 회수의 HNSW 벡터 메모리 |
| 학습 | 정적인 동작 | 패턴 매칭을 하는 SONA 자기 학습 |
| 작업 라우팅 | 내가 결정 | 지능형 라우팅(정확도 89%) |
| 배경 작업자 | 없음 | 자동으로 시작되는 작업자 12개 |
| LLM 제공자 | Anthropic만 | 장애 전환이 되는 5개 제공자 |
| 보안 | 표준 | AIDefence로 CVE를 보강 |
구조 개요
User --> Claude Code / CLI
|
v
Orchestration Layer
(MCP Server, Router, 27 Hooks)
|
v
Swarm Coordination
(Queen, Topology, Consensus)
|
v
100+ Specialized Agents
(coder, tester, reviewer, architect, security...)
|
v
Memory & Learning
(AgentDB, HNSW, SONA, ReasoningBank)
|
v
LLM Providers
(Claude, GPT, Gemini, Cohere, Ollama)
문서
독자 네 부류를 위한 문서가 있어요.
| 문서 | 언제 읽나요 |
|---|---|
| 현황 | 지금 무엇이 동작하는지 봐요 — 기능 수, 테스트 기준선, 최근 수정, 다음 계획. 준비됐나? 문서예요. |
| 사용자 설명서 | 일상 참고서 — 모든 명령, 모든 설정 플래그, 모든 플러그인. 어떻게 하지? 문서예요. |
| 프레임워크 비교 | Ruflo, Claude Code 기본 에이전트, CrewAI, LangGraph, AutoGen 중에서 고민할 때. 뭐가 나한테 맞지? 문서예요. |
| MetaHarness 안내서 | 에이전트 구성에 점수를 매기고, 도구 설정의 보안을 검사하고, 실행 사이의 변화를 찾고, 프로젝트를 독립 에이전트 도구 모음으로 분리하는 법. 내 구성 점검 문서예요. |
| 벤치마크 | darwin-arm64와 linux-x64에서 LangGraph / AutoGen / CrewAI와 견준 v3.8.0 SOTA 표. ruflo가 콜드 스타트 · 단일 턴 · RSS에서 1.3~1953배로 앞선다고 해요. 빠른가? 문서예요. |
| 검증 | 설치된 바이트가 서명된 증명과 같은지 암호학적으로 증명해요 — ruflo verify. 믿되 확인하라 문서예요. |
| 팀 게이트웨이 점검표 | 머지 전 관문, 이중 모드 인수인계, 메모리 네임스페이스 공유, 머지마다 남기는 증명 목록. 더 안전한 팀 워크플로 문서예요. |
벤치마크 내부(재현용): sota-workload-spec.md · SOTA-PROGRESS.md · 원본 표 JSON: darwin · linux
사용자 설명서 절 색인:
| 절 | 주제 |
|---|---|
| 빠른 시작 | 설치, 사전 준비, 설치 프로필 |
| 핵심 기능 | MCP 도구, 에이전트, 메모리, 신경 학습 |
| 지능 · 학습 | 훅, 작업자, SONA, 모델 라우팅 |
| 군집 · 조율 | 토폴로지, 합의, 하이브 마인드 |
| 보안 | AIDefence, CVE 조치, 검증 |
| 생태계 | RuVector, agentic-flow, Flow Nexus |
| 설정 | 환경 변수, 설정 스키마 |
| 플러그인 마켓플레이스 | 플러그인 찾아보기와 설치 |
지원
| 자료 | 링크 |
|---|---|
| 문서 | 사용자 설명서 |
| 이슈와 버그 | GitHub Issues |
| 기업 | ruv.io |
| 커뮤니티 | Agentics Foundation Discord |
| 제공 | Cognitum.one |
라이선스
MIT - RuvNet
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0
