Fusion은 오픈소스 멀티노드 에이전트 오케스트레이터로, 자연어 설명을 기반으로 AI 계획, 격리된 Git 워크트리, 통합 대시보드를 통해 생산 코드를 자동 생성한다.

개요

Fusion은 개발자가 자연어로 작업을 설명하면 AI가 전체 계획을 수립하고, 각 단계를 실행하며, 리뷰하고 병합하는 엔드투엔드 워크플로우를 제공한다. 단일 데스크탑 앱, 모바일 앱, 웹 대시보드, CLI 등 여러 플랫폼을 지원하며, 여러 노드가 하나의 보드를 공유하는 메시 네트워크를 구성할 수 있다. MIT 라이선스로 공개되어 있으며, Anthropic, OpenAI, Ollama 등 다양한 AI 모델을 지원한다.

배경

기존 개발 워크플로우는 여러 도구(이슈 트래커, CI/CD, 코드 리뷰, 배포)를 오가며 수동으로 작업해야 했다. Fusion은 Trello와 유사한 칸반 보드에 AI 에이전트가 작업을 계획하고 실행하며 리뷰하는 과정을 통합하여, 사람은 개입이 필요한 결정에만 집중할 수 있게 한다. 이는 dustinbyrne/kb 프로젝트를 기반으로 확장되었다.

작동 방식

작업 흐름

① 설명          ② 계획               ③ 보드               ④ 격리 워크트리
─────────────    ─────────────         ─────────────          ─────────────────────
"다크 모드    →  AI 에이전트가      →  계획 → 리뷰 →    →  fusion/FN-123 브랜치
 토글을       →  PROMPT.md 생성        실행 → 리뷰           동시 작업, 파일 충돌 없음
 설정 패널에    (단계, 범위,           (각 단계를 완료할
 추가"          승인 기준)            때까지 반복)
  1. 설명: 사용자가 자연어로 작업을 설명한다.
  2. 계획: Planning 에이전트가 프로젝트 컨텍스트를 읽고 상세한 PROMPT.md 계획(단계, 파일 범위, 승인 기준)을 작성한다.
  3. 실행: 각 단계별로 Plan → Review → Execute → Review 사이클을 반복한다. 리뷰에서 수정이 필요하면 다시 실행 단계로 돌아간다.
  4. 병합: 모든 게이트를 통과하면 Fusion이 squash-merge하여 완료 상태로 이동한다. 필요시 수동 승인 게이트를 추가할 수 있다.

워크트리 격리

각 태스크는 고유한 Git 브랜치와 워크트리(fusion/{task-id})에서 실행된다. 이로 인해 병렬 태스크 간 파일 충돌이 발생하지 않는다. 선택적으로 worktrunk를 통해 워크트리 생성을 위임할 수도 있다.

멀티노드 메시

여러 장치(노트북, Mac mini, Linux 서버, 클라우드 VM, 휴대폰)가 동등한 피어로 연결되어 하나의 보드를 공유한다. 태스크 상태, 에이전트 로그, diff가 메시 전체에 동기화된다.

주요 특징

  • AI Planning — 자연어 설명을 받아 상세 계획을 자동 생성
  • Workflow Gates — Plan → Review → Execute → Review 단계별 품질 게이트, 선병합(pre-merge) 게이트는 병합을 차단, 후병합(post-merge) 게이트는 정보 제공
  • Git Worktree Isolation — 태스크별 격리된 워크트리, 병렬 작업 지원
  • Multi-node Mesh — 여러 장치 간 실시간 동기화, 데스크탑/모바일/웹/CLI 지원
  • 다중 모델 지원 — Anthropic, OpenAI, Ollama 등 로컬 및 클라우드 모델 혼용 가능
  • Agent Companies — 16개 회사, 440개 이상의 에이전트로 구성된 사전 구축 팀 임포트 가능
  • Inter-agent Messaging — 에이전트 간 내장 메일박스, 위임 및 협업 지원
  • Chat Rooms (실험적) — 프로젝트 범위 그룹 채팅, 멘션된 멤버가 직접 응답, 추가 멤버는 상한까지 응답 가능
  • Missions — 계층적 계획 (Mission → Milestone → Slice → Feature → Task), 자동 조종 및 검증 계약 지원
  • Research — 웹 검색, GitHub, 로컬 문서, LLM 종합을 통한 제한된 리서치 실행, 결과를 태스크로 전환
  • Self-improvement — 에이전트가 자신의 출력을 반영하여 프롬프트를 코드베이스에 맞게 업데이트
  • Scheduled Tasks / Automations — cron 기반 자동화, 웹훅, 수동 실행 지원, 글로벌/프로젝트 범위 설정 가능

예시 / 사용 사례

  • “로그인 버그 수정”과 같은 자연어 명령으로 태스크 생성 및 자동 실행
  • GitHub 이슈 임포트하여 Fusion 태스크로 변환 (fn task import owner/repo --labels bug)
  • 다중 프로젝트 관리: 하나의 설치로 여러 프로젝트를 격리하여 관리
  • 에이전트 회사 임포트: npx companies.sh add paperclipai/companies/gstack 명령으로 440+ 에이전트 팀을 가져와 수주간 자율 운영

제한 사항 / 고려 사항

  • Chat Rooms, Hermes, Paperclip, OpenClaw 등 일부 기능은 실험적이며 API가 변경될 수 있음
  • 각 태스크가 별도 워크트리를 사용하므로 디스크 공간 사용량이 증가할 수 있음
  • AI 에이전트의 출력 품질은 사용된 모델과 프롬프트에 크게 의존
  • 멀티노드 메시는 모든 노드가 동일한 Fusion 버전을 실행해야 함

관련 개념

출처