🤖에이전트

PaperClip으로 AI 에이전트 4명이 24/7 미니앱 자동 생성 시스템 구축하기

로컬 노트북에서 AI 에이전트 4명이 협업하며 자동으로 미니앱을 개발하는 시스템 구축 사례

원본 링크
#PaperClip#Claude#자동화#멀티에이전트

개요

집에 있는 노트북 하나로 AI 에이전트 4명이 24시간 자동으로 미니앱을 만들어냅니다. 3일간 40개의 앱을 제작했으며, API 비용도 들지 않습니다.

핵심 구조

PaperClip + Claude Code CLI를 활용한 자동화 시스템입니다.

PaperClip이 Claude CLI를 로컬에서 subprocess로 실행
Claude 구독 사용량을 그대로 활용 (추가 API 비용 없음)
에이전트는 필요할 때만 깨어나 작업 후 다시 대기

4명의 에이전트 역할

1. DIRECTOR (총괄)

모델: Haiku
5분마다 자동으로 깨어남
SCOUT의 시장조사와 CRITIC의 평가를 확인
개발 후보 선정 및 CODER에게 이슈 할당
코드는 작성하지 않고 판단만 수행

2. SCOUT (시장조사)

모델: Haiku
이슈 할당 시 깨어남
트렌드 분석 및 경쟁앱 평가
3~5개 후보를 점수와 함께 JSON으로 보고

3. CRITIC (품질 검증)

모델: Haiku
SCOUT 완료 시 깨어남
비판적 시각으로 재평가 및 점수 재산정
품질 향상의 핵심 역할

4. CODER (개발자)

모델: Sonnet
설계 → 코드 → 빌드 → e2e 테스트 → 스크린샷까지 전담
통일된 디자인 시스템 활용으로 토큰 30% 절감
빌드 실패 시 최대 3번 자동 수정

자동 워크플로우

DIRECTOR 깨어남 (5분마다)
  ↓
SCOUT에게 시장조사 지시
  ↓
CRITIC이 결과 재평가
  ↓
DIRECTOR가 최종 앱 선택
  ↓
CODER에게 이슈 할당
  ↓
CODER 자동 개발
  ↓
QA 자동 실행
  ↓
텔레그램 알림 → 다음 사이클

3단계 자동 QA

1단계: Playwright e2e 테스트

실제 Chromium에서 모든 버튼/탭/입력 자동 클릭
스크린샷 자동 촬영
100% 통과 필수

2단계: Gstack Plugin /qa 스킬

Chromium 인터랙션 테스트
디자인 시스템 준수 여부 검증
버그 발견 시 자동 수정

3단계: 크론 스크립트 모니터링

5분마다 서버 상태 확인 및 자동 재시작
15분마다 추가 점검 (내용 미완)

핵심 장점

리소스 효율성: 에이전트가 필요할 때만 작동하여 리소스 낭비 방지

비용 절감: Claude 구독만으로 운영, 추가 API 비용 없음

토큰 최적화: 디자인 시스템으로 30% 이상 토큰 절감

완전 자동화: 사람의 개입 없이 24/7 가동

실전 팁

이 글을 Claude에게 복사해서 주면 원하는 대로 세팅해줍니다. DIRECTOR에게 오케스트레이터 역할을 부여하는 것이 24/7 가동의 핵심입니다.

이슈 생성이 곧 에이전트와의 대화 채널이며, 이슈 상태는 todo → in_progress → done만 사용합니다.