!원문 캡처 · github.com

Pullboard는 에이전트가 승인된 명세에 따라 서로 분리된 작업 공간에서 코드를 만들고, 다른 에이전트가 같은 커밋을 검증하도록 조정하는 도구다. 계정이나 외부 호스팅 없이 Git 저장소 안에서 작동하며, 모델을 직접 호출하지 않는다.

작업은 SPEC.md의 요구사항, DOCTRINE.md의 저장소 규칙, 에이전트별 작업 경로인 레인(lane)을 중심으로 진행한다. 요구사항은 사람이 승인해야 작업 기준으로 인정된다. 각 항목은 테스트 등으로 정한 게이트를 통과해 제출된 뒤, 별도의 검증 에이전트가 해당 커밋을 확인해야 완료된다.

Pullboard는 작업 항목과 결정, 승인·반려 이력을 보드에 기록한다. 작업은 저장소의 .git 안에 있는 SQLite 파일에 보관되며, 명세와 규칙, 설정은 일반 파일로 저장한다. 제출한 작업은 Git 커밋에 고정되고, pullboard export로 보드 전체를 내보낼 수 있다. 제작자는 한 명의 조정 에이전트와 깊게 협업하고, 조정 에이전트가 다른 레인에 작업을 배분하는 방식을 권장한다.

설치와 사용

Git과 Node 22.13 이상이 필요하다. 전역 설치 후 임시 저장소에서 둘러보기를 실행할 수 있다.

```text

npm i -g pullboard

pullboard tour

```

프로젝트에서는 pullboard init으로 명세와 규칙, 에이전트 지침을 만들고 훅과 보드를 설치한다. 변경 사항을 커밋한 뒤 저장소에서 Claude Code를 열어 작업을 지시하면 해당 에이전트가 조정자 역할을 맡는다. Codex 등 다른 에이전트는 AGENTS.md 또는 pullboard prompt <role>을 이용할 수 있다.

pullboard.json에서 테스트 명령과 레인별 담당 경로·명세 구역을 설정한다. 게이트는 제출과 푸시 전에 실행되며, 레인에 속하지 않는 경로의 커밋은 거부된다. JavaScript·TypeScript의 npm test, Python의 pytest, Go의 go test ./... 등 각 기술 스택에 맞는 명령을 지정할 수 있다.

Pullboard View에서는 로컬 API를 통해 작업 진행 상황과 사용자에게 필요한 결정, 항목별 제출·검증 기록을 확인하고 작업을 추가하거나 레인에 메시지를 보낼 수 있다. view --export는 다시 재생할 수 있는 정적 스냅샷을 만든다.

한계와 예정 기능

작업 공간의 식별은 한 컴퓨터 안에서만 의미가 있으며 보안 경계가 아니다. 훅은 --no-verify로 건너뛸 수 있고, 제작자는 푸시 전 게이트와 검증자가 보완 장치라고 설명한다. CI는 Linux와 macOS에서 실행하며 Windows는 아직 테스트하지 않았다. 여러 기기에서 보드를 보는 릴레이 기능과 Pullboard View의 로드맵은 예정 기능이다.

Pullboard 저장소

수명 주기 문서 · CLI JSON API 문서 · 저장 형식 문서 · RFC 문서 · MIT 라이선스