Brigade: 하네스 전반에서 도구와 메모리를 동기화하고 작업 기록을 로컬 파일 하나로 통합

누구에게 적합한가

• 여러 코딩 에이전트를 동시에 쓰는 개발자에게 적합합니다. 여러 하네스(예: 시점에 따라 다른 코딩 에이전트 사용) 사이를 오갈 때 도구와 메모리가 동기화되고 모든 작업이 하나의 기록을 공유하기를 바라며, 도구마다 기록이 갈려 상태가 서로 통하지 않는 상황을 피하고 싶은 경우입니다. 공식은 이를 어디서든 코딩 에이전트를 실행하고 작업의 기록을 하나 유지하는 것으로 설명합니다.
• CLI 형태로 제공됩니다. 에이전트가 공유 기록에서 준비된 작업을 가져가며(클레임), 메모리와 스킬은 MCP를 통해 하네스에 제공됩니다. 명령줄에서 에이전트 작업 상태를 관리하고 MCP로 기존 에이전트 도구 체인에 기능을 연결하려는 사용자에게 맞습니다.
• 작업 기록은 로컬 파일로 저장되며 데몬이 필요 없습니다. 작업 데이터를 자기 머신에 두고 싶고 추가 백그라운드 서비스를 띄우고 싶지 않은 사용자에게 어울립니다. 다인 협업이나 원격 배포를 지원하는지는 공식에 설명이 없습니다.
• 전제 조건: npm 설치 경로는 Node.js 22 이상과 npm을 요구합니다. 환경이 요건을 충족하지 않을 때 공식은 다른 설치 방법을 제시하지 않으며, 운영체제 간 차이 유무도 설명하지 않습니다.
• 공식은 적합하지 않은 사례를 들지 않았고, 지원 하네스 목록도 제공하지 않습니다. 연결하기 전에 사용 중인 에이전트 클라이언트가 stdio 방식 MCP 서버를 추가할 수 있는지 확인하세요. 이 부분은 공식이 대신 확인해 주지 않습니다. CLI도 실행할 수 없고 MCP도 연결할 수 없는 도구 체인이라면, 현재로선 확인 가능한 연결 경로가 없습니다.

3분 만에 첫 시도 완료

• 전제: Node.js 22 이상과 npm을 준비합니다. 공식 설명에 따르면 사용 중에 수동적 버전 요청(passive version request)이 텔레메트리 부작용으로 한 번 전송될 수 있습니다. 이는 공식이 명시한 네트워크 부작용으로, 사용 전에 받아들여야 할 전제이므로 설치할 때 알아 두어야 합니다. 그 밖에 다른 네트워크 접근이 있는지는 현재 정보로는 설명되어 있지 않습니다.
• 권장 기본 경로는 하나뿐입니다. npm으로 고정 버전 패키지를 전역 설치한 뒤 공식 절차에 따라 초기화합니다.

npm install --global @escoffier-labs/[email protected]
brigade setup

• 첫 시도를 시작하기: 에이전트가 brigade work claim --next --actor codex를 실행해 공유 기록에서 준비된 작업 하나를 가져가게 합니다. 이것이 공식이 보여주는 핵심 워크플로입니다. 가져가기는 “준비된 작업을 가져가 버리는” 동작이므로 주의하세요. 가져간 뒤 그 작업이 기록에서 어떻게 상태가 바뀌는지, 취소할 수 있는지는 공식에 설명이 없으니, 기록에 영향을 주는 조작으로 다뤄야 합니다.
• 아직 에이전트에게 작업을 가져가게 하고 싶지 않다면, 로컬에서 stdio 방식으로 brigade memory serve-mcp --stdio를 실행해 MCP 서버로서 하네스에 연결하고, MCP를 통해 Brigade의 메모리와 스킬을 읽을 수 있는지 관찰할 수 있습니다. 이 단계에는 가져가기 동작이 없습니다.
• 성공 신호: 에이전트가 가져가기 명령으로 준비된 작업 하나를 받았거나, 하네스가 MCP를 통해 Brigade의 메모리와 스킬을 읽었습니다. brigade setup의 구체적 동작과 성공 출력은 공식에 기술되어 있지 않으니, 명령이 예상대로 되지 않으면 먼저 Node.js 버전이 요건을 충족하는지 확인하고 공식 저장소에서 절차를 대조하세요.

사용 사례

• 사례 1: 여러 에이전트가 하나의 작업 기록을 공유. 상황: 코딩 에이전트를 두 개 이상 쓰면서 “누가 무엇을 어디까지 했는지”가 한 곳에 통일되어 기록되기를 원하고, 도구를 바꿀 때마다 세션에 흩어져 컨텍스트를 잃는 것을 원하지 않음. 시작: 설치와 brigade setup을 마친 뒤 작업 시작 시 에이전트에게 brigade work claim --next --actor codex를 실행시킵니다. 워크플로: work claim — 에이전트가 공유 기록에서 준비된 작업 하나를 가져갑니다. 기대할 수 있는 것: 해당 작업이 클레임되고, 기록은 데몬 없이 로컬 파일에 저장됩니다. 가져간 뒤 기록이 어떻게 갱신되는지, 전체 작업을 어떻게 보는지는 공식에 설명이 없으며, 현재 확인 가능한 것은 가져가기 단계까지입니다.
• 사례 2: 메모리와 스킬을 하네스에 제공. 상황: 하네스가 작업을 처리할 때 Brigade가 관리하는 메모리와 스킬을 쓰기를 원하고, 도구마다 따로 관리해 서로 통하지 않는 것을 피하고자 함. 시작: stdio 방식으로 brigade memory serve-mcp --stdio를 실행해 MCP 서버로서 하네스에 연결합니다. 워크플로: memory serve-mcp — Brigade는 이 서버를 통해 하네스에 메모리와 스킬을 노출합니다. 기대할 수 있는 것: 하네스가 MCP를 통해 메모리와 스킬을 읽을 수 있습니다. 사용 중인 클라이언트에 stdio MCP 서버를 등록하는 방법, 연결 후 호출 가능한 인터페이스가 무엇인지는 공식에 설명이 없으므로, 사용 중인 하네스의 일반적인 방식으로 연결한 뒤 검증해야 합니다.

사용 한계

• 네트워크 접근: 공식 설명에 따르면 텔레메트리로 수동적 버전 요청이 한 번 전송될 수 있으며, 이 점은 공식이 스스로 공개한 것입니다. 그 외 네트워크 접근 유무는 설명이 없으므로, 완전 오프라인 로컬 도구로 취급해서는 안 됩니다.
• 파일과 부작용: 작업 기록은 로컬 파일에 저장되며 데몬이 없습니다. 가져가기는 공유 기록에서 준비된 작업을 가져가는 동작이며 취소 가능 여부는 미설명입니다. 설치와 brigade setup이 시스템에 어떤 변경을 하는지 공식은 항목별로 나열하지 않았습니다.
• 실행 환경과 클라이언트: npm 경로는 Node.js 22 이상과 npm을 요구합니다. 지원 하네스 목록은 미확인이며, 사용 중인 하네스에서 동작하는지는 직접 검증해야 합니다.
• 버전 및 기타: 설치 명령은 0.30.0으로 고정되어 있고 다른 버전과 업그레이드 방법은 미확인입니다. 가져가기 외에 작업을 추가하는 방법, 전체 작업 조회, 메모리와 스킬 쓰기는 현 공식 정보에서 다루지 않습니다. 일상 워크플로에 넣기 전에 소규모로 시험해 동작이 기대에 부합하는지 확인한 뒤 사용 범위를 넓히세요.