SDK V2 Session API 기반 에이전트 오케스트레이션 패턴. layer2 코드 구현 시 참조.
npx skills add https://github.com/uygnoey/autonomous-dev-agent-ts --skill dev-agent-orchestration이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
코드 품질 기준, Result 패턴, 에러 처리, 리뷰 체크리스트. 모든 코드 작성 시 참조.
Claude AI assistant API for text generation, analysis, conversation, streaming, tool use, vision, and batch processing
7개 에이전트 역할, Phase FSM, Coder×N Git branch, documenter 이벤트 트리거. layer2 구현 시 참조.
LanceDB 벡터 DB, 4-Provider Tier 임베딩, 코드 인덱싱. rag 모듈 구현 시 참조.
Fail-Fast 원칙, 계단식 통합 검증, 테스트 수량. 테스트 관련 코드 구현 시 참조.
| 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별 실행 방식이 다르다:
{
settingSources: [], // 파일시스템 설정 의존 없음
permissionMode: 'bypassPermissions', // 자율 운영
env: { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }, // DESIGN에서만
allowedTools: ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'],
}
const hooks = {
preToolUse: async (event) => { /* 도구 호출 전 검증 */ },
postToolUse: async (event) => { /* 도구 호출 후 기록 */ },
teammateIdle: async (event) => { /* 팀원 유휴 감지 */ },
};
상세 패턴: references/v2-session-pattern.md
알려진 이슈: references/known-issues.md