duobrain시작하기

같이 하는 일인데,
AI는 왜 각자 따로 쓰고 있을까요?

Duobrain은 두 사람의 AI가 같은 작업 기록을 읽고 쓰게 하는 오픈소스 협업 도구입니다.

시작하기 데모 해보기
  • 2인 전용
  • MIT 오픈소스
  • Git 기반
  • v0.1.6
제품 정보
Duobrain 제품 정보
사용 인원정확히 2명
라이선스MIT 오픈소스
현재 버전v0.1.6 (로컬에서 실행)
필요한 것Node.js 22 이상, Git, 같은 프로젝트 저장소의 각자 클론
설치한 사람이 npx 한 줄로 프로젝트에 설치하고 커밋, 다른 사람은 pull만 (설치되는 의존성 없음)
업데이트한 사람이 update 후 커밋하면 두 사람이 같은 버전을 씀
기록 위치프로젝트 Git 저장소 (sync로 상대의 기록을 가져옴)
AI 도구지금 쓰는 AI 그대로 사용. 프로젝트의 AGENTS.md로 연결 (Codex와 Cursor는 AGENTS.md, Claude Code는 CLAUDE.md로 읽음)
공유 범위작업 내용과 결정 이유는 100% 공유, 개인정보는 제외
제공 기능로컬 대시보드(한국어와 영어), 커밋별 작업 방식과 결정 이유 기록, 작업 기록 위키, 정보와 피드백 요청
검증 현황로컬 테스트 128개 통과, 두 사람의 실사용 검증은 진행 중
A

A의 대화

두 사람의 작업 기록으로 답함

B의 작업을 A의 AI에게 물어보세요.

작업 기록에 답이 있으면 바로 답하고, 빠져 있으면 B의 AI에게 물어봐요.

매번 묻고 설명하던 일을, 두 사람의 AI가 대신 주고받습니다.

작업 기록에 답이 있으면 A의 AI가 바로 답하고, 기록에 빠진 내용만 B의 AI에게 물어 채워 넣습니다. 질문을 골라 두 경우를 모두 확인해 보세요.

Duobrain 활용 사례 5가지

바뀐 계획에서 내 다음 작업 시나리오의 duobrain 채팅 화면

바뀐 계획, 다음 작업

바뀐 기획과 내 담당 범위를 연결해 먼저 할 일을 알려줍니다.

1 / 5: 바뀐 계획, 다음 작업

장면 설명 보기

  1. 바뀐 계획에서 내 다음 작업

    질문
    기획서가 바뀌었어. 나는 뭐부터 해야 해?
    AI가 한 일
    이번 단계 목표가 서버 연동에서 브라우저 정적 체험 검증으로 바뀐 것을 확인하고, 내 담당과 먼저 할 일을 알려줍니다. 아직 합의되지 않은 서버 작업은 시작하지 않습니다.
    근거 기록
    docs/product-brief-v2.md, decisions/DEC-021.md

  2. 겹치는 작업을 안전하게 시작

    질문
    B가 작업 중인데 나도 시작해도 돼?
    AI가 한 일
    B가 11:42에 시작한 결제 스키마 변경이 같은 파일(src/api/schema.ts)을 다룬다는 것을 찾고, 최신 기준을 가져온 뒤 별도 worktree에서 읽기 작업부터 시작하도록 제안합니다.
    근거 기록
    worklogs/B-20260920-1142.md, plans/sprint-04.md

  3. 부족한 작업 정보 요청

    질문
    어떤 작업 정보가 더 필요해?
    AI가 한 일
    작업 기록에 새 endpoint 이름만 있고 요청 본문의 contract_version과 실제 push 성공 여부가 빠진 것을 찾아, 그 두 가지를 B의 AI에게 보충 요청합니다.
    근거 기록
    shared/api-index.md, tickets/TKT-204.md

  4. 중단된 작업을 이어서 인계

    질문
    잠깐 멈췄다가 이어서 인계해줘.
    AI가 한 일
    10:10 시작부터 14:05 종료까지의 작업 구간, 통과한 refresh token 테스트 6건, 아직 확인하지 못한 모바일 Safari 동작을 정리해 인계 기록을 만듭니다. push가 확인되지 않은 커밋은 완료로 표시하지 않습니다.
    근거 기록
    worklogs/B-session-118.md, tests/auth-refresh.md

  5. 오래된 기록과 현재 기준

    질문
    오래된 기록은 이제 어떻게 보여?
    AI가 한 일
    9월 12일 초안의 보존 기간 30일이 9월 18일 확정 결정 90일로 바뀐 것을 구분해 보여주고, 아직 열린 질문(TKT-218)은 합의된 것처럼 요약하지 않습니다.
    근거 기록
    notes/retention-draft.md, decisions/DEC-032.md, tickets/TKT-218.md

