Brnch

Brnch란 무엇인가

Brnch는 코딩 에이전트가 실제 저장소에 커밋하도록 허용한 팀을 위해 Vigilbase가 만든 Git 호스트다. HTTPS와 SSH 저장소, 풀 리퀘스트에 해당하는 체인지, 이슈, Actions라는 CI를 갖췄다. 여기에 각 체인지가 보호 브랜치에 어떻게 도달했는지 남기는 기록이 더해진다.

그 기록이 이 제품의 존재 이유다. 머지가 일어날 때마다 서명 영수증이 생기고, 작성자(사람 또는 사람 스폰서를 둔 에이전트 세션), 정확한 리비전에 묶인 승인, 실행된 검사와 각 검사의 출처, 머지 시점의 정책 버전이 함께 적힌다. CLI와 공개 키만 있으면 계정 없이 오프라인에서 검증할 수 있다.

Vigilbase는 이를 에이전트용 코드 호스팅이라고 부른다. 에이전트가 누군가의 노트북에 붙은 스크립트가 아니라 저장소의 정식 사용자라는 뜻이다. 거대한 앱 마켓을 갖춘 성숙한 AI 코드 호스팅을 찾는다면 아직 그 단계는 아니다.

AI 없이도 돌아간다는 점도 중요하다. 저장소, 리뷰, 머지, 이슈, CI는 모델 제공자와 키 없이 작동한다. 체인지 설명 초안 같은 AI 기능은 선택 사항이고, 조직 관리자가 켤지 정한다.

시작하기

1. brnch.io에서 이메일로 계정을 만든다. 에이전트에게 맡길 수도 있다. CLI가 링크와 여덟 글자 코드를 보여 주면 브라우저에서 승인하면 된다.
2. npm install -g brnch-cli로 CLI를 설치한다. Node.js 20 이상과 git 2.31 이상이 필요하다. npm을 쓰고 싶지 않으면 단독 스크립트도 있다.
3. 프로젝트에서 brnch setup --yes를 실행한다. 개인 네임스페이스에 비공개 저장소를 만들고, 있던 내용을 커밋하고, 첫 커밋을 보호된 main 브랜치로 푸시한다.
4. 코드가 다른 곳에 있다면 GitHub 저장소를 가져온다. 커밋 기록은 따라오지만 러너와 시크릿은 Brnch 쪽에서 다시 설정해야 한다.
5. 체인지를 열고 리비전을 검토한 뒤 정책을 통과하면 머지한다. 머지 시점에 영수증이 생기므로 보관하거나 나중에 검증하면 된다.