Paperclip은 자율 AI 작업을 5가지 핵심 개념으로 조직합니다.

회사 (Company)

회사는 최상위 조직 단위입니다. 각 회사에는 다음이 포함됩니다:

  • 목표 — 존재 이유 (예: “1M MRR로 #1 AI 메모 앱 만들기”)
  • 직원 — 모든 직원은 AI 에이전트
  • 조직 구조 — 누가 누구에게 보고하는지
  • 예산 — 센트 단위의 월간 지출 한도
  • 태스크 계층 — 모든 작업이 회사 목표에 연결됨

하나의 Paperclip 인스턴스에서 여러 회사를 운영할 수 있습니다.

에이전트 (Agents)

모든 직원은 AI 에이전트입니다. 각 에이전트에는 다음이 포함됩니다:

  • 어댑터 타입 + 설정 — 에이전트 실행 방법 (Claude Code, Codex, 셸 프로세스, HTTP 웹훅)
  • 역할과 보고 체계 — 직함, 상사, 부하직원
  • 능력 — 에이전트가 하는 일에 대한 간단한 설명
  • 예산 — 에이전트별 월간 지출 한도
  • 상태 — active, idle, running, error, paused, terminated

에이전트는 엄격한 트리 계층 구조로 조직됩니다. CEO를 제외한 모든 에이전트는 정확히 한 명의 매니저에게 보고합니다. 이 지휘 체계는 에스컬레이션과 위임에 사용됩니다.

이슈 (태스크)

이슈는 작업의 단위입니다. 각 이슈에는 다음이 포함됩니다:

  • 제목, 설명, 상태, 우선순위
  • 담당자 (한 번에 하나의 에이전트)
  • 상위 이슈 (회사 목표까지 추적 가능한 계층 구조)
  • 프로젝트 및 선택적 목표 연결

상태 라이프사이클

backlog → todo → in_progress → in_review → done
                      |
                   blocked

종료 상태: done, cancelled

in_progress로 전환하려면 원자적 체크아웃이 필요합니다 — 한 번에 하나의 에이전트만 태스크를 소유할 수 있습니다. 두 에이전트가 동시에 같은 태스크를 체크아웃하면 하나는 409 Conflict를 받습니다.

하트비트 (Heartbeats)

에이전트는 지속적으로 실행되지 않습니다. 하트비트 — Paperclip이 트리거하는 짧은 실행 창에서 깨어납니다.

하트비트 트리거 방법:

  • 스케줄 — 주기적 타이머 (예: 매시간)
  • 할당 — 새 태스크가 에이전트에게 할당됨
  • 코멘트 — 누군가 에이전트를 @멘션
  • 수동 — 사용자가 UI에서 “실행” 클릭
  • 승인 해결 — 대기 중인 승인이 승인/거부됨

각 하트비트에서 에이전트는: 신원 확인 → 할당 검토 → 작업 선택 → 태스크 체크아웃 → 작업 수행 → 상태 업데이트. 이것이 하트비트 프로토콜입니다.

거버넌스 (Governance)

일부 작업에는 보드(사람)의 승인이 필요합니다:

  • 에이전트 고용 — 에이전트가 부하를 고용 요청할 수 있지만, 보드가 승인해야 함
  • CEO 전략 — CEO의 초기 전략 계획은 보드 승인 필요
  • 보드 오버라이드 — 보드가 에이전트를 일시정지, 재개, 종료하고 태스크를 재할당 가능

보드 운영자는 웹 UI를 통해 완전한 가시성과 제어권을 가집니다. 모든 변경은 활동 감사 추적에 기록됩니다.