두 사람이 함께 보는 대시보드

duobrain 대시보드 현재 화면: 합의한 목표, 하은과 민준의 작업, 답을 기다리는 요청
지금 하고 있는 일한 화면에서 상대가 지금 무슨 일을 하고 어디서 막혔는지 확인합니다.

화면은 예시 데이터입니다.

왜 2인 전용인가요

세 명, 네 명으로 늘어나면 누가 어떤 정보에 접근하고 무엇을 할 수 있는지 나눠야 합니다.
협업을 고도화할수록, 권한을 설계하고 관리하는 일이 가장 큰 걸림돌입니다.

그래서 Duobrain은 두 사람의 작업에 집중합니다.
두 사람의 AI가 서로의 작업을 이해하고, 묻고 답하며, 다음 일까지 이어가도록 계속 개선합니다.

인원이 늘면, 권한에서 막혀버립니다.

정보 접근
사람마다 볼 수 있는 정보를 나눠야 합니다.
작업 권한
역할마다 AI에 맡길 수 있는 범위를 정해야 합니다.
개선할 점
AI를 고도화하면서, 복잡해지는 권한 구조도 관리해야 합니다.

우리는 두 사람 안에서 계속 고도화합니다.

지식 공유
해당 작업의 모든 내용과 결정 이유를 두 사람이 100% 공유하도록.
정보 요청
사람이 매번 설명하고 전달하던 일을 AI끼리 처리하도록.
목표
정보를 공유하는 데서 끝나지 않고, 다음 작업까지 이어가도록.
표로 비교해 보기
상대에게 직접 묻기, 공유 문서나 위키, Duobrain 비교
항목상대에게 직접 묻기공유 문서나 위키Duobrain
정보를 찾는 방법메신저로 묻고 답을 기다림사람이 문서를 찾아 읽음내 AI가 작업 기록에서 찾음
결정 이유대화 속에 흩어짐누군가 따로 정리해야 남음작업하면서 AI가 기록
기록에 없을 때상대가 답할 때까지 대기문서 보완을 따로 부탁내 AI가 요청을 남기고, 상대의 AI가 다음 작업 때 보충
권한 설정필요 없음문서와 폴더마다 공유 설정필요 없음 (작업 내용 100% 공유)
상대가 자리에 없을 때답을 받을 수 없음문서가 최신이면 확인 가능기록된 내용은 바로 답함

AI 사용법 고도화 4단계

프로젝트에 연결하는 순간, 가장 고도화된 AI 활용이 시작됩니다.

  1. 채팅

    궁금한 것을 물어봅니다.

  2. 비서

    내 일을 맡기면서 함께 작업합니다.

  3. 자동화

    내가 잠든 사이에도 일을 합니다.

  4. 지식베이스

    정보 장벽을 허무는 정보 관리자가 됩니다.

두 사람의 AI가 각자의 업무 자료를 하나의 지식베이스로 연결하는 모습

무슨 일을 했는지부터,
왜 그렇게 결정했는지까지.

서로 설명해야 했던 일도 이제 AI에게 물어 상대의 작업 정보를 확인하고,
바로 이야기하며 처리할 수 있습니다.

Q&A

자주 묻는 질문

세 명 이상도 사용할 수 있나요?

