:wq

Fusion Agent Orchestrator

6 min read

Fusion은 오픈소스 멀티노드 AI 에이전트 오케스트레이터로, 자연어 설명을 기반으로 계획, 리뷰, 실행 루프를 통해 프로덕션 코드를 자동으로 생성한다.

개요

Fusion은 GitHub에서 개발된 오픈소스(MIT 라이선스) 도구로, “거친 아이디어에서 프로덕션 코드로”라는 비전 아래 설계되었다. 개발자는 작업을 일반 언어로 설명하면, Fusion의 AI 에이전트가 프로젝트 컨텍스트를 이해하고, 세부 계획을 수립하며, 격리된 Git 워크트리에서 단계별로 실행하고 리뷰한다. 모든 작업 상태는 실시간 칸반 대시보드에서 시각화된다.

작동 방식

사용자가 작업을 설명하면 다음과 같은 흐름으로 진행된다:

  1. 설명 — 사용자가 “다크 모드 토글을 설정 패널에 추가”처럼 작업을 일반 언어로 입력한다.
  2. 계획 — 계획 에이전트가 프로젝트를 읽고 컨텍스트를 이해하여 PROMPT.md 파일을 생성한다. 이 파일에는 단계, 파일 범위, 승인 기준이 포함된다.
  3. 칸반 보드 — 작업이 Planning → Todo → In Progress → In Review → Done 칸반을 따라 이동한다.
  4. 격리된 워크트리 — 각 작업은 fusion/{task-id} 브랜치의 독립적인 Git 워크트리에서 실행되어 파일 충돌이 발생하지 않는다.

각 단계는 Plan → Review → Execute → Review 사이클을 거친다. 리뷰에서 수정이 필요하면 다시 실행 단계로 돌아가고, 다음 단계로 넘어가거나 전체 재계획을 할 수도 있다.

주요 개념

  • AI 계획 — 계획 에이전트가 자동으로 상세 계획을 생성한다.
  • 워크플로우 게이트 — Pre-merge 게이트는 잘못된 코드의 병합을 차단하고, Post-merge 게이트는 정보 제공용 검사를 실행한다.
  • 워크트리 격리 — 각 작업이 별도 브랜치와 워크트리에서 실행되어 병렬 작업이 가능하고 충돌이 없다. 선택적 worktrunk 위임 지원.
  • 스마트 병합 — 모든 게이트를 통과하면 squash-merge를 자동으로 수행하며, 수동 승인 지점을 설정할 수 있다.
  • 멀티노드 메시 — 노트북, Mac mini, Linux 서버, 클라우드 VM, 전화기 등 모든 노드가 피어로 연결되어 작업 상태, 에이전트, 로그, diff가 동기화된다.
  • 모델 유연성 — Anthropic, OpenAI, Ollama 등 로컬 및 클라우드 모델을 혼용할 수 있다.
  • 에이전트 컴퍼니 — 440개 이상의 에이전트로 구성된 16개 사전 구축 팀을 가져와 자율적으로 실행할 수 있다.
  • 에이전트 간 메시징 — 내장 메일박스로 에이전트 간 위임, 설명, 조정이 가능하다.
  • 멀티에이전트 채팅방 (실험적) — 프로젝트 범위의 그룹 채팅으로, 멘션된 멤버가 직접 응답하고 추가 앰비언트 멤버가 한도까지 응답할 수 있다.
  • 미션 — 계층적 계획 구조 (Mission → Milestone → Slice → Feature → Task)를 지원하며, 자동조종장치와 검증 계약을 포함한다.
  • 리서치 — 웹 검색, GitHub, 로컬 문서, LLM 합성을 활용한 연구 실행을 지원한다.
  • 자기 개선 — 에이전트가 자신의 출력을 반영하고 프롬프트를 업데이트하여 코드베이스를 학습한다.

모델 시스템

Fusion은 다섯 가지 독립적인 모델 레인을 사용하며, 전역 설정과 프로젝트별 재정의를 지원한다:

  • Executor — 작업 실행 에이전트
  • Planning — 작업 계획 에이전트
  • Validator — 계획/코드 리뷰어
  • Title Summarization — 자동 제목 생성
  • Workflow Step Refinement — AI 프롬프트 개선

우선순위: 작업별 재정의 → 프로젝트 재정의 → 전역 레인 → 기본 설정 → 자동 해결.

지원 플랫폼

  • 데스크톱 앱 — Electron 기반 (macOS, Windows, Linux)
  • 모바일 앱 — Capacitor 기반 (iOS, Android)
  • 웹 대시보드 — 모든 최신 브라우저에서 접근 가능
  • CLI — fn 바이너리 및 확장 명령어

설치 방법

  • 즉시 실행 (npm): npx runfusion.ai
  • 원라인 설치 (macOS/Linux): curl -fsSL https://runfusion.ai/install.sh | sh
  • Homebrew (macOS/Linux): brew install runfusion/fusion/fusion
  • npm 전역: npm install -g @runfusion/fusion

관련 개념

소스

Graph View

최근 게시글

백링크