Claude Code 서브에이전트와 동적 워크플로 비교: 변경 파일 검토는 어떻게 나눌까

TL;DR

핵심 3줄 요약

이 글에서 다룰 내용

서브에이전트와 동적 워크플로의 차이

언제 어느 경로를 고를까

한정된 옆조사의 요약을 받고 다음 질문을 상황에 맞게 정하면 A가 적합합니다. 승인 목록의 항목별 검토→독립 대조→전체 취합 순서를 스크립트로 확인할 필요가 있다면 B를 고려합니다.

이 기준은 공식 기능 비교를 검토 업무에 적용한 것입니다. 파일이 많다는 이유만으로 B를 택하지 않습니다. 특정 개수를 제품 선택 임계치로 삼지도 않습니다.

첫 실습은 한 경로만 진행합니다. 둘 다 필요 없으면 일반 세션을 유지합니다. A에서 B로 자동 전환되거나 결과가 자동 동기화된다고 가정하지 않습니다.

시작 전 확인할 조건

범위는 이미 사용이 허용된 본인의 대화형 로컬 터미널 한 세션입니다. 기존 manual 권한 모드는 유지합니다. 비민감 검토사본만 사용합니다.

공식 문서는 동적 워크플로의 모든 유료 플랜·Anthropic API·지정 클라우드 공급자 지원을 안내합니다. 여기서는 유료 구독의 이미 활성화된 로컬 세션만 다룹니다. Pro는 별도 활성화가 필요할 수 있습니다.

Pro에서는 설정의 Dynamic workflows 행 상태를 확인합니다. 이 글에서 토글을 변경하지 않습니다. 보이지 않으면 보류하고 현재 문서·계정·설치 화면·조직 정책을 확인합니다. B의 조건을 A에도 그대로 적용하지 않습니다.

새 설치·인증·권한 승격·회사 실데이터·클라우드 실행은 제외합니다. 실제 Claude Code에서 실행한 후기는 아닙니다.

변경 파일 검토를 나누는 순서

1. 검토 목록·근거와 승인 범위를 고정합니다

교육용 가상 자료는 DOC-A인 guide.md 초안, DOC-B인 expected.txt 의 승인된 기대 문장, DOC-C인 observed.txt 의 사람이 기록한 관측입니다. 실제 프로젝트나 명령 실행 결과는 아닙니다. 세 파일이라는 수는 제품 경계값이 아닙니다.

가상 기대 문장은 ‘빈 입력이면 확인 필요로 표시’이지만 관측은 누락된 상황으로 둡니다. 초안의 요약이 ‘통과’라고 해도 관측 누락은 확인 필요로 남깁니다.

실제 검토에서는 요구사항·허용 목록·원본과 사본·기존 권한부터 확인합니다.

2. 조정 요건으로 A 또는 B를 선택합니다

결과를 보고 사람이 다음 질문을 정하면 충분한지, 동일 기준 검토와 독립 대조의 순서까지 확인해야 하는지 판단합니다. A를 고르면 4단계를, B를 고르면 3단계를 건너뜁니다.

선택 이유와 정확한 입력 목록을 남깁니다. AI가 범위를 보고 임의로 다른 구조를 시작하도록 맡기지 않습니다.

3. A 선택 때만 읽기 전용 서브에이전트에 위임합니다

“서브에이전트로 허용된 세 파일만 읽고, 주장과 증거의 대조 요약·근거 위치·미확인 사항을 돌려주세요”라고 요청합니다. 필요한 맥락을 명시하고 메인 대화나 모든 이력에 자동 접근한다고 가정하지 않습니다.

실제 서브에이전트 사용 여부와 접근 범위를 세션 기록으로 확인합니다. 관측되지 않으면 ‘A 실행 확인 필요’로 남깁니다. 다음 행동은 메인 대화에서 사람이 결정합니다.

4. B 선택 때만 워크플로와 사전 승인을 요청합니다

사람이 직접 입력하는 요청에 use a workflow를 넣습니다. 허용 항목별 검토·독립 대조·원목록과 결과의 재조정·하나의 내부 요약을 요청합니다. 기존 manual CLI의 계획 승인에서 View raw script로 목록·분기·예외·도구·권한·큰 호출 범위를 확인합니다.

의도한 범위가 아니면 No로 취소합니다. Yes, run it은 이번 한 실행의 허용이지 조직의 최종 승인은 아닙니다. 스크립트나 비용을 판단하기 어려우면 B를 보류합니다.

실행 상태는 현재 제품의 작업 영역에서 관찰합니다. 첫 실습에서는 저장 명령·재실행·전역 설정·무인 예약을 진행하지 않습니다.

5. 원목록·모든 결과·미검증을 전수 대조합니다

공식 agent() 는 중단이나 복구 불가 API 오류 때 null 을 반환할 수 있습니다. pipeline() 은 그 자리를 결과에 유지합니다.

따라서 빈 결과를 ‘문제없음’으로 버리지 않고 원목록의 모든 ID와 대응시킵니다.

실패·미검증·누락은 모두 확인 필요로 남깁니다. 어떤 자료를 읽었는지 확인할 수 없는 결과도 같습니다. 이는 이 글의 내부 기록 분류이지 제품의 고유 상태값은 아닙니다. 지적 사항이 없다는 것과 전체 검토가 끝났다는 것도 다릅니다.

독립 검증자가 동의해도 사람이 근거 원문을 검수합니다. 불일치나 부정적인 개별 결과는 요약에 묻히지 않도록 해당 위치로 돌아가 확인합니다.

6. 내부 검토 기록을 사람이 승인합니다

선택 이유, 정확한 입력 목록, 조정 계획 또는 스크립트 위치, 실제 관측, 확인 완료·상충·확인 필요, 검토자와 승인자를 남깁니다. 공개 글에는 스크립트의 실제 경로 대신 승인된 내부 별칭만 사용합니다.

모델 응답을 실행 로그 대신 쓰지 않습니다. 내부 검토 기록의 승인은 파일 저장·공유·병합·배포와 분리합니다. 후속 조치는 별도 승인으로 처리합니다.

복사해서 쓰는 프롬프트

아래 일곱 필드에서 A 또는 B를 사람이 먼저 선택합니다. B를 택했을 때만 목표 줄에 use a workflow를 직접 추가합니다.

실전 인사이트

주의할 점

자주 묻는 질문

출처

마무리

목표는 근거를 추적할 수 있는 변경 파일 검토 기록입니다. 완전한 버그 검출이나 통계적 성능 검증을 뜻하지 않습니다.

조건이 충족되지 않으면 보류합니다. 운영 적용은 별도 승인으로 남깁니다.

한 줄 요약: 한 경로만 선택합니다. 모든 입력과 결과를 사람이 대조한 뒤 검토 기록을 승인합니다.