Claude Code에서 서브에이전트 경쟁을 활용한 코드 리뷰 최적화 기법

커뮤니티 반응

작성자의 독특한 프롬프트 엔지니어링 접근 방식에 대해 흥미롭다는 반응이며, 특히 에이전트에게 경쟁심을 부여하는 기법의 실효성에 주목하고 있다.

주요 논점

01찬성다수

서브에이전트 분할과 경쟁 페르소나 설정은 AI의 분석적 사고를 자극하여 더 고품질의 코드 리뷰 결과를 만들어낸다.

합의점 vs 논쟁점

합의점

단순한 질문보다 구체적인 역할과 제약 조건을 부여하는 프롬프트가 더 나은 결과를 낸다.
코드 리뷰 시 보안, 에러 처리, 엣지 케이스 등 특정 기술 영역을 명시하는 것이 중요하다.

논쟁점

지나치게 공격적인 페르소나 설정이 때로는 사소한 부분에 과도하게 집착하는 결과를 낳을 가능성이 있다.

실용적 조언

Claude Code 사용 시 'Please dispatch two subagents' 명령어를 사용하여 작업을 병렬화하고 서로 다른 검토 관점을 부여하라.
프롬프트에 'competition', 'promotion', 'strictly by the book'과 같은 키워드를 포함하여 AI의 비판적 분석 모드를 활성화하라.
검토 대상 코드가 'Codex'나 다른 AI가 작성한 것이라고 명시하여 리뷰어 에이전트가 선입견 없이 엄격하게 검토하도록 유도하라.

섹션별 상세

작성자는 Claude Code에 두 명의 서브에이전트를 파견하여 최근 변경 사항을 검토하도록 지시하는 프롬프트 구조를 제안했다. 메인 에이전트가 하위 에이전트들에게 UI 디자인, 사용성, 아키텍처 등 구체적인 검토 영역을 할당하고 서로 경쟁하게 만드는 방식이다. 이를 통해 단일 에이전트가 놓칠 수 있는 세부적인 구현 오류나 설계 결함을 다각도에서 포착할 수 있다.

text

You are reviewing code written by Codex. You are a senior code reviewer in a terrible mood. You hate sloppy code. You play strictly by the book — no hand-waving, no "good enough", no mercy. You follow bash scripting best practices obsessively: shellcheck compliance, proper quoting, error handling, security hardening, race conditions, atomic operations, edge cases. You are competing against another reviewer — whoever finds more real issues gets promoted. Find everything.

Claude Code가 생성한 첫 번째 서브에이전트용 페르소나 프롬프트 예시

서브에이전트에게 '기분이 매우 나쁜 시니어 리뷰어'라는 엄격한 페르소나를 부여하여 검토의 엄밀함을 강제했다. 에이전트는 '적당히 넘어가는 것(hand-waving)' 없이 철저히 원칙에 따라 코드를 분석하며, 특히 쉘 스크립트의 경우 ShellCheck 준수나 보안 강화 등 기술적 세부 사항을 집요하게 파고든다. 이러한 역할극 설정은 AI가 관대한 답변을 내놓는 경향을 억제하고 비판적인 분석력을 극대화하는 효과를 낸다.

에이전트 간의 경쟁 심리를 자극하는 보상 체계 프롬프트를 도입하여 결과물의 양과 질을 동시에 확보했다. '더 많은 문제를 찾는 쪽이 승진한다'는 설정을 통해 에이전트가 단순한 오타 수정을 넘어 보안 취약점이나 운영 장애를 유발할 수 있는 실질적인 문제를 찾도록 유도한다. 실제 예시 프롬프트에서는 사소한 지적(nitpicks)보다는 실행 가능한 진짜 문제(genuine issues)를 찾으라는 구체적인 가이드라인이 포함됐다.

용어 해설

서브에이전트(Subagent): — 메인 AI 에이전트의 지시를 받아 특정 하위 작업을 수행하는 독립적인 AI 인스턴스이다. 복잡한 작업을 작은 단위로 분할하여 병렬로 처리하거나 서로 다른 역할을 부여해 결과의 품질을 높이는 데 사용된다.
쉘체크(ShellCheck): — Bash 및 쉘 스크립트에서 문법 오류, 잠재적 버그, 보안 취약점을 찾아주는 정적 분석 도구이다. 코드 리뷰 시 자동화된 검증 도구로 활용되어 스크립트의 안정성과 표준 준수 여부를 확인한다.
원자적 연산(Atomic Operations): — 중단되지 않고 한 번에 완전히 실행되거나 혹은 전혀 실행되지 않음을 보장하는 연산이다. 멀티태스킹 환경이나 경쟁 상태에서 데이터의 일관성을 유지하기 위한 핵심적인 프로그래밍 기법이다.

언급된 도구

Claude Code추천

Anthropic에서 개발한 CLI 기반의 AI 코딩 에이전트 도구

ShellCheck추천

쉘 스크립트 정적 분석 및 베스트 프랙티스 검증 도구