코딩 에이전트 운영 심화: 멀티 에이전트와 검수 체계
코딩 에이전트 운영 심화는 일을 명확히 맡기고 결과를 확인하는 방법을 8편으로 정리한 코스입니다. 에이전트 하나의 결과를 검토하는 분부터 여러 작업자의 결과를 합치는 분까지 필요한 부분을 골라 볼 수 있습니다.
여러 에이전트를 동시에 쓰면 독립적인 일을 나눌 수 있지만 전달과 중복 조사, 통합에 드는 시간도 늘어납니다. 이 코스에서는 작업자 수를 늘리는 것보다 한 작업의 요청과 결과가 맞는지 확인하는 데서 시작합니다.
시작 전에 준비할 것
메모장과 계산기만 있으면 가상 요청과 결과를 비교하는 연습을 시작할 수 있습니다. 여러 유료 도구에 가입하거나 에이전트를 동시에 실행할 필요는 없습니다.
워크트리 실습은 깃이 설치된 macOS 또는 리눅스 터미널을 사용합니다. 깃은 파일의 변경 버전을 관리하는 도구입니다. 익숙하지 않다면 깃 기초부터 확인하고, 실제 프로젝트가 아닌 새 임시 저장소에서 연습합니다.
📚 다루는 개념 8가지
- 업무와 완료 기준: 작업 명세 쓰기, 검수 체계, 에이전트를 쓰지 않을 때
- 작업 분리와 통합: 멀티 에이전트 작업 설계, 깃 워크트리와 병렬 세션
- 비용과 문제 대응: 비용과 토큰 예산, 실패 유형과 대응, 관측과 기록
처음에는 이 순서로 해 봅니다
- 작업 명세 편의 작은 요청에서 바꿀 내용과 유지할 조건을 나눠 적습니다.
- 검수 체계 편에서 원래 요청과 결과를 대조하고, 틀린 부분을 고친 뒤 다시 확인합니다.
- 에이전트를 쓰지 않을 때 편에서 요청부터 검수까지 걸린 전체 시간을 비교합니다.
- 나눌 이유가 있는 작업이라면 멀티 에이전트 설계와 워크트리 편으로 넘어갑니다.
첫 연습의 결과물은 요청, 확인 기준, 발견한 오류와 수정 뒤 결과를 적은 짧은 메모입니다. 예상과 다르면 틀린 결과를 완료로 넘기지 말고 요청과 검사 조건을 대조합니다. 가상 요청과 결과로 이 메모를 작성하고 조건 하나를 바꿔 다시 확인할 수 있으면 첫 연습을 마친 것입니다. 전체 운영을 숙달했다는 뜻은 아닙니다.
비용 편에서는 추가 작업으로 예산이 넘을 때 범위를 조정하고, 실패 편에서는 잘못된 검사 기준 변경과 정당한 변경을 구분합니다. 기록 편에서는 로그에 보이는 사실과 아직 확인하지 못한 원인을 나눠 적습니다.
❓ 자주 묻는 질문
에이전트를 하나만 써도 도움이 되나요?
작업 명세, 검수, 비용과 실패 기록은 한 에이전트를 쓸 때도 활용할 수 있습니다. 워크트리는 작업 폴더를 나누는 기능입니다. 여러 작업자를 쓰거나 혼자 별도 수정안을 시험할 필요가 생겼을 때 실습해도 됩니다.
개발자가 아니어도 따라갈 수 있나요?
메모장으로 하는 판단 연습부터 시작할 수 있습니다. 터미널 명령이 나오는 실습은 준비 조건을 먼저 확인합니다. 명령이 실패하면 오류를 남기고 멈춘 단계부터 확인하며, 실제 업무 폴더에 그대로 반복 실행하지 않습니다.
요금과 설정은 계속 같나요?
도구와 계정 조건은 바뀔 수 있습니다. 각 글의 확인일과 공식 링크를 보고 실제 사용할 계정의 조건을 다시 확인합니다. 구독에 포함된 사용량과 추가 지출, 계획 예산과 서비스의 지출 상한도 구분합니다.
🔗 함께 보는 코스
- AI 에이전트 중급: 원리와 설계: 에이전트의 반복 실행과 하네스, 보상 해킹, 프롬프트 캐시를 다룹니다.
- 코딩 에이전트 입문: 도구 선택과 권한 확인, 작은 첫 작업을 다룹니다.
- 클로드 코드 중급: 실무 설정과 운영: 클로드 코드의 설정과 운영을 더 자세히 다룹니다.
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
멀티 에이전트 작업 설계: 메인과 작업자 나누기, 한 작업의 크기
멀티 에이전트 작업 설계는 하나의 목표를 여러 코딩 에이전트에게 맡기기 전에 누가 무엇을 소유하고 어떤 순서로 돌며 결과를 어떻게 합칠지를 정하는 일입니다. 나누는 기준은 파일 담당 범위와 의존 관계, 구체적인 완료 기준입니다.
깃 워크트리(Git Worktree)와 병렬 세션: 작업 폴더 나누고 결과 합치기
깃 워크트리는 한 저장소의 기록을 공유하면서 작업 폴더를 여러 개 두는 기능입니다. 폴더별로 다른 브랜치의 파일을 펼쳐 작업할 수 있지만 통합 충돌과 외부 시스템 접근까지 막지는 않습니다.
작업 명세 쓰기: 대상, 변경, 제약, 소유권, 완료 증거
작업 명세는 이번 작업의 대상, 바꿀 내용, 제약, 수정할 수 있는 범위와 확인할 결과를 적은 지시서입니다. 에이전트가 무엇을 할지와 사람이 결과를 어떻게 확인할지 함께 정합니다.
코딩 에이전트 검수 체계: 자체 검수, 기계 검사, 별도 검수자 나누기
코딩 에이전트 검수 체계는 변경한 결과를 어떤 기준과 자료로 확인하고, 문제가 있으면 누가 수정한 뒤 다시 볼지 정한 절차입니다. 자체 확인, 기계 검사와 별도 검토를 작업의 영향에 맞게 조합합니다.
코딩 에이전트 비용과 토큰 예산: 모델 선택, 캐시, 컨텍스트, 세션 수
코딩 에이전트의 토큰 예산은 작업에 쓸 사용량이나 비용의 범위를 정하고 실제 기록과 비교해 조정하는 계획입니다. 모델, 대화에 넣는 자료, 캐시와 동시 작업 수를 함께 확인합니다.
코딩 에이전트 실패 유형과 대응: 보상 해킹, 범위 이탈, 멈춤, 중복 수정
코딩 에이전트 실패 유형은 요청한 결과와 실제 결과의 차이를 정리하는 분류입니다. 판정 기준 훼손, 범위 이탈, 진전 없는 반복, 중복 수정과 이른 완료 선언 등을 구분하고 기록으로 원인을 확인합니다.
코딩 에이전트 관측과 기록: 무엇을 남기고 어떻게 되짚는지
코딩 에이전트 관측은 에이전트가 무엇을 읽고 실행하고 바꿨는지, 얼마를 썼는지를 기록으로 남겨 나중에 되짚을 수 있게 하는 운영 방식입니다. 도구가 자동으로 남기는 대화 기록과 체크포인트, 사람이 따로 남기는 작업 기록과 비용 기록을 함께 씁니다.
코딩 에이전트를 쓰지 않을 때: 사람이 더 빠른 일, 되돌리기 어려운 일
코딩 에이전트를 쓸지는 요청부터 결과 확인까지 걸리는 시간, 오류의 영향, 복구 방법과 사용할 권한을 함께 보고 정합니다. 직접 처리하거나 일부 단계만 맡기거나 검증을 준비한 뒤 실행하는 방법을 비교합니다.

