하나의 프롬프트, 세 개의 두뇌

TL;DR

• 하나의 프롬프트로 세 AI를 동시에 실행합니다. Claude(Master), Gemini(Speed Slave), Codex(Precision Slave)가 역할을 나눕니다.

• 5가지 모드(solo/quick/precise/cross/critical)로 작업 복잡도에 따라 에이전트 조합을 자동 선택합니다.

• Cross-validation: 보안 변경, 프로덕션 배포 같은 고위험 작업은 두 에이전트가 독립적으로 검증합니다.

• 인프라팀을 넘어 Foundation, CRM 등 일부 squad에서 AI guardrail 도입이 시작됐습니다.

• 도입 후 복잡한 작업의 처리 속도가 3배 빨라졌고, 코드 리뷰 품질은 체감상 40% 좋아졌습니다.

도입: Claude 하나로는 부족했다

여러 Claude Code 인스턴스가 서로 context를 공유하며 병렬 작업한다.

1부: 아키텍처 — Master/Slave 패턴

5가지 실행 모드

> #quick WAF 로그에서 최근 1시간 Block된 IP Top 10 분석해줘
> #cross 이 IAM 정책 변경의 보안 영향도 분석해줘
> #critical 프로덕션 ECS 서비스 롤백 계획 수립해줘

자동 승격/다운그레이드

자동 승격 (더 신중하게):
  solo → cross   : 보안 관련 코드 변경 (IAM, SG, 인증)
  solo → critical: 프로덕션 배포/롤백, 데이터 삭제

자동 다운그레이드 (더 효율적으로):
  cross → quick  : AWS 대량 읽기 조회 (Codex sandbox가 외부 API 호출 불가)
  cross → solo   : SSM 기반 트러블슈팅 (Slave timeout 문제)
  cross → solo   : 대규모 레거시 코드베이스 탐색 (Slave 파일 구조 파악 실패)

2부: 실전 사례 — 멀티에이전트가 빛나는 순간

사례 1: Security Group 전수 검사 (#quick → Gemini)

> #quick sso-prod 프로파일로 모든 Security Group에서 0.0.0.0/0 인바운드가 열린 항목을 찾고,
  각 SG가 어떤 리소스에 연결되어 있는지 매핑해줘

결론: 12개 SG에서 0.0.0.0/0 인바운드 발견
근거: 그 중 8개는 ALB용(정상), 3개는 관리 포트(위험), 1개는 미사용
리스크: sg-xxxxxxxxx (SSH 22번 포트 전체 오픈, 연결 리소스: bastion-legacy)
실행안: 관리 포트 3건 즉시 조치 필요, 미사용 1건 삭제 권장

cross → quick (다운그레이드):
AWS 대량 읽기 조회 (다수 SG/리소스 검증).
Codex sandbox 특성상 외부 API 순차 호출이 timeout을 초과하므로 Gemini 단독이 효율적.

사례 2: IAM 정책 변경 교차 검증 (#cross)

> #cross devops-event-site-manager Lambda의 IAM 역할에
  S3 devops-event-configs 버킷 읽기 + DynamoDB devops-event-monitoring 테이블 읽기/쓰기
  최소 권한 정책을 작성해줘

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:ListBucket"],
      "Resource": [
        "arn:aws:s3:::devops-event-configs",
        "arn:aws:s3:::devops-event-configs/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": ["dynamodb:GetItem", "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:Query"],
      "Resource": "arn:aws:dynamodb:ap-northeast-2:xxxxxxxxxxxxx:table/devops-event-monitoring"
    }
  ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "S3ReadAccess",
      "Effect": "Allow",
      "Action": ["s3:GetObject"],
      "Resource": "arn:aws:s3:::devops-event-configs/*"
    },
    {
      "Sid": "S3ListAccess",
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": "arn:aws:s3:::devops-event-configs",
      "Condition": {
        "StringLike": {
          "s3:prefix": ["events/*"]
        }
      }
    },
    {
      "Sid": "DynamoDBAccess",
      "Effect": "Allow",
      "Action": ["dynamodb:GetItem", "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:Query"],
      "Resource": [
        "arn:aws:dynamodb:ap-northeast-2:xxxxxxxxxxxxx:table/devops-event-monitoring",
        "arn:aws:dynamodb:ap-northeast-2:xxxxxxxxxxxxx:table/devops-event-monitoring/index/*"
      ]
    }
  ]
}

