Claude Code 다이나믹 워크플로우 핵심 정리

Claude Code 다이나믹 워크플로우 — 작업별 맞춤 하니스 생성

Claude Code 다이나믹 워크플로우 핵심 정리

Anthropic의 Claude Code 팀이 2026년 6월, 에이전트 오케스트레이션의 새로운 패러다임인 다이나믹 워크플로우(Dynamic Workflows) 기능을 공개했습니다. 이번 글에서는 이 기능의 도입 배경, 작동 원리, 대표 패턴, 그리고 실전 활용 사례까지 한 번에 정리합니다.

다이나믹 워크플로우란 무엇인가

다이나믹 워크플로우는 Claude가 작업에 맞춰 즉석에서 자체적인 하니스(harness)를 JavaScript 파일 형태로 직접 작성해 여러 서브에이전트를 조율하는 방식입니다. 기존 Claude Code의 기본 하니스는 일반적인 코딩 작업에 최적화되어 있지만, 장시간·대규모 병렬·적대적 검증이 필요한 작업에서는 한계가 있었습니다. 다이나믹 워크플로우는 바로 그 한계를 메우기 위해 도입되었습니다.

도입 배경 — 단일 컨텍스트의 세 가지 실패 모드

기존 방식은 하나의 컨텍스트 창에서 계획과 실행을 동시에 진행합니다. 이 구조에서 반복적으로 나타나는 세 가지 실패 모드가 있습니다.

• 에이전틱 게으름(agentic laziness): 작업을 절반쯤 진행한 뒤 "끝났다"고 선언하는 현상

• 자기 선호 편향(self-preferential bias): 자신의 결과물을 우호적으로 평가하는 경향

• 목표 표류(goal drift): 컨텍스트 압축 과정에서 원래 목표가 흐려지는 현상

다이나믹 워크플로우는 컨텍스트를 분리한 다수의 서브에이전트가 각자의 목표에 집중하도록 만들어 이 세 가지 문제를 구조적으로 줄입니다.

작동 방식

다이나믹 워크플로우는 JavaScript 파일을 실행해 서브에이전트를 생성·조율합니다. JSON, Math, Array 등 표준 라이브러리 함수를 활용할 수 있고, 각 서브에이전트의 모델 종류(Sonnet, Opus 등)와 워크트리(worktree) 격리 여부도 워크플로가 직접 결정합니다.

호출 방법은 두 가지입니다.

1. Claude에게 "워크플로를 만들어줘"라고 자연어로 요청

2. 트리거 단어 "ultracode" 사용

중단된 세션은 그대로 재개할 수 있고, "use 10k tokens" 같은 토큰 예산 지정, "s" 키로 ~/.claude/workflows 디렉터리에 저장 후 스킬로 공유하는 등 운영 측면의 기능도 갖춰져 있습니다.

대표 패턴 6가지

1. 분류 후 라우팅 (Classify and Route)

분류기 에이전트가 작업 유형을 판별한 뒤, 유형에 맞는 에이전트나 처리 흐름으로 분기시킵니다. 파이프라인의 마지막 단계에서 결과 분류용으로도 자주 사용됩니다.

2. 팬아웃과 합성 (Fan-out and Synthesize)

큰 작업을 작은 단위로 쪼개 각 단위마다 별도 에이전트를 돌린 뒤, 합성 단계에서 모든 결과를 하나로 병합합니다. 깨끗한 컨텍스트가 필요한 다수의 소단위 작업에 적합한 패턴입니다.

3. 적대적 검증 (Adversarial Verification)

각 작업 에이전트마다 별도의 검증 에이전트를 붙여 루브릭(rubric, 평가 기준표)에 따라 결과를 반박·검증하게 합니다. 단순 자기 평가의 한계를 우회하는 효과적인 방법입니다.

4. 생성 후 필터링 (Generate and Filter)

다수의 아이디어를 생성한 뒤 루브릭과 검증으로 거르고 중복을 제거해 최고 품질의 후보만 남깁니다. 디자인이나 네이밍처럼 취향이 개입되는 작업에서 특히 유용합니다.

5. 토너먼트 (Tournament)

동일 작업을 서로 다른 접근법으로 N개 에이전트가 경쟁 수행하고, 심판 에이전트가 쌍대 비교(pairwise comparison) 로 우승자를 가립니다. 쌍대 비교는 절대 점수 평가보다 신뢰도가 높다고 알려져 있습니다.

6. 수렴까지 반복 (Loop Until Convergence)

작업량이 미리 정해지지 않은 경우, 새로운 발견이나 오류가 더 이상 없을 때까지 에이전트 생성을 반복합니다. 탐색적 작업에 적합합니다.

실전 활용 사례

