Claude Code에 조직도를 부여하세요: 30분 만에 구축하는 자가 관리 AI 팀 (파일 3개, 프레임워크 미사용)
요약
Claude Code를 활용하여 프레임워크 없이 3개의 마크다운 파일만으로 자가 관리형 AI 에이전트 팀을 구축하는 방법을 소개합니다. 에이전트 간의 충돌과 허위 보고 문제를 해결하기 위해 위임 계약서와 감시자(Watchdog) 계층을 도입하는 관리 모델을 제안합니다.
핵심 포인트
- 프레임워크 없이 마크다운 파일만으로 에이전트 관리 계층 구축 가능
- 자율 주행 헌장(Autopilot Charter)을 통한 명확한 에이전트 역할 및 경계 설정
- ops-monitor를 통해 실제 결과물 기반의 작업 성공 여부 검증
- qa-reviewer를 최종 관문으로 설정하여 데이터 진위 및 보안 검토 수행
오늘날 모든 사람이 당신에게 100개의 무료 Claude Code 하위 에이전트 (subagents)를 건네줄 것입니다. 하지만 2주 차에 어떤 일이 벌어지는지는 거의 아무도 말해주지 않습니다. 한 에이전트는 얻지도 못한 성공을 보고하고, 두 에이전트는 동일한 파일을 두고 싸우며, 한 에이전트는 고객에게 거의 출시할 뻔한 지표를 지어내고, 예약된 작업은 success를 로깅하면서 조용히 죽어버립니다.
이 중 그 어느 것도 에이전트의 문제는 아닙니다. 그것들은 관리 (management) 문제입니다. 여기 제가 실제로 1인 콘텐츠 + 커머스 운영에 사용하고 있는 관리 계층이 있으며, 이를 30분 안에 설치할 수 있는 3개의 마크다운 (markdown) 파일로 축약했습니다. 프레임워크도, 의존성 (dependencies)도 없습니다.
멘탈 모델 (The mental model)
당신 ── 비서실장 (chief-of-staff) ── CMO ── 블로그 / 쇼츠 / 소셜 / 커머스 리드
├── 분석 리드 (analytics-lead) (사실만 기반)
├── QA 검토자 (qa-reviewer) (최종 관문)
...
작업 에이전트 (Worker agents)는 결과물을 생산합니다. 두 명의 감시자 (watchdogs)가 이를 관리합니다. 하나의 서면 계약이 자동 실행되는 모든 것을 규제합니다.
1단계 — 위임 계약서 작성하기 (10분)
시스템 전체에서 가장 레버리지가 높은 단 하나의 파일입니다. 어떤 에이전트가 자율적으로 실행되기 전에, 한 페이지 분량의 헌장 (charter)을 받게 됩니다:
# 자율 주행 헌장 (AUTOPILOT CHARTER) — <에이전트 이름>
## 목표 (Goal)
...
비결은 프롬프트 엔지니어링 (prompt engineering)이 아닙니다. 울타리가 _서면으로 작성되어 있다_는 점입니다. 에이전트는 울타리 안에서 자유롭게 움직일 수 있습니다.
2단계 — 두 명의 감시자 설치하기 (10분)
mkdir -p .claude/agents charters
cp agents/ops-monitor.md agents/qa-reviewer.md .claude/agents/
cp charters/AUTOPILOT_CHARTER.md charters/
ops-monitor는 가짜 녹색 대시보드로 인해 일주일을 허비하는 일을 막아줄 단 하나의 규칙을 강제합니다: 파이프라인은 오늘 생성된 공개 결과물 (public artifact)이 존재할 때만 살아있는 것이다. "로그에 success라고 적혀 있다"거나 "종료 코드 (exit code)가 0이다"가 아닙니다. 오늘 날짜가 찍힌 실제 mp4 / 게시된 포스트 / 전송된 보고서여야 합니다. 저의 이 시스템은 6일 동안 아무것도 게시하지 않으면서 success만 로깅하던 스케줄러로부터 탄생했습니다.
qa-reviewer는 무엇인가가 배포되기 전의 마지막 관문입니다. 모든 숫자를 출처와 대조하여 진위 여부를 확인하고, 개인정보 유출 여부를 grep으로 검색하며, 모든 링크를 해결하고, 플랫폼 규칙을 점검합니다. 이 에이전트의 BLOCK(차단) 판정은 다른 어떤 에이전트에 의해서도 뒤집힐 수 없으며, 오직 당신에 의해서만 뒤집힐 수 있습니다.
3단계 — 스케줄러에 연결하기 (10분)
어떤 cron을 사용해도 무방합니다. 중요한 패턴은 다음과 같습니다:
07:30 워커(workers) 실행 (생성, 큐(queues)로 게시)
08:10 ops-monitor: 어제의 결과물(artifacts)이 존재하는지 확인
08:15 하나의 통합 보고서 → 당신의 휴대폰으로 전송 (5줄, 사실 위주)
보고서 형식은 규율입니다. 모든 숫자는 출처가 있거나, 아니면 unverified(미확인)라고 표시되어야 합니다. 대시보드가 당신을 치켜세우는 것을 멈추는 첫 순간, 당신은 정상적으로 작동하고 있다고 믿었던 파이프라인 중 최소 하나가 작동하지 않고 있음을 발견하게 될 것입니다. (저는 세 개를 발견했습니다.)
30분 체크리스트
- 자율 에이전트(autonomous agent)당 하나의 헌장(charter) 작성 및 대괄호 플레이스홀더 채우기
- ops-monitor 설치 및 실제 출력 경로 지정
- qa-reviewer를 필수적인 마지막 관문으로 설치
- 일일 보고서 스케줄링 및 사실 위주(facts-only) 규칙 강제
- 인간만이 해결할 수 있는 차단 요소(Human-only blockers) 목록화 및 모든 보고서에 노출
파일
세 가지 파일 모두(헌장 템플릿 + 두 가지 감시 도구)는 여기서 무료로 받을 수 있습니다: ai-employee-management-layer — 순수 마크다운(markdown) 형식이며, MIT 라이선스로 바로 복사해서 사용하면 됩니다.
만약 전체 버전 — 12개의 역할 헌장(CMO, 리드, 분석, 소싱 등), 조직 설계 문서, 메모리 컨벤션(memory conventions), 그리고 이를 연결하는 자동화 팩 — 을 원하신다면, 그것은 제가 builderlog.net의 빌드 로그 제작 비용을 충당하기 위해 판매하는 AI Employee Company Starter Kit입니다.
특정 실패 모드(에이전트 간의 파일 점유권 다툼, 가짜 숫자, 조용한 작동 중단 등)에 대한 질문이 있다면 — 댓글을 남겨주세요. 이를 해결한 정확한 헌장 조항을 기꺼이 공유해 드리겠습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기