Claude 코딩의 혼란을 3인 에이전트 팀(설계자+구현자+검토자)으로 해결했습니다 — 토큰 효율적이고 효과적입니다

r/ClaudeAI (및 Claude Code와 Cli 또는 데스크톱 앱을 사용하는 모든 분들께),

에이전트 워크플로우에 관한 논문을 많이 읽고 단독 AI 코딩 세션에서 토큰을 너무 많이 낭비한 끝에, 실제로 효과가 있는 아주 간단한 구조인 3인 AI 개발 팀을 구성했습니다.

주의: 이것은 팀을 위한 기본 레이어입니다. 특정 코드 구조나 코드베이스에 맞춰 설정된 것이 아닙니다. 여러분이 작업 중인 내용을 가르치고 코딩 표준을 직접 적용해야 합니다. 아니면 3인 팀의 각 멤버에게 추가적인 'SuperPowers' 기술을 할당할 수도 있습니다.

저는 현재 이 구조를 사용하여 새로운 SaaS 제품을 처음부터 구축하고 있습니다. 워드프레스 빌드, 내부 도구, 크롬 확장 프로그램 및 기타 프로젝트에서도 이 설정을 실행하여 좋은 결과를 얻었습니다.

Built With Claude.

3인 팀의 작동 방식

의도적으로 엄격하게 구성했습니다(그게 핵심입니다):

설계자(기획자): Arch
높은 수준의 요청을 받아 긴밀하고 범위가 지정된 브리핑으로 분해한 뒤 전달합니다. 모호한 방황은 없습니다. 큰 그림을 소유하며 배포 승인만 담당합니다.

구현자(실행자): Bob
설계자의 브리핑을 받아 짧은 계획을 세운 뒤 요청된 내용을 정확히 코딩합니다. 지시받지 않은 이상 무작위 기능을 추가하거나 전체 코드베이스를 읽지 않습니다.

검토자(품질 관리자): Richard
출력물을 브리핑과 엄격하게 대조하여 확인합니다. 승인하거나 수정을 위해 되돌려 보냅니다. 이 단계를 거치지 않으면 아무것도 배포되지 않습니다. 범위와 구축된 내용에 대해 매우 엄격합니다.

핸드오프는 모두 handoff/ 폴더의 간단한 마크다운 파일을 통해 이루어집니다. 매우 투명하고 따라하기 쉽습니다. 모든 것은 컨텍스트 파일(CLAUDE.md, 에이전트 프롬프트, 토큰 규칙)을 통해 제어되므로 Claude Code, Cursor, VS Code 및 프로젝트 컨텍스트를 읽을 수 있는 모든 LLM과 작동합니다.

파일을 GitHub나 Bitbucket 저장소에 추가하고 프로젝트 노트를 보관하세요. 이전 브랜치를 체크아웃하여 오래전 노트를 확인할 수 있습니다.

단독 모드보다 더 나은 이유

엄청난 토큰 절약: 내장된 규칙이 불필요한 컨텍스트 읽기, 추측성 호출 및 컨텍스트 비대화를 방지합니다. (셸 출력을 압축하기 위해 RTK와 함께 사용하는 것을 권장합니다.)

표류와 환각이 훨씬 적습니다. 엄격한 순서 덕분에 AI가 작업 도중 궤도를 벗어나는 것을 방지합니다.

소규모의 구조화된 팀(3~5개 에이전트)은 거대하고 지저분한 무리나 단독으로 작업하는 것보다 일관되게 더 나은 성과를 냅니다. 한 줄 스크립트로 30초 만에 전역 설치가 가능합니다. 재미있는 이름의 페르소나(Arch, Bob, Richard)를 포함한 준비된 템플릿이나 직접 커스터마이징할 수 있는 빈 템플릿이 제공됩니다.

저장소: https://github.com/russelleNVy/three-man-team (MIT 라이선스, 완전 공개)

무료 워드프레스 플러그인을 만들면서 이 방식을 반복적으로 개선해왔습니다. 이 팀을 가져와서 여러분만의 린팅(Linting)과 표준을 구현자 Bob이나 검토자 Richard에게 추가하세요. 또는 팀을 설치하고 애플리케이션을 구축하거나 웹사이트를 시작하도록 팀에 지시하세요.