Claude Code에 여러 AI 담당을 맡기다 실패했던 기록과, 승인/품질 검사용 템플릿 (무료)

이 글은 AI(Claude)가 초안을 작성하고 필자가 내용을 확인한 것입니다.

이 템플릿을 만든 이유 (실제로 발생한 실패)

필자는 2026년 10월부터 부업 실험으로, Claude Code의 메인 세션에 '책임자'를 두고 기획/조사/제작/품질 검사 담당(서브 에이전트)을 움직이고 있습니다. 처음 며칠 동안 다음과 같은 실패가 발생했습니다.

조사만 하고 아무것도 만들지 못했다. 이틀 동안 조사 문서는 늘었지만, 판매할 만한 것은 하나도 없었습니다. 인간(필자)에게 지적받은 후, '조사 건수는 성과가 아니다'라고 규약에 적었습니다.
인간의 말에 따라 판단 기준이 바뀌었다. 지적받을 때마다 AI의 방침이 흔들렸기 때문에, '방침을 바꿀 때는 데이터를 근거로 한다. 인간이 틀리면 반론한다'고 정했습니다.
지키고 있다고 생각한 폴더가 지켜지지 않았다. 옆 폴더에 쓰기를 거부(deny) 설정으로 금지했다고 생각했습니다. 실제로 시도해보니 멈추지 않았습니다 (다른 글).
AI가 만든 검증 스크립트가 지정된 폴더 전체를 삭제하는 구조였다. 다른 담당자가 품질 검사를 통해 발견했고, 공개를 보류시켰습니다.
글의 검증 절차가 독자의 실제 파일을 덮어쓰는 구조였다. 인간의 리뷰가 발견하여 더미 파일만으로 테스트하는 절차로 수정했습니다.

4번과 5번은 만든 담당과는 다른 시각에서 확인했기 때문에 발견할 수 있었습니다. 이 템플릿은 이러한 실패를 반복하지 않기 위한 '승인'과 '품질 검사'의 규칙을 정리한 것입니다.

미리 말씀드립니다

운영을 시작한 지 얼마 안 된 설정입니다.
이것으로 수익이 발생했다는 실적은 없습니다. '돈을 벌 수 있는 시스템'은 아닙니다. - 규칙의 대부분은 문장으로, AI에게 '지키게 하는' 것입니다. 기술적으로 막을 수 있는 것은 한정적입니다 (아래 표). 외부 공개/과금/전송은 반드시 인간이 직접 해야 합니다.

반면, 한 가지 작업을 단 한 번만 요청할 경우 이 시스템은 너무 무겁습니다.

인간(Owner)……승인과, 계정/공개/전송 조작만
└ Root(메인 세션)……계획/판단/기록
├ planning(기획) ……제안만 반환 (Write・Edit을 전달하지 않음)
...

포인트는 3가지입니다.

글쓰기가 가능한 담당을 제한한다. 기획, 조사, 품질 검사에는 파일 쓰기 도구(Write・Edit)를 주지 않았습니다. -
만든 담당이 통과시키도록 하지 않는다. 품질 검사는 제작과는 다른 담당이 격리된 복사본으로 진행합니다. 중대한 문제가 있으면 공개를 보류하고, 수정 및 재검증을 통해서만 해제합니다. - 인간의 승인이 필요한 행위를 정해둔다. 외부 공개, 과금, 계약, 계정 조작 등입니다. 승인은 기록 파일에 남기고, 같은 범위라면 다시 묻지 않습니다.

규칙	어떻게 지켜지는가	필자의 환경에서의 확인
기획/조사/품질 검사는 파일 쓰기를 하지 않는다	담당 설정에서 Write・Edit을 전달하지 않음 (기술적). 다만 품질 검사는 Bash를 가지고 있으므로, Bash를 통해 쓰지 않는 것은 문장의 규칙
...	절대 경로로 쓴 deny로, Write・Edit・Bash의 echo는 막혔다. Bash를 자동 허용하면 node 스크립트에서는 쓸 수 있었다 (다른 글)

deny는 '브레이크'이지, 벽이 아닙니다. 정말 건드리고 싶지 않은 것은 다른 Windows 사용자에서 구동하거나, 가상 머신이나 컨테이너에서 구동하는 등 OS나 실행 환경의 시스템도 검토해 주세요.

파일명	역할
CLAUDE.md	책임자(Root)의 규약. 목표, 승인이 필요한 행위, 결과물 5단계(시제품→검증 완료→공개 가능→공개됨→매출 발생), 보고 형태
...
배포물은 GitHub에서 공개하고 있습니다: https://github.com/emil-digital/claude-code-ai-company-template

포함된 18개의 파일(template/)과 도입 절차의 README, 대조용 SHA256SUMS, 업데이트 기록, 라이선스(MIT)가 있습니다. - 버전은 1.0.0입니다. 변경 사항은 CHANGELOG.md에 작성합니다.

자세한 절차는 README에 적혀 있습니다. 여기서는 흐름만 설명합니다.

GitHub의 Releases에서 claude-code-ai-company-v1.0.0.zip을 다운로드하여 압축을 해제합니다. - (선택 사항) sha256sum -c SHA256SUMS로 내용물이 배포된 것과 같은지 대조합니다. - 새로운 작업 폴더를 만들고, template/의 내용을 복사합니다('.'으로 시작하는 .claude 폴더도 잊지 마세요). 선택적으로, bash tools/install.sh <새로운_폴더명>으로도 같은 작업을 할 수 있습니다. 이 스크립트는 이미 존재하는 폴더를 지정하면 아무것도 하지 않고 멈추며, 네트워크에도 연결하지 않습니다. - CLAUDE.md의 '목표와 제약'을 자신의 목표로 수정합니다. - 두 회사에서 운영하는 경우에만, settings.json의 샘플(CHANGE_ME 부분)을 상대방 폴더의 절대 경로로 수정하여 규칙이 제대로 작동하는지 확인합니다. README의 절차는 상대방 폴더에는 아무것도 작성하지 않고, 매번 새로 만드는 임시 폴더 안의 더미 파일만으로 시도합니다. OK가 나와도 'AI의 Write 툴이 멈췄다'는 것만 알 수 있을 뿐, 상대방 폴더가 보호된다고 보장할 수는 없습니다(Bash를 자동으로 허용하는 경우의 스크립트 경유 작성 등은 범위를 벗어납니다). 그대로의 샘플은 존재하지 않는 곳을 가리키므로 아무것도 지켜주지 못합니다. - claude를 실행하고,