| name | dev-agent-orchestration |
| description | SDK V2 Session API 기반 에이전트 오케스트레이션 패턴. layer2 코드 구현 시 참조. |
에이전트 오케스트레이션
adev의 2계층은 Claude Agent SDK V2 Session API를 사용하여 에이전트를 실행한다.
핵심 패턴
unstable_v2_createSession()으로 세션 생성 → session.stream()으로 실행 + hooks로 모니터링.
Phase별 실행 방식이 다르다:
- DESIGN: session.stream() 1개 + Agent Teams env 활성화 (팀 토론)
- CODE: unstable_v2_prompt() ×N 동시 (Promise.all)
- TEST/VERIFY: unstable_v2_prompt() 순차
필수 옵션
{
settingSources: [],
permissionMode: 'bypassPermissions',
env: { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" },
allowedTools: ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'],
}
Hook 기반 모니터링
const hooks = {
preToolUse: async (event) => { },
postToolUse: async (event) => { },
teammateIdle: async (event) => { },
};
상세 패턴: references/v2-session-pattern.md
알려진 이슈: references/known-issues.md