AI 요약
Paperclip으로 코드 작성·리뷰·테스트를 담당하는 3인 AI 팀을 구성한 실전기다. Paperclip은 다중 AI 에이전트를 "회사"처럼 조직화하는 오픈소스로, 3주 만에 GitHub 33K 스타를 기록했으며 MIT 라이선스다. 저자는 Coder·Reviewer·Tester 세 역할을 YAML로 정의하고, 리뷰 반려와 테스트 실패 시 1단계로 되돌리는 피드백 루프를 갖춘 워크플로를 구성했다. Reviewer에게 file_read 권한만 부여해 수정 권한을 차단한 점이 설계상 핵심이다. 설치부터 실행까지 4가지 함정을 기록했다.
핵심 포인트
- Paperclip: GitHub 33K+ stars, MIT 라이선스, Node.js 18+ 및 pnpm 9.15+ 필요
npx paperclipai onboard --yes로 내장 PostgreSQL 포함 3분 내 초기 설정 완료- 3개 에이전트 모두 claude-sonnet-4-20250514 모델 사용, Reviewer는 file_read만 허용
- 워크플로에 on_reject/on_fail 시 1단계 회귀, max_iterations 3으로 무한 루프 방지
향후 전망
- 단일 에이전트에서 역할 분리형 멀티 에이전트 오케스트레이션으로 개발 워크플로 전환 가속
- 권한 격리 기반 리뷰 구조가 AI 코드 품질 보증의 표준 패턴으로 정착 가능
출처:hatena