대규모 리팩토링과 마이그레이션

콜사이트, 실패 테스트, 모듈 단위로 작업을 쪼개 워크트리마다 서브에이전트가 수정하고, 또 다른 에이전트가 적대적으로 리뷰한 후 병합합니다. 실제로 Zig에서 Rust로 코드를 재작성한 사례가 공개되었으며, "리소스 집약적 명령을 피하라"는 지시를 함께 주면 병렬성을 극대화할 수 있습니다.

딥 리서치

웹 검색을 팬아웃해 소스를 수집하고, 적대적 검증으로 주장을 확인한 뒤 인용이 달린 보고서로 합성합니다. /deep-research 스킬로 패키지화되어 있어 바로 활용할 수 있습니다.

사실 확인 (Fact-Checking)

보고서 안의 모든 사실 주장을 식별하는 에이전트가 먼저 돌고, 각 주장마다 검증 서브에이전트가 출처를 확인하며, 별도 검증 에이전트가 출처 품질까지 평가합니다. 3단계 파이프라인으로 허위 정보를 체계적으로 걸러냅니다.

정성적 정렬과 랭킹

1000행 이상의 지원 티켓을 심각도순으로 정렬하는 것처럼 한 번에 처리하기 어려운 작업을, 토너먼트형 쌍대 비교 파이프라인이나 버킷 분할 병렬 처리 후 병합으로 해결합니다.

간헐적 실패 디버깅과 사후 분석

로그·파일·데이터별로 독립 에이전트가 서로 분리된 증거로부터 가설을 세우고, 검증자·반박자 패널이 각 가설을 평가합니다. 코드뿐 아니라 매출 하락 원인 분석, 데이터 파이프라인 장애 분석 등에도 그대로 응용 가능합니다.

장점과 주의점

장점

• 컨텍스트 분리로 게으름·자기 선호·목표 표류 문제를 구조적으로 감소

• 세션 재개, 토큰 예산 지정, /goal·/loop와의 결합 등 운영 기능 내장

• ~/.claude/workflows 디렉터리 또는 스킬을 통한 재사용과 공유

주의점

• 토큰 사용량이 크게 늘어날 수 있어 모든 작업에 적합하지는 않음

• 일반적인 코딩 작업에 다섯 명의 리뷰어 패널이 필요 없다는 점을 저자도 분명히 짚고 있음

• "정말 더 많은 연산이 필요한가"를 스스로 묻고 사용할 것

• 모범 사례는 아직 형성 중인 단계

기존 방식과의 차별점

기존 Claude Agent SDK나 claude -p로 만드는 정적(static) 워크플로는 일반화된 처리를 위해 범용적으로 작성되어야 합니다. 반면 다이나믹 워크플로는 Claude가 그때그때 맞춤형 하니스를 즉석에서 작성한다는 점에서 근본적으로 다릅니다. 정적 파이프라인과 자율 에이전트 사이의 중간 지점을 노린 접근으로, 장시간 구조적 작업에서 효과가 두드러집니다.

적용 가이드 — 언제 쓰고 언제 안 쓰는가

다이나믹 워크플로우가 잘 맞는 작업은 다음과 같습니다.

• 장시간 실행이 필요한 작업: 단순 1회 코딩이 아닌 마이그레이션, 리팩토링, 대규모 분석

• 다수의 독립적 하위 작업으로 분할 가능한 작업: 팬아웃 후 병합이 가능한 구조

• 검증·비평이 필요한 작업: 자기 평가의 편향을 줄이고 싶을 때

• 다양한 접근법 비교가 필요한 작업: 토너먼트나 생성 후 필터링으로 최선의 답을 찾고 싶을 때

반면 다음과 같은 작업에는 기존 방식이 더 효율적입니다.

• 간단한 1회성 작업: 파일 하나 수정, 함수 하나 추가 등

• 빠른 응답이 필요한 작업: 토큰 비용과 시간이 부담되는 상황

• 명확한 단일 정답이 있는 작업: 적대적 검증이 불필요한 경우

결론

다이나믹 워크플로우는 Claude Code를 단일 코딩 도우미에서 다수 에이전트를 조율하는 메타 오케스트레이터로 확장하는 변화입니다. 코드 마이그레이션·딥 리서치·트리아지·사후 분석 같은 장시간 구조적 작업에서 효과를 발휘하며, 토큰 비용과 모범 사례 정립이라는 과제를 안고 있기에 "퀵 워크플로"부터 작게 시작해 점진적으로 적용 범위를 넓혀가는 전략이 권장됩니다.

---

📚 출처

• Anthropic Claude Code — A harness for every task: dynamic workflows (GeekNews)

---

📚 출처

• https://news.hada.io/topic?id=30144