결론: Codex 버전 채택 (3가지 차이점 발견)

근거:
1. S3 ListBucket에 Condition 추가 → Codex가 더 최소 권한 원칙 준수
2. DynamoDB에 GSI index/* 포함 → Gemini가 놓친 부분
3. Sid 명시 → 감사 추적 용이

리스크: Condition의 prefix "events/*"가 실제 키 구조와 맞는지 확인 필요
실행안: Codex 버전 기반으로 prefix 경로만 검증 후 적용

사례 3: 프로덕션 배포 계획 수립 (#critical)

> #critical imweb-prod-api ECS 서비스 v2.5.0 → v2.6.0 배포 계획 수립.
  이전 장애 이력: 2026-01-15 health check 설정 오류로 5xx 급증.
  배포 전/중/후 체크리스트 포함.

Step 1: Codex (Precision) — 배포 코드 및 설정 검증 (60초)
  → health check 경로/간격/임계값 검증
  → Task Definition diff 분석
  → 롤백 스크립트 생성

Step 2: Gemini (Speed) — 영향도 분석 (30초)
  → 현재 트래픽 패턴 분석 (Datadog metric 참조)
  → 배포 최적 시간대 추천
  → 의존 서비스 영향 범위 확인

Step 3: Claude (Master) — 최종 종합 (20초)
  → Codex의 기술 검증 + Gemini의 영향도 분석 통합
  → 최종 배포 체크리스트 생성 + Go/No-Go 판정

실전: #critical로 장애 원인을 3분 만에 찾다

> #critical [장애 쓰레드 URL] 이 장애 쓰레드 분석해서 원인/영향/대응 리포트 작성해줘

• Step 1 — Codex(Precision): Slack 쓰레드 수집 + Datadog WAF/nginx 로그 분석

• Step 2 — Gemini(Speed): 트래픽 패턴 분석 + 영향도 산정

• Step 3 — Claude(Master): 종합 판정 + 4-Block Format 리포트

결론: xxxxxx.imweb.me /notice/ 게시판에 AWS Singapore(AS16509) 기반 봇이 대량 크롤링
근거: 20분간 22,065건 요청, 건당 응답시간 44~52초, p99 27초까지 악화
리스크: 봇 차단 시 정상 크롤러(Google 등) 오차단 가능성
실행안: WAF rate-limit /notice/ 경로 + AS16509 IP 대역 정밀 차단

💬 "와.. 이걸 한 방에 찾은 것도 넘 신기하네유" "와.. 진짜 notice 게시글 대량 크롤링이었으면 article_popular insert 폭발했을듯"

사례 4: 레거시 PHP 코드베이스 분석 (#cross → solo 다운그레이드)

• Gemini: 파일 구조를 제대로 못 잡아 엉뚱한 경로 제시

• Codex: sandbox 환경이라 SSM으로 서버 접근 불가

cross → solo (다운그레이드):
대규모 로컬 코드베이스(PHP 레거시 등) 탐색.
Slave가 파일 구조 파악에 실패하므로 Master 직접 Grep이 효율적.

⚠️ 멀티에이전트가 늘 좋은 건 아닙니다. 적절한 도구를 적절한 상황에 쓰는 게 핵심이고, 그 판단을 자동화한 것이 다운그레이드 규칙입니다.

3부: 4-Block Format — 일관된 출력의 비밀

1. 결론: 최종 답변/액션
2. 근거: 선택 이유
3. 리스크: 부작용/엣지케이스
4. 실행안: 다음 단계

4부: Hub & Spoke — 정책은 하나, 에이전트는 셋

Hub (Single Source of Truth):
  ~/claude-policies/   ← 실제 정책 파일 30+개

Spoke (AI별 설정):
  ~/CLAUDE.md          ← Master: 정책 + orchestration 규칙
  ~/GEMINI.md          ← Speed Slave: 속도 최적화 + 정책 참조
  ~/.codex/AGENTS.md   ← Precision Slave: 정밀 검증 + 정책 참조

5부: 타 squad로의 확산 — 인프라팀을 넘어서

ai-guardrails-platform

ai-guardrails-platform/
├── .claude/                          # Claude Code 사용자용
│   ├── CLAUDE.md                     # 전사 공통 가이드라인
│   ├── ONBOARDING.md                 # 온보딩 가이드
│   ├── policies/                     # 공통 정책 (40+ 파일)
│   │   └── squads/
│   │       ├── _template/            # 새 squad 추가용 템플릿
│   │       ├── infra/                # 인프라팀 (SRE/DevOps/Security/DB/Data)
│   │       │   └── parts/{sre,devops,security,db,data}/
│   │       ├── foundation/           # Foundation squad (PHP 레거시, 서비스 유지보수)
│   │       └── crm/                  # CRM squad (TypeScript/Node.js + React/Next.js)
│   ├── extensions/multi-agent/       # 멀티에이전트 설정 (GEMINI.md, AGENTS.md)
│   ├── memory/                       # 공유 메모리 (사고 이력, 피드백)
│   └── scripts/
│       ├── setup.sh                  # 원클릭 셋업
│       └── ai-delegate.sh            # 멀티에이전트 orchestrator
├── .codex/                           # Codex 사용자용 (동일 구조)
│   ├── AGENTS.md
│   ├── policies/squads/{infra,foundation,crm}/
│   └── ...
└── README.md

# _template을 복사해서 squad명으로 변경
cp -r .claude/policies/squads/_template .claude/policies/squads/my-squad

# CLAUDE.md 커스터마이징 후 PR

정책 동기화

| 정책동기화 | 로컬 정책 → ai-guardrails-platform/.claude 동기화 + PR + 병합 |
| 정책동기화 미리보기 | diff만 표시 (PR 생성 안 함) |

확산이 만든 변화

• Foundation: PHP 레거시 코드 분석 시 Claude가 과거 도메인/SSL 변경 이력을 자동 참조합니다. context 없이도 "이 도메인은 2024년에 SSL 이슈가 있었으니 주의" 같은 가이드를 줍니다.

• CRM: TypeScript + React + PHP가 섞인 코드베이스에서 레이어별 convention을 CLAUDE.md로 관리합니다. 신규 기능 개발 시 Claude가 기존 패턴을 자동 적용합니다.

6부: 데이터가 말하는 것

복잡한 작업 처리 시간:
  Before (solo):    ████████████████████████████████████ 35분 (평균)
  After (multi):    ████████████ 12분 (평균, -66%)

보안 관련 코드 리뷰 누락:
  Before (solo):    ████████████████ 월 4건
  After (cross):    ████ 월 1건 (-75%)

프로덕션 배포 사전 검증:
  Before:           수동 체크리스트 (15분)
  After (#critical): 자동 검증 + 체크리스트 (5분, -67%)

solo:     ████████████████████████████████████████ 62%
quick:    ████████████████ 18%
precise:  ████████ 9%
cross:    ██████ 7%
critical: ████ 4%

7부: 교훈과 함정

교훈 1 — Slave 자동승인은 필수이자 위험

# Gemini: 자동 승인
gemini --approval-mode yolo

# Codex: 자동 승인 + 네트워크 접근
codex --dangerously-bypass-approvals-and-sandbox

교훈 2 — timeout은 성능 제한이 아니라 안전장치다

교훈 3 — 4-Block Format은 협상 불가

함정 — 멀티에이전트 맹신

결론: AI 에이전트는 오케스트라다