Multi-Agent Orchestration: Dynamic Workflows

Dynamic Workflows의 핵심은 오케스트레이션 로직을 JavaScript로 표현한다는 것이다.

export const meta = {
  name: 'parallel-review',
  description: 'PR을 여러 관점에서 병렬 리뷰',
}

const DIMENSIONS = [
  { key: 'bugs', prompt: '버그와 로직 오류를 찾아라' },
  { key: 'security', prompt: '보안 취약점을 찾아라' },
  { key: 'perf', prompt: '성능 문제를 찾아라' },
]

// 세 에이전트가 동시에 실행됨
const results = await parallel(
  DIMENSIONS.map(d => () =>
    agent(d.prompt, { label: `review:${d.key}`, schema: FINDINGS_SCHEMA })
  )
)

parallel() 함수로 여러 에이전트가 동시에 실행된다. agent() 함수로 각 서브에이전트를 스폰한다. schema를 지정하면 에이전트가 구조화된 JSON을 반환한다.

규모: 한 워크플로우에서 최대 16개 동시 실행, 세션당 최대 1,000개 에이전트.

가장 강력한 멀티에이전트 패턴은 역할 분리다:

리드 에이전트: 전체 작업을 이해하고 분해한다. 각 스페셜리스트에게 구체적인 서브태스크를 할당한다.

스페셜리스트 에이전트: 하나의 구체적인 문제에만 집중한다. 자신만의 컨텍스트 윈도우, 도구, 모델을 가진다.

// 리드 에이전트가 작업 분해
const tasks = await agent(
  '이 코드베이스의 버그를 찾아 태스크 목록으로 반환하라',
  { schema: TASKS_SCHEMA }
)

// 각 버그를 독립적인 스페셜리스트가 처리
const fixes = await pipeline(
  tasks,
  task => agent(
    `이 버그를 수정하라: ${task.description}`,
    { isolation: 'worktree' }  // 격리된 git worktree에서 실행
  )
)

해외 고수들의 실제 패턴: Claude가 계획/분해를 담당하고, 특정 전문 모델(또는 같은 Claude의 다른 인스턴스)이 독립적으로 구현한다. 세 번째 에이전트가 각 결과를 검증한다. 이 파이프라인은 한 에이전트가 모든 것을 하는 것보다 결과 품질이 현저히 높다.

여러 에이전트가 같은 파일을 동시에 수정하면 충돌이 발생한다. isolation: 'worktree' 옵션이 이 문제를 해결한다.

const results = await parallel(
  bugList.map(bug => () =>
    agent(
      `이 버그를 수정하라: ${bug.description}`,
      {
        isolation: 'worktree',  // 각 에이전트는 독립된 git 브랜치에서 작업
        label: `fix:${bug.id}`
      }
    )
  )
)

isolation: 'worktree'를 설정하면 에이전트마다 별도의 git worktree(격리된 작업 디렉토리)가 생성된다. 에이전트들은 서로의 작업에 방해받지 않고 병렬로 파일을 수정할 수 있다.

에이전트가 변경을 만들지 않으면 worktree는 자동으로 정리된다. 성공한 에이전트의 변경은 각자의 브랜치에 담기며, 이후 사람이 리뷰하고 머지를 결정할 수 있다.

비용 주의: Worktree 격리는 ~200-500ms 설정 시간 + 디스크 공간이 필요하다. 에이전트가 실제로 파일을 수정해야 하는 경우에만 사용하고, 읽기 전용 분석에는 격리 없이 실행하라.

2026년 커뮤니티에서 주목받은 패턴 중 하나는 '계획은 Claude, 리뷰는 다른 AI'다.

왜 이것이 효과적인가: 같은 모델이 계획하고 구현하면, 자신의 blind spot을 자신이 리뷰할 때 놓치기 쉽다. 다른 모델(또는 다른 관점으로 설정된 같은 모델)이 독립적으로 리뷰하면 발견율이 높아진다.

// 1단계: Claude가 구현 계획 수립
phase('Plan')
const plan = await agent(
  '이 기능을 구현할 상세 계획을 작성하라',
  { schema: PLAN_SCHEMA }
)

// 2단계: 계획 기반 구현
phase('Implement')
const implementation = await agent(
  `이 계획을 구현하라:\n${plan.steps.join('\n')}`,
  { isolation: 'worktree' }
)

// 3단계: 독립적 검증 (다른 관점)
phase('Verify')
const verification = await parallel(
  ['correctness', 'security', 'edge-cases'].map(lens => () =>
    agent(
      `${lens} 관점에서 이 구현을 검증하라. 실패를 찾아내려 시도하라.`,
      { schema: VERDICT_SCHEMA }
    )
  )
)

세 가지 관점의 검증 에이전트를 동시에 실행하면, 단일 리뷰어보다 문제 발견율이 높아진다.