에이전트 오케스트레이션

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() 순차

필수 옵션

typescript
1{
2  settingSources: [],              // 파일시스템 설정 의존 없음
3  permissionMode: 'bypassPermissions',  // 자율 운영
4  env: { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" },  // DESIGN에서만
5  allowedTools: ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'],
6}

Hook 기반 모니터링

typescript
1const hooks = {
2  preToolUse: async (event) => { /* 도구 호출 전 검증 */ },
3  postToolUse: async (event) => { /* 도구 호출 후 기록 */ },
4  teammateIdle: async (event) => { /* 팀원 유휴 감지 */ },
5};

상세 패턴: references/v2-session-pattern.md 알려진 이슈: references/known-issues.md