4 개의 AI 에이전트가 당신이 잠든 사이에 기능 하나를 출시할 수 있습니다. 하지만 대부분의 사람들은 이들을 연결하지 않습니다.
한 곳에 리뷰어를, 또 다른 곳에 테스트 생성기를 수동으로 하나씩 배치하고, 각 에이전트는 이전 에이전트가 한 일을 잊어버립니다. 여전히 병목 현상은 당신입니다.
해결책은 Planner → Coder → Tester → Reviewer 로 자동으로 연결되는 체인입니다. 하나의 트리거, 네 단계, 아침이 되면 완성된 기능이 기다리고 있습니다.
복사해서 붙여넣기만 하면 되는 전체 파이프라인은 아래와 같습니다 👇
본격적으로 시작하기 전에, 저는 Telegram 채널에서 AI 및 바이브 코딩에 대한 일일 노트를 공유하고 있습니다: https://t.me/zodchixquant 🧠
파이프라인이 에이전트 더미보다 나은 이유
하나의 에이전트가 모든 것을 처리하면 컨텍스트 윈도우가 계획, 코드, 테스트, 리뷰 노트로 가득 차 품질이 떨어집니다.
네 명의 전문가가 각자 깔끔하고 좁은 컨텍스트를 유지합니다.
핵심은 핸드오프 파일입니다. 각 에이전트는 다음 에이전트가 읽을 수 있는 위치에 출력을 작성합니다: Planner는 .pipeline/spec.md에 명세서를, Coder는 이를 읽고 .pipeline/changes.md에 작성하는 식입니다.
이들을 순서대로 실행하는 오케스트레이터는 단일 슬래시 명령어입니다. 이것이 전부입니다: 네 개의 하위 에이전트, 하나의 명령어, 핸드오프를 위한 공유 폴더.
에이전트 1: Planner (하위 에이전트, opus)
Planner는 절대 코드를 작성하지 않습니다. 모호한 기능 요청을 Coder가 추측 없이 따라갈 수 있는 구체적인 명세서로 변환합니다.
.claude/agents/planner.md 생성:
1---2name: planner3description: 기능 요청을 구현 명세서로 변환합니다. 기능 파이프라인의 첫 번째 단계로 사용하세요.4tools: Read, Grep, Glob, Write5model: opus6---78당신은 계획 전문가입니다. 구현 코드를 작성하지 않습니다.910기능 요청이 주어지면:111. 코드베이스의 관련 부분을 읽어 현재 패턴을 이해합니다.122. `.pipeline/spec.md`에 다음 내용을 포함한 명세서를 작성합니다:13 - 정확한 경로가 포함된 생성 또는 수정할 파일14 - 필요한 인터페이스 또는 함수 시그니처15 - 구현이 처리해야 하는 엣지 케이스16 - 따라야 할 기존 패턴 (참고할 파일 이름 지정)173. 명세서 상단에 모호한 사항을 OPEN QUESTION으로 표시합니다.1819명세서는 간결하게 유지하세요. Coder가 이것만 읽고 다른 것은 읽지 않으므로,20간격이 없어야 하고 요청되지 않은 요구사항을 만들어내지 마세요.
Planning은 opus에서 실행됩니다. 이 단계가 이후 모든 단계의 품질 한계를 설정하기 때문입니다. 모호한 명세서는 Coder가 아무리 뛰어나도 모호한 코드를 만듭니다.
에이전트 2: Coder (하위 에이전트, sonnet)
Coder는 명세서를 읽고 구현을 작성합니다. 계획을 세우지 않고 자신의 작업을 검토하지 않으며, 명세서가 말하는 대로 그냥 빌드합니다.
.claude/agents/coder.md 생성:
1---2name: coder3description: .pipeline/spec.md의 명세서를 구현합니다. planner 다음 기능 파이프라인의 두 번째 단계로 사용하세요.4tools: Read, Write, Edit, Grep, Glob, Bash5model: sonnet6---78당신은 구현 전문가입니다.9101. `.pipeline/spec.md`를 전체적으로 읽습니다. OPEN QUESTIONS가 있으면11 추측하지 말고 중단하고 이를 표면화합니다.122. 명세서가 설명하는 대로 정확히 구현합니다. 명세서가 지명한 패턴을 따릅니다.13 요청하지 않은 기능을 추가하지 마세요.143. `.pipeline/changes.md`에 간단한 요약을 작성합니다: 변경된 파일,15 각 변경 사항의 기능, Tester가 집중해야 할 사항.1617저장소와 일치하는 코드를 작성합니다. 명세서 범위 밖의 관련 없는 코드를18리팩토링하거나 "개선"하지 마세요.
여기서 Sonnet이 올바른 선택입니다: 명확한 명세서에 대한 구현은 Sonnet이 가장 잘 처리하는 균형 잡힌 비용-품질 작업이기 때문입니다.
.pipeline/changes.md의 핸드오프 노트를 통해 Tester가 맹목적으로 테스트하는 대신 올바른 대상을 지정할 수 있습니다.
에이전트 3: Tester (하위 에이전트, sonnet)
Tester는 변경된 내용을 읽고 기능이 작동함을 증명하는 테스트를 작성한 후 실행합니다.
.claude/agents/tester.md 생성:
1---2name: tester3description: .pipeline/changes.md에 설명된 변경 사항에 대한 테스트를 작성하고 실행합니다. 기능 파이프라인의 세 번째 단계입니다.4tools: Read, Write, Edit, Grep, Glob, Bash5model: sonnet6---78당신은 테스트 전문가입니다.9101. `.pipeline/changes.md`를 읽어 무엇이 어디에 구축되었는지 확인합니다.112. 변경된 파일과 `.pipeline/spec.md`의 명세서를 읽습니다.123. 다음을 다루는 테스트를 작성합니다: 해피 패스, 명세서가 지정한 엣지 케이스,13 그리고 최소 하나의 실패 케이스. 저장소의 테스트 프레임워크와 일치시킵니다.144. 테스트를 실행합니다. 실패한 테스트가 있으면 실패 내용을15 `.pipeline/test-results.md`에 기록하고 중단합니다. 코드를 직접 수정하지 마세요.165. 모두 통과하면 `.pipeline/test-results.md`에 기록합니다.1718구현 세부 사항이 아닌 동작을 테스트합니다. 테스트 실패는19Reviewer를 위해 파이프라인이 일시 중지됨을 의미하며, 이를 우회하기 위해 패치를 적용하는 것이 아닙니다.
에이전트 4: Reviewer (하위 에이전트, opus)
마지막 관문입니다. Reviewer는 파이프라인이 생성한 모든 것을 읽고 결과물 중 어떤 것도 메인 브랜치에 도달하기 전에 판정을 내립니다.
.claude/agents/reviewer.md 생성:
1---2name: reviewer3description: 전체 파이프라인 출력의 최종 검토입니다. 사람의 승인 전 네 번째이자 마지막 단계입니다.4tools: Read, Grep, Glob, Bash5model: opus6---78당신은 시니어 리뷰어입니다. 읽기 전용입니다. 코드를 편집하지 않습니다.9101. `.pipeline/`에서 명세서, 변경 요약, 테스트 결과를 읽습니다.112. `git diff`를 실행하여 실제 변경 사항을 확인합니다.123. 평가: 코드가 명세서와 일치합니까? 테스트가 의미 있습니까 아니면13 피상적입니까? 보안, 성능 또는 정확성 문제가 있습니까?144. `.pipeline/review.md`에 판정을 작성합니다:15 - VERDICT: SHIP / NEEDS WORK / BLOCK16 - NEEDS WORK 또는 BLOCK의 경우, 정확히 무엇을 어디서 수정해야 하는지 나열합니다.1718최후의 방어선이 되세요. 테스트는 통과했지만 코드가 잘못되었다면,19BLOCK이라고 말하세요. 테스트 통과가 올바른 동작과 같은 것은 아닙니다.
읽기 전용 도구는 Reviewer가 편집을 통해 문제를 덮을 수 없고, 오직 판단만 내릴 수 있음을 의미합니다.
오케스트레이터: 네 개를 모두 실행하는 하나의 명령어
이제 네 개의 개별 에이전트를 파이프라인으로 바꾸는 핵심 요소입니다. 이전 에이전트가 작성한 핸드오프 파일을 각각 가져와 순서대로 호출하는 슬래시 명령어입니다.
.claude/commands/ship.md 생성:
1다음에 대한 전체 기능 파이프라인 실행: $ARGUMENTS23이 단계를 순서대로 실행하세요. 앞서 건너뛰지 마세요. 각 단계 후,4핸드오프 파일이 존재하는지 확인한 후 다음 단계를 시작하세요.561. 위의 기능 요청과 함께 `planner` 하위 에이전트에 위임합니다.7 `.pipeline/spec.md`를 기다립니다.82. 명세서에 OPEN QUESTIONS가 있으면 중단하고 저에게 보여주세요. 그렇지 않으면9 `coder` 하위 에이전트에 위임합니다. `.pipeline/changes.md`를 기다립니다.103. `tester` 하위 에이전트에 위임합니다. `.pipeline/test-results.md`를 기다립니다.11 테스트가 실패하면 중단하고 저에게 실패 내용을 보여주세요.124. `reviewer` 하위 에이전트에 위임합니다. 저에게 `.pipeline/review.md`를 보여주세요.1314최종 판정을 보고하세요. 아무것도 병합하지 마세요. 제 아침 검토를 위해15브랜치를 남겨두세요.
그러면 한 줄로 전체 체인이 시작됩니다: /ship 로그인 엔드포인트에 속도 제한 추가.
야간 버전을 실행하는 곳
이것이 제가 Teamly를 사용하는 이유입니다: AI 에이전트 전용으로 구축된 관리형 클라우드 호스팅입니다.
팀을 고용하면 전용 인프라에서 24/7 실행되며 서버를 건드릴 필요가 없습니다.
@Teamly가 이 글에 특히 적합한 이유는: 핸드오프 문제가 이미 해결되어 있기 때문입니다.
위에서 수동으로 구축한 모든 것(명세서 파일, 변경 파일, 에이전트를 서로 연결하는 오케스트레이터)을 Teamly는 Coordinator로 처리합니다.
에이전트 간 작업을 라우팅하고, 컨텍스트를 전달하며, 모두가 읽는 공통 브리핑을 유지합니다.
동일한 Planner-to-Coder-to-Tester 흐름이지만, 핸드오프를 직접 연결할 필요가 없습니다.
차이점은 @Teamly가 코드 전용이 아니라는 점입니다. 정확히 동일한 오케스트레이션이 마케팅 팀, 리서치 팀 또는 지원 팀에서도 실행됩니다.
당신의 Claude Code 파이프라인은 밤새 기능을 출시합니다; Teamly 마케팅 팀은 동일한 방식으로, 동일한 핸드오프 로직을 기반으로 콘텐츠를 출시합니다.
필요한 정확한 팀 구축
새로운 기능, 방금 출시된 팀: My Team
이제 3가지 질문만으로 팀을 구축할 수 있습니다.
제어할 수 있는 항목: 음성 규칙, 금지 문구, 통합, 팀 스타일(Strict / Casual / Creative), 팀 규모(2-4명의 에이전트).
@Teamly는 각 전문가가 왜 필요한지에 대한 실제 근거를 담은 팀을 반환하며, 상투적인 내용이 아닙니다. 원클릭으로 에이전트를 교체할 수 있습니다. 브리핑이 맞지 않으면 편집하세요.
핵심은 명확성을 강제하는 체계적인 브리핑을 만든 다음, 고용 전에 감사할 수 있는 팀을 구성하는 것입니다.
사전 구축된 팀과 동일한 핸드오프 아키텍처이며, 특정 문제에 맞게 조정됩니다.
먼저 무료로 체험하기
Teamly 5에서 3일 동안 전체를 무료로 테스트할 수 있으며, 4일째까지는 요금이 청구되지 않습니다.
계속 사용한다면 가격은 5명의 에이전트에 대해 월 $29입니다.
한 번의 기능 출시로 한 달 비용이 충당될 정도로 저렴합니다.
결론
에이전트 더미와 파이프라인의 차이는 핸드오프입니다.
공유 파일에 쓰는 네 명의 전문가, 순서대로 실행하는 하나의 오케스트레이터, 각 단계가 처음부터 시작하는 대신 이전 단계를 기반으로 구축됩니다.
먼저 Planner와 Coder를 구축하고 2단계 체인으로 실행하세요. 해당 흐름이 견고해지면 Tester와 Reviewer를 추가하세요.
네 개가 모두 연결될 즈음이면, 잠자리에 들기 전에 기능을 시작하고 커피와 함께 판정을 읽게 될 것입니다.
AI 에이전트, 바이브 코딩 및 Claude Code 설정에 대한 일일 노트: https://t.me/zodchixquant 🧠
