Dannian's Warehouse

왜 자동 wakeup이 필요한가에이전트가 작업을 완료했는데 다음 단계가 시작되지 않는다면 파이프라인은 조용히 멈춘다. 사람이 대시보드를 계속 보면서 "Researcher 끝났으니까 이제 Creator 깨워야지"를 직접 수행하면 자동화가 아니다. 그것은 사람이 폴링하는 것이다.Paperclip은 이 문제를 children API + tree-hold 조합으로 해결한다. CEO가 child 이슈를 올바르게 등록하고 자신을 blocked 상태로 두면, child가 완료될 때 Paperclip이 CEO를 자동으로 깨운다. 이 메커니즘이 제대로 작동하려면 정확한 API 호출 순서와 상태 관리가 필요하다.children API가 자동 wakeup의 열쇠다Paperclip에서 이슈를 만드는 방법은 두 가지다. 이 둘..

Researcher가 조사를 마치고 "저장 완료"를 보고했다. Creator가 해당 파일을 읽으려 했는데 파일이 없다. 에이전트 로그에는 Write 도구 호출이 성공으로 기록되어 있다. 이 시리즈 4편에서는 이 현상의 원인과 해법, 절대경로 규칙의 필요성을 실제 프로젝트 구조를 기반으로 설명한다.문제 인식: 에이전트는 왜 서로의 파일을 못 찾는가per-agent sandbox의 구조Paperclip의 각 에이전트는 독립된 실행 환경(sandbox)에서 작동한다. 에이전트가 실행될 때마다 격리된 git worktree 또는 operator branch가 할당되며, 상대경로(./workspace/)는 이 격리 디렉토리를 기준으로 resolve된다.에이전트 A (Researcher) CWD: /papercli..

팀 구조 설계: 왜 5명인가에이전트를 하나로 만들면 간단해 보이지만 실제로는 역효과이다. 단일 에이전트가 조사·생성·검증·실행을 모두 담당하면 시스템 프롬프트가 비대해지고, 한 역할의 실수가 전체 파이프라인에 영향을 준다.Personal AI Company는 단일 책임 원칙(Single Responsibility)을 에이전트 설계에 적용했다. CEO는 조율만 하고, 나머지 4개가 각 단계를 전담한다. 이렇게 하면 에이전트 교체나 재설계가 쉽고, 각 역할의 품질 기준을 독립적으로 높일 수 있다.파이프라인 흐름은 다음과 같다: 조사(Researcher) → 생성(Creator) → 검증(Reviewer) → 실행(Executor). CEO는 Board(사용자)의 고수준 지시를 이 4단계로 분해하여 child..

들어가며Personal AI Company 시리즈 1편에서 전체 아키텍처와 개념을 살펴봤다. 2편에서는 Paperclip을 실제로 설치하고 Claude Code Max와 연결하는 구체적인 절차를 다룬다. 이 글을 따라하면 로컬 또는 서버 환경에서 Paperclip API 서버가 실행되고, Claude Code가 에이전트로 동작하는 상태가 된다.사전 요구사항필수 항목 확인아래 항목이 모두 준비되어 있어야 한다.항목버전 / 조건Node.js20 이상pnpm9.15 이상Claude 구독Max 플랜 (Claude Code 사용 필수)운영 체제macOS, Linux, Windows (WSL2)Claude Max 구독이 필요한 이유Paperclip은 Claude Code를 에이전트 런타임으로 사용한다. Claude..

AI 에이전트를 여러 개 동시에 운영하다 보면 터미널 탭이 20개를 넘어가고, 어느 에이전트가 무엇을 하고 있는지 파악하기 어려워진다. 1인 AI 회사(Personal AI Company)는 이 문제를 "에이전트를 도구로 쓰지 말고 회사처럼 운영한다"는 관점으로 해결한다. Paperclip은 그 운영 인프라를 제공하는 오픈소스 오케스트레이션 플랫폼이다.1. 문제: AI 에이전트를 많이 쓸수록 복잡해진다1-1. 터미널 탭 20개의 혼돈Claude Code, Cursor, Copilot 등 AI 에이전트를 적극적으로 활용하기 시작하면 곧 관리 문제에 부딪힌다. 에이전트 하나에 터미널 세션 하나씩 붙여두면, 어느 시점부터는 어느 에이전트가 어느 작업을 담당하는지 직접 추적해야 한다. 재시작하면 컨텍스트가 모두..