Paperclip으로 3인 AI 팀 구축, 코드 작성·검토·배포까지 자동화 (4가지 함정 경험)

“Paperclip으로 3인 AI 팀을 구축한 사례는 GitHub 33K+ 스타, MIT 라이선스 오픈소스로 Node.js 18+와 pnpm 9.15+ 환경에서 내장 PostgreSQL을 포함해 약 3분 만에 설치된다. Coder·Reviewer·Tester 세 에이전트를 두고 Reviewer에는 file_read 권한만 부여했으며, on_reject와 on_fail로 최대 3회 반복하는 YAML 워크플로를 구성해 작성→검토→테스트를 자동화했다.”

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 코드 품질 보증의 표준 패턴으로 정착 가능
Share

이것도 읽어보세요

댓글

이 소식에 대한 의견을 자유롭게 남겨주세요.

댓글 (0)

불러오는 중...