🤖에이전트
PaperClip으로 AI 에이전트 4명이 24/7 자동으로 미니앱 만들기
로컬 노트북에서 AI 에이전트 4명이 자동으로 협업하며 미니앱을 개발하는 완전 자동화 시스템 구축 가이드
↗ 원본 링크#PaperClip#Claude#자동화#에이전트협업
개요
집에 있는 노트북 한 대에서 AI 에이전트 4명이 24시간 자동으로 미니앱을 개발합니다. API 비용도 없고, 특별한 개입도 필요 없습니다. PaperClip과 Claude를 활용한 완전 자동화 개발 시스템입니다.
핵심 구조
PaperClip이 Claude Code CLI를 로컬에서 직접 실행합니다. 에이전트는 이슈를 할당받으면 자동으로 깨어나 일하고, 완료하면 다시 잠듭니다. Claude 구독 사용량을 그대로 활용하며, Codex CLI와 Cursor도 지원합니다.
4명의 에이전트 역할
DIRECTOR (총괄, Haiku)
▸5분마다 자동 깨어남
▸SCOUT의 시장 조사와 CRITIC의 평가 확인
▸개발 후보 선정 및 CODER에게 이슈 할당
▸완료 확인 → 텔레그램 알림 → 다음 사이클
▸판단만 하고 코드는 작성하지 않음
SCOUT (시장조사, Haiku)
▸이슈 할당 시 깨어남
▸트렌드 분석, 경쟁앱 평가
▸후보 3~5개를 점수와 함께 JSON으로 보고
CRITIC (품질 검증, Haiku)
▸SCOUT 완료 시 깨어남
▸시장 조사 결과를 비판적으로 재평가
▸후보들에 대해 재점수 부여
▸품질 향상의 핵심 역할
CODER (개발자, Sonnet)
▸설계 → 코드 → 빌드 → e2e 테스트 → 스크린샷까지 전담
▸통일된 디자인 시스템 활용 (토큰 30% 이상 절감)
▸빌드 실패 시 스스로 3번까지 수정
자동화 워크플로우
DIRECTOR 깨어남 (5분마다)
↓
SCOUT 시장조사 완료 확인
↓
CRITIC 평가 결과 확인
↓
개발 후보 선정
↓
CODER에게 이슈 할당
↓
CODER 자동 깨어남 → 개발 → 빌드 → 테스트
↓
이슈 상태 done 전환
↓
DIRECTOR 감지 → 텔레그램 알림
↓
다음 사이클 시작3단계 자동 QA 시스템
1단계: Playwright e2e 테스트
▸실제 Chromium에서 모든 버튼/탭/입력 자동 클릭
▸스크린샷 자동 촬영
▸100% 통과 필수
2단계: Gstack Plugin /qa 스킬
▸Chromium 인터랙션 테스트
▸디자인 시스템 준수 여부 검증
▸버그 발견 시 자동 수정
3단계: 크론 기반 모니터링
▸5분마다 서버 상태 확인 및 재시작
▸중복 프로세스 제거
▸15분마다 추가 점검
핵심 기능
Heartbeat 시스템
▸에이전트는 평소 잠자다가 필요할 때만 깨어남
▸리소스 낭비 최소화
▸PaperClip이 크론, 자동 wake, 세션 유지, 토큰 초과 시 자동 compact 관리
이슈 기반 상태 관리
▸todo → in_progress → done (단순한 3단계)
▸복잡한 큐 없이 HTTP REST와 상태 전환만 사용
▸이슈 생성 = 에이전트와의 대화 채널
디자인 시스템
▸모든 앱이 통일된 UI로 출력
▸CODER가 규칙만 따르면 되므로 토큰 30% 이상 절감
▸24/7 가동을 위한 핵심 요소
24/7 운영 팁
1.DIRECTOR에게 오케스트레이터 역할 부여 - 이슈 할당, QA, 다음 사이클 지시까지 자동화
2.CRON으로 감시 스크립트 실행 - 멈춰있는 에이전트 자동 복구
3.상세 로그 활용 - PaperClip이 모든 에이전트 로그 보관, 병목 지점 파악 가능
결과
3일간 40개 미니앱 자동 생성
▸API 비용 없음 (Claude 구독 사용량 활용)
▸사람의 개입 최소화
▸로컬 노트북 하나로 운영
시작하기
글이 길다면? 이 아티클을 그대로 Claude에게 복사해서 주면 원하는 대로 세팅해줍니다. 이제는 에이전트에게 일일이 프롬프트 치는 시대가 아닙니다.