빠른 흐름

좋은 요청
Review this branch with parallel subagents.
- one for security risks
- one for test gaps
- one for maintainability
Wait for all agents, then summarize findings with file references.

나누는 기준

subagent는 자동으로 생기지 않고 명시적으로 요청해야 한다

Codex는 기본적으로 모든 작업을 subagent로 자동 분산하지 않습니다. 병렬 작업이 필요하면 "spawn two agents", "delegate this work in parallel", "use one agent per area"처럼 분명히 요청해야 합니다. subagent는 각각 별도 모델과 도구 작업을 수행하므로, 단일 agent보다 토큰과 실행 비용이 늘어납니다.

명시가 필요한 항목
- 몇 개의 agent를 쓸지
- 각 agent가 맡을 범위
- 모든 agent를 기다릴지
- 최종 요약 형식
- 파일 참조나 테스트 결과 포함 여부

병렬화 자체가 목표가 아니라, 서로 독립적으로 조사할 수 있는 축을 나눌 때 효과가 있습니다.

읽기 중심 작업부터 병렬화한다

공식 가이드는 탐색, 테스트 조사, triage, 요약처럼 읽기 중심 작업을 subagent의 시작점으로 권합니다. 각 agent가 서로 다른 파일이나 관점에서 조사한 뒤, main agent가 결과를 모아 판단하면 충돌 위험이 낮습니다.

적합한 분할
- 보안 위험 조사
- 테스트 누락 조사
- 성능 병목 조사
- 문서와 코드 불일치 조사

반대로 여러 agent가 같은 파일을 동시에 수정하는 workflow는 충돌과 조정 비용이 커집니다. 구현 작업은 병렬 조사 후 main agent가 하나의 diff로 정리하는 흐름이 더 안전합니다.

결과 합성 형식을 먼저 정한다

subagent를 여러 개 실행하면 결과가 흩어지기 쉽습니다. 요청 단계에서 "파일 경로와 라인 중심으로 정리", "심각도 순서", "각 agent별 요약 후 통합 결론"처럼 합성 형식을 정해야 검토 가능한 산출물이 됩니다.

최종 요약 형식 예
- Critical / Major / Minor
- 파일 경로와 근거
- 테스트로 확인할 항목
- 실제 수정 후보와 보류 항목 구분

합성 기준이 없으면 병렬 agent가 많은 정보를 가져와도 최종 판단 비용이 커집니다.

선택 기준

주의할 점

subagent에게 모호한 범위를 주면 같은 파일을 반복해서 읽거나 서로 겹치는 결론을 냅니다. "security", "test gaps", "maintainability"처럼 관점을 분명히 나누고, 마지막에는 main agent가 하나의 판단으로 통합하게 해야 합니다.