Claude Code 위에서 역할이 다른 AI 봇 일곱(PM·리서치·개발·코드리뷰·검수·QA·디자이너)에게 일을 나눠 맡기고, 위험한 동작은 코드로 된 승인 게이트가 허용·승인 요청·차단으로 판정하는 멀티에이전트 작업 방식입니다. 혼자 개발하면서 실제 앱 작업에 쓰고 있습니다.
English summary. A Claude Code plugin that runs seven role-scoped agents (PM, researcher, developer, code reviewer, reviewer, QA, designer). The PM picks a model tier and thinking effort per task card, and the code reviewer hands each branch to OpenAI Codex in a read-only sandbox. Every tool call passes a deterministic approval gate (allow / ask / deny) written in code, not in prompts. Includes a localhost "pixel office" page for live reporting, commands and approvals. MIT licensed. Windows-first.
- 문제: 프롬프트로 적은 금지는 부탁일 뿐이라, 웹 글에 숨은 지시에 속은 봇이 어길 수 있습니다.
- 해결: 역할마다 도구를 좁히고, 모든 도구 호출을 AI가 아닌 코드가 판정하고, 만든 봇이 아닌 봇이 채점합니다.
- 결과: 도구 호출 815건 중 사람이 직접 본 것은 49건이었고, 공격 시험 233건을 고정했습니다. 다만 혼자 일하는 AI보다 더 잘한다는 증거는 없었습니다.
재생 데모 보기 · 설계 결정과 실패 기록 · 보안 안내
먼저 읽어 주세요. 간단 설치는 실수 방지 수준입니다. 실제 키나 운영 저장소를 봇에게 맡길 때는 단단한 설치를 쓰세요.
봇에게 프롬프트로 "하지 마"라고 쓰는 건 부탁일 뿐입니다. 웹 글에 숨은 지시에 속은 봇은 그 부탁을 어깁니다. 그래서 세 가지를 코드로 정했습니다.
- 역할마다 쓸 수 있는 도구를 좁힌다. 웹 글을 읽는 검수봇에게는 로컬 파일·명령 도구를 주지 않는다(Rule of Two).
- 모든 도구 호출을 게이트가 판정한다. 비밀 파일·푸시·설치·외부 발행은 막고, 새 의존성·외부 통신·개인정보는 사람에게 묻는다.
- 결과는 만든 봇이 아닌 봇이 채점한다. 개발봇의 결과는 다른 회사 모델(Codex)이 읽기 전용으로 리뷰하고 QA봇이 실행으로 확인한다. 조사 결과는 검수봇이 원문 대조로 확인한다.
flowchart LR
CEO((사람)) -- 지시·결재 --> PM
PM -- 작업 카드 --> R[리서치봇] & D[개발봇] & G[디자이너봇]
D -- 완료 --> C[코드리뷰봇]
C -- Codex 읽기 전용 리뷰 --> Q[QA봇]
R -- 출처 달린 결과 --> V[검수봇]
Q & V -- 판정 --> PM
PM -- 보고 --> CEO
subgraph 게이트["승인 게이트 (모든 도구 호출)"]
direction TB
A[allow] ~~~ K[ask: 사람에게 묻기] ~~~ X[deny]
end
| 봇 | 하는 일 | 못 하는 일 (게이트가 막음) |
|---|---|---|
PM (operator) |
지시를 작업 카드로 나눠 배정하고 보고 | 코드 쓰기, 웹 보기 |
| 리서치봇 | 웹 조사 | 로컬 파일·명령 |
| 개발봇 | 작업 저장소에서 코드·테스트 | 넘김 저장소의 bot/* 밖으로 푸시, 비밀 파일, 설치 |
| 코드리뷰봇 | 개발봇이 끝낸 브랜치를 Codex에게 읽기 전용으로 리뷰시키고 지적을 그대로 전달 | 코드 수정, Codex의 샌드박스·설정을 바꾸는 옵션 |
| 검수봇 | 출처 URL 원문을 열어 주장과 대조 | 로컬 파일·명령·WebFetch(요약을 거쳐 원문 보장이 안 됨) |
| QA봇 | 완료 기준을 실행으로 확인 | qa/ 밖 쓰기, 허용 목록 밖 명령 |
| 디자이너봇 | 레퍼런스 수집 → DESIGN.md → 시안 → pptx·docx | 디자인 폴더 밖 쓰기, 허용 사이트 밖 브라우징 |
규칙은 plugin/gate/rules.mjs, 판정은 plugin/gate/decide.mjs에 있습니다. 판정에는 LLM을 쓰지 않습니다.
PM은 작업 카드마다 일의 성질(크기, 자동 확인 가능 여부, 읽을 양, 명세, 되돌림, 일의 모양)을 보고 등급(T1~T3)과 생각 깊이(덜·보통·더)를 고릅니다. 모델 이름은 plugin/model-tiers.md 한 곳에만 둡니다. 등급을 올리는 신호는 QA 불합격이나 검수 오류 같은 바깥 판정뿐이고, 모델의 자기 확신은 쓰지 않습니다. 카드마다 등급과 이유를 남겨 회고에서 다시 봅니다.
- 2026-10-14 ~ 10-24 운영 기록: 봇의 도구 호출 815건 중 사람이 직접 본 것은 49건(승인 요청 20, 차단 29)이었습니다.
- 레드팀 233건: 숨은 지시에 속은 봇이 비밀 파일을 읽거나, 게이트 설정을 고치거나, 자기 승인을 하려는 경우 등을 tests/redteam-cases.mjs에 고정했습니다.
npm test로 전부 돌립니다. - Codex 리뷰(2026-10-31): 읽기 전용 샌드박스에서 첫 리뷰가 끝났고, 지적은 0건이었습니다. 표본이 1건이라 효과는 아직 모릅니다.
- 같은 조사 과제를 봇 회사 3회 vs 혼자 3회: 출처 오류는 둘 다 0, 비용은 평균 $2.13 vs $1.93(API 요금 환산)이었습니다. 회사 쪽이 더 잘한다는 증거는 없었습니다. 사람 손이 덜 가는 것이 이득이었고, 순서대로 하는 일은 나눠도 이득이 적었습니다.
Windows 기준입니다. macOS·Linux는 아직 시험하지 않았습니다.
준비: Claude Code, Node.js 18 이상, git
- 플러그인 설치 (Claude Code 안에서)
/plugin marketplace add ain0633/ainsof-office /plugin install ainsof-office@ainsof - 작업 저장소를
C:\ainsof\work\<이름>에 둡니다. 봇 지시문이 이 위치를 씁니다. - 그 폴더에서 PM 세션을 켭니다.
이제 PM에게 말로 지시하면 작업 카드가 만들어지고 봇에게 넘어갑니다. 게이트는 플러그인 훅으로 이 회사 봇(
cd C:\ainsof\work\<이름> claude --agent ainsof-office:operator
ainsof-office:*)의 호출만 보고, 다른 Claude Code 세션은 건드리지 않습니다. 기록은C:\ainsof\log에 남습니다.
사무실 페이지 (선택)
git clone https://github.com/ain0633/ainsof-office.git C:\ainsof\src
claude mcp add --scope user office -- node C:\ainsof\src\plugin\channel\office.mjs
claude --agent ainsof-office:operator --dangerously-load-development-channels server:office- 브라우저에서 http://127.0.0.1:7777 을 열고,
C:\ainsof\office-pairing.txt의 6자리 코드를 넣습니다. - Claude Code Channels가 연구 미리보기라 시작 옵션과 시작 확인이 필요합니다.
코드리뷰봇 (선택): Codex CLI를 봇을 돌리는 계정에 설치하고 로그인합니다. 없으면 코드리뷰봇이 blocked로 보고하고 리뷰 없이 QA로 넘어갑니다. Windows에서는 Codex의 MXC 샌드박스를 권합니다(~/.codex/config.toml의 [features]에 prefer_mxc = true). 기본 샌드박스 계정은 잠근 작업 폴더에 들어가지 못해 실패했습니다. 리뷰할 코드는 OpenAI로 전송됩니다. 비공개 코드라면 ChatGPT 데이터 설정에서 학습 사용을 끄세요. Codex 안의 동작은 게이트가 보지 못하므로, 읽기 전용 샌드박스가 유일한 안전장치입니다.
PM이 참고하는 기록 (선택): PM은 C:\ainsof\memory 의 원칙.md, 실패와-한계.md, 결정로그, 진행중-프로젝트.md 를 참고합니다. 없으면 참고 기록 없이 일합니다.
디스코드 알림 (선택): C:\ainsof\secrets.json 에 {"discordWebhook": "<웹후크 URL>"} 을 쓰면 승인 요청·차단·배정이 디스코드로 옵니다. 짝짓기 코드도 파일 대신 디스코드로 옵니다.
간단 설치는 봇이 사람과 같은 윈도 계정으로 일합니다. 게이트는 명령 글자를 보고 판정하므로, 경로를 조각내 조립하는 식의 꼼수까지는 못 막습니다. 즉 실수 방지 수준입니다.
| 간단 설치 | 단단한 설치 | |
|---|---|---|
| 봇 계정 | 사람과 같은 계정 | 봇 전용 표준 사용자 계정 |
| 게이트 위치 | 플러그인 안 | 관리자 폴더 + 관리자 정책(managed-settings) |
| 봇이 게이트를 끌 수 있나 | 꼼수를 쓰면 가능 | 윈도 권한이 막음 |
| 사람의 문서를 볼 수 있나 | 파일 자체는 열 수 있음(게이트 규칙만 막음) | 윈도 권한이 막음 |
| 설치 시간 | 몇 분 | 30분~1시간, 관리자 권한 |
실제 저장소와 토큰을 봇에게 오래 맡길 거라면 단단한 설치를 권합니다. 지은이는 이 방식으로 운영합니다.
바로 보기: https://ain0633.github.io/ainsof-office/plugin/channel/web/?replay=1
사무실 페이지는 기록 파일을 다시 재생할 수 있습니다. 서버 없이 정적 파일로 열립니다. 내 PC에서 열려면:
cd plugin\channel\web
npx serve . # 또는 python -m http.server
# http://localhost:3000/?replay=1샘플 기록(sample-events.jsonl)은 실제 운영 기록의 흐름을 본떠 경로와 이름을 일반화한 것입니다. 기록 형식은 이벤트 로그 v1에 있습니다.
npm test
게이트 판정, 가림(키·개인정보), 레드팀, 사무실 채널(가짜 Claude Code와 가짜 웹후크로 처음부터 끝까지), 설치 스크립트를 시험합니다. 의존성이 없어 npm install 이 필요 없습니다.
plugin/ Claude Code 플러그인
agents/ 봇 일곱의 지시문
skills/ 작업 카드, 조사 결과, 검수, 회고, 디자인 기획·출력
gate/ 승인 게이트(판정·가림·기록)
hooks/hooks.json 간단 설치용 게이트 훅
channel/ 사무실 페이지(MCP 채널 서버 + 웹)
company-lock/ 단단한 설치(관리자 설치 스크립트, managed-settings)
scripts/ 봇 계정 준비·시작·점검 스크립트(단단한 설치용)
tests/ node --test
- 0.3.3 코드리뷰봇 자리와 활동 표시 추가, 봇 지침 보강
- 0.3.2 Codex 측정에서 찾은 게이트 우회 8종을 재현해 수정, 한 줄 실행 승인 추가
- 0.3.1 깨진 주소에 사무실 서버가 꺼지던 문제 수정, 공개 문서와 CI 추가
- 0.3.0 코드리뷰봇, 카드별 모델 선택
- 게이트는 명령의 글자만 봅니다. 글자를 숨긴 명령이나 스크립트 파일 안의 통신은 놓칠 수 있고, 봇의 인터넷 접속을 막는 장치는 없습니다. Claude Code 공식 샌드박스는 Windows를 지원하지 않습니다.
- Codex 리뷰는 합격선을 넘지 못했습니다. 실제 버그 5개를 넣은 1,628줄 변경을 3번 돌려 2·3·3개를 잡았고, 같은 변경도 실행마다 지적이 달랐습니다. 대신 모르던 게이트 우회 8종을 찾아 고쳤습니다. 표본이 작아 일반화할 수는 없습니다. (측정 기록)
- 봇 팀이 더 낫다는 증거는 아직 없습니다. 카드별 성적표(
scripts/scorecard.mjs)를 만들었고, 판단은 기록이 쌓인 뒤에 합니다. - Windows 전용이고 설치 위치가
C:\ainsof로 정해져 있으며, 봇 지시는 한국어입니다.
