dispatching-parallel-agentslisted

# dispatching-parallel-agents 서브에이전트에 격리된 컨텍스트로 작업을 위임한다. 지시와 컨텍스트를 정밀하게 구성해 그들이 초점을 잃지 않게 한다. 그들은 세션 히스토리를 상속받지 않는다. 필요한 것만 구성해 준다. 이렇게 하면 조율에 쓸 자기 컨텍스트도 지킨다. 무관한 실패가 여럿일 때(다른 테스트 파일, 다른 서브시스템, 다른 버그) 순차 조사는 시간을 버린다. 각 조사가 독립이라 동시에 진행할 수 있다. **핵심 원칙**: 독립적인 문제 영역마다 에이전트 하나를 디스패치한다. 동시에 일하게 둔다. **입력**은 지금 손에 있는 실패 목록이다. 테스�� 출력이나 에러 로그에서 뽑고, 아래 「1. 독립 영역을 식별한다」로 영역을 가른다. 영역이 하나로 묶이면 이 스킬을 쓰지 않는다. **주체**는 에이전트를 띄우는 조율자다. 디스패치되는 서브에이전트는 이 문서를 읽지 않는다. **출력**은 통합된 수���과 전체 테스트 스위트 통과다. 아래 「검증」을 통과하면 끝이다. ## 적용 판단 **쓴다**: - 테스트 파일 둘 이상이 각각 다른 근본 원인으로 실패한다 - 여러 서브시스템이 독립적으로 깨졌다 - 각 문제를 다른 문제의 맥락 없이 이해할 수 있다 - 조사 사이에 공유 상태가 없다 **쓰지 않는다**: - 실패가 서로 연관돼 있다(하나를 고치면 다른 것도 고쳐질 수 있다) - 전체 시스템 상태를 이해해야 한다 - 에이전트끼리 간섭한다(같은 파일 편집, 같은 자원 사용) - 무엇이 깨졌는지 아직 모른다(탐색적 디버깅) 구현 태스크에는 쓰지 않는다. 구현자를 병렬로 띄우면 충돌한다. 플랜 실행의 동시성 규율은 `groundwork:subagent-driven-development`가 기준 문서다. ## 패턴 ### 1. 독립 영역을 식별한다 무엇이 깨졌는지로 실패를 묶는다. 아래는 이 문서 전체가 쓰는 예시다. - `tool-approval-race-conditions.test.ts`: 도구 승인 흐름 - `batch-completion-behavior.test.ts`: 배치 완료 동작 - `agent-tool-abort.test.ts`: 중단 기능 각 영역이 독립이다. 도구 승인을 고쳐도 중단 테스트에 영향이 없다. ### 2. 초점 잡힌 에이전트 태스크를 만든다 에이전트마다 다음을 준다. 이 목록이 프롬프트 구성의 정본이고, 아래 「에이전트 프롬프트 구조」는 이것을 채운 예시다. - **구체적 범위**: 테스트 파일 하나 또는 서브시스템 하나 - **명확한 목표**: 이 테스트들을 통과시킨다 - **자기완결 컨텍스트**: 그 문제를 이해하는 데 필요한 에러 메시지·테스트 이름. 세션 히스토리는 넣지 않는다 - **제약**: 다른 코드를 바꾸지 않는다 - **기대 출력**: 무엇을 발견하고 무엇을 고쳤는지 요약 ### 3. 병렬로 디스패치한다 식별한 영역마다 디스패치 하나를, 전부 **한 응답 안에서** 발행한다. 그래야 동시에 돈다. ```text 서브에이전트 (general