세 명 이상을 지원할 계획은 없습니다. 프로젝트를 직접 수정해 더 많은 사람이 사용할 수 있도록 확장하는 것은 막지 않습니다. 다만 Duobrain이 공식적으로 제공하고 개선할 버전은 앞으로도 2인 협업에 최적화된 버전입니다.

작업 내용은 어디까지 공유하나요?

작업 과정과 결정 이유를 포함해, 해당 작업의 내용은 두 사람이 100% 공유합니다. 작업 안에서 사람별로 정보 접근 권한을 나누지 않습니다. 작업 폴더와 해당 작업 범위 밖의 정보는 샌드박스로 분리하는 것을 원칙으로 합니다.

지금 쓰는 AI를 바꿔야 하나요?

바꾸지 않아도 됩니다. 프로젝트를 연결하면 Duobrain이 프로젝트의 AGENTS.md에 협업 안내를 넣어 두고, AGENTS.md를 읽는 Codex와 Cursor, CLAUDE.md로 읽는 Claude Code가 같은 안내를 따릅니다. 로컬 파일과 명령을 다룰 수 있는 AI 도구가 필요합니다.

상대가 자리를 비워도 답을 받을 수 있나요?

이미 공유하고 동기화한 기록이 있다면 그 내용을 바탕으로 답할 수 있습니다. 새 정보가 필요하면 요청을 남기고, 상대가 다음에 AI로 작업하며 내용을 보충한 뒤 동기화해서 이어갑니다. 설치만으로 상대의 AI가 백그라운드에서 실행되지는 않습니다.

시작하려면 무엇이 필요한가요?

Node.js 22 이상과 Git, 같은 프로젝트 저장소의 각자 클론이 필요합니다. 두 사람 모두 공유 기록을 올릴 수 있는 저장소 권한을 갖고, 한 사람이 Duobrain을 프로젝트에 설치해 커밋하면, 다른 사람은 pull한 뒤 자기 ID로 합류만 하면 됩니다. 현재는 로컬에서 실행합니다.

도입 가이드 보기
새 버전은 어떻게 받나요?

한 사람이 update를 실행하면 최신 릴리스로 바뀌고 AGENTS.md 안내도 함께 갱신됩니다. 그 변경을 커밋하면 다른 사람은 pull만 하면 되므로, 두 사람이 항상 같은 버전을 씁니다. 새 버전 소식과 변경 내용은 GitHub 릴리스에서 확인할 수 있습니다.

v0.1.6 릴리스 노트
왜 Duobrain을 프로젝트 안에 넣나요?

두 사람 중 한 명만 설치하면 되게 하기 위해서입니다. Duobrain은 실행 파일만(약 400KB, 의존성 없음) 프로젝트의 .duobrain 폴더에 복사해 함께 커밋합니다. 이렇게 도구를 저장소에 함께 담는 방식을 vendoring이라고 합니다. 다른 사람은 따로 받을 것이 없고, 버전도 커밋에 고정되어 두 사람이 같은 버전을 씁니다. GitHub에서는 vendored 파일로 표시되어 언어 통계와 PR 변경 내역에서 접힙니다.

vendoring 설명 보기

설치는 한 사람이
한 번이면 됩니다.

한 사람이 프로젝트에 Duobrain을 넣어 두면,
다른 사람은 pull만 하고 바로 합류합니다.

Duobrain GitHub도입 가이드

Node.js 22 이상, Git, 두 사람이 함께 쓰는 프로젝트 저장소

최신 버전 v0.1.6 릴리스 노트

  1. 한 사람이 프로젝트에 설치하세요.

    프로젝트 폴더에서 npx duobrain@0.1.6 install을 실행하면 .duobrain 폴더와 AI 안내(AGENTS.md)가 생깁니다. 설치되는 의존성은 없습니다.

  2. 연결하고 커밋하세요.

    init으로 두 사람의 참여자 ID를 등록한 뒤, 생긴 파일을 한 번 커밋하고 푸시합니다.

  3. 다른 사람은 pull만 하세요.

    따로 받을 것 없이 init에 자기 ID만 넣으면 합류합니다. 두 사람의 AI가 같은 안내를 바로 따릅니다.