병렬 세션과 서브에이전트

한 명의 엔지니어가 동시에 여러 작업 흐름을 이끌 수 있습니다.

병렬 세션(parallel session)은 또 다른 완전한 Claude Code 인스턴스로, 자체 Git worktree에서 별도의 작업을 수행합니다. 각 독립적인 세션은 다른 세션에 대해 전혀 알지 못하며, 이들을 조종하는 엔지니어만이 유일한 공통점입니다.

서브에이전트(subagent)는 단일 세션 내에서 실행되는 범위가 한정된 도우미로, 자체 컨텍스트 윈도우와 도구 제한을 가지며, 앱이 예상대로 실행되는지 확인하는 것처럼 여러 작업에서 반복되는 업무에 적합합니다.

병렬 세션은 엔지니어가 동시에 진행할 수 있는 작업 수를 늘려주며, 서브에이전트는 각 세션이 자신의 작업에 집중하도록 유지합니다. 엔지니어의 역할은 이 모든 것을 조종하고 검토하는 것입니다.

달라지는 점

시작하기

• 전제 조건: CLAUDE.md — 모든 세션이 이 파일을 읽기 때문입니다. 피드백 루프(3단계: 빌드)도 여기서 도움이 되는데, 세션이 스스로 작업을 검증할 수 있으면 엔지니어의 감독이 덜 필요하기 때문입니다.
• 인프라: Git 저장소 — 격리는 worktree에서 비롯되기 때문입니다. 그리고 조직이 안전하다고 판단하는 명령에 대해 세션이 승인 프롬프트를 기다리지 않도록 조정된 권한 설정이 필요합니다.

실행 방법

1. 엔지니어는 작업을 서로 다른 파일을 다루는 작업 단위로 나누며, 플랜 모드 플레이(3단계: 빌드)의 계획을 활용해 작업이 독립적인 부분을 파악합니다. 파일을 공유하는 작업은 하나의 세션에서 순차적으로 실행합니다.
2. 각 병렬 작업은 자체 worktree를 가지며, 예를 들어 한 터미널에서는 claude --worktree feature-auth, 다른 터미널에서는 claude --worktree fix-rate-limit를 실행합니다. worktree는 자체 브랜치를 가진 별도의 체크아웃으로, 세션 간 파일 충돌을 방지합니다.
3. 두세 개의 세션이 합리적인 시작점입니다. 실질적인 상한선은 한 사람이 제대로 검토할 수 있는 흐름의 수이므로, 검토가 따라갈 수 있는 동안에만 세션을 추가하세요.
4. 반복되는 업무를 서브에이전트로 전환하세요. 이는 .claude/agents/의 Markdown 파일에 정의되며, 각각 이름, 사용 시점에 대한 설명, 그리고 접근 가능한 도구를 가집니다. 예를 들어 메인 에이전트가 끝난 후 불필요한 복잡성을 제거하는 코드 단순화 에이전트, 앱을 실행하고 동작을 확인하는 검증 에이전트, 메인 컨텍스트를 채우지 않으면서 코드베이스를 탐색하고 보고하는 리서치 에이전트 등이 있습니다. 팀 전체가 공유할 수 있도록 정의를 Git에 커밋하세요.

실제 모습

.claude/agents/verifier.md:

---

name: verifier
description: Runs the app and checks the change works before the session reports done
tools: Bash, Read

---
Start the app with make run. Exercise the changed behavior and the two
nearest neighboring flows. Report what you ran, what you saw, and any
behavior that does not match plan.md. Do not fix anything; report only.

거버넌스 고려 사항

세션이 많아질수록 산출물도 많아지므로, 통제는 저장소 내 설정에서 비롯되어야 합니다. 그곳의 훅과 권한 설정은 모든 세션에 적용되며, 세션이 수행하는 작업은 기록되어 이를 실행한 엔지니어에게 귀속됩니다.

측정 방법

• 선행 지표: 리뷰 품질이 유지되는 동안 엔지니어당 동시 세션 수(OpenTelemetry 내보내기에서 집계) 및 대기가 아닌 조종에 소비된 하루 중 비율.
• 후행 지표: 엔지니어당 주간 병합된 변경 건수를, PR 이력에 따라 산출된 재작업률과 함께 살펴봅니다.