Claude Dynamic Workflows
MadoHub이 Claude Code 자체의 병렬 서브에이전트 기능을 어떻게 감지하고, 시각화하고, 다루는지 설명합니다.
Dynamic Workflows는 Claude Code 자체의 리서치 프리뷰 기능입니다 — MadoHub이 만든 것이 아니라 Anthropic의 자체 멀티 에이전트 오케스트레이션 메커니즘입니다. Claude Code는 하나의 세션을 동일한 문제를 다루는 여러 동시 서브에이전트로 펼칠 수 있습니다.
MadoHub은 그 위에 호환성 계층을 제공합니다. MadoHub은 이 서브에이전트를 생성하거나 실행하지 않습니다 — 감지하고, 워크플로가 실행되는 동안 자체 에이전트 상태 모델을 정확하게 유지하며, 단순한 연동이라면 쏟아질 노이즈 없이 진행 상황을 볼 수 있게 해줍니다. 이 계층이 없다면 서브에이전트 65개를 띄운 워크플로는 한 타일에 완료 배지 65개가 쌓이고, 각각을 개별적으로 닫아야 하는 상황이 됩니다.
Dynamic Workflows는 Claude Code 세션 안에서 프롬프트에 ultracode를 입력하거나, /effort ultracode를 실행하거나, Pro 플랜에서 /config의 Workflows 토글을 켜는 것으로 진입합니다. 최신 Claude Code 버전이 필요하며, 자연어 트리거는 더 새로운 버전이 필요합니다.
MadoHub이 하는 일
- 워크플로가 실행 중인지 감지 — Claude Code 타일에서 서브에이전트 이벤트를 서브에이전트마다 하나의 배지가 아니라 타일당 하나의 진행 카운터로 합산합니다.
- 세 곳에서 진행 표시 — Context Gauge의 active 인디케이터(작은 펄스 닷)가 타일에 켜지고, Fleet 패널이 행 아래에
workflow · 3/5 agents라인을 보여주며, Context Gauge 툴팁이 합산된 워크플로 토큰 수치를 보여줍니다. - 워크플로 토큰 사용량을 메인 게이지 퍼센트와 분리 — 서브에이전트는 메인 세션 윈도우가 아닌 자신만의 컨텍스트에서 실행되므로, 토큰 사용량이 메인 세션의 채움과 분리되어 추적됩니다.
- 같은 타일에서 새 실행이 시작되면 카운터 초기화 — 두 번째 워크플로가 첫 번째의 집계를 이어받지 않습니다.
사용 방법
MadoHub의 호환성 계층을 직접 "사용"하는 것이 아니라 — Claude Code 타일 안에서 Claude Code의 Dynamic Workflows 기능을 사용하면 MadoHub이 진행 상황을 자동으로 보여줍니다.
- Claude Code 타일을 열고 세션 안에서 워크플로를 트리거합니다(
ultracode입력,/effort ultracode실행, 또는/config의 Workflows 토글 켜기). - 워크플로가 실행되는 동안 타일의 Context Gauge active 인디케이터가 켜지는 것을 확인합니다.
- Fleet 패널에서 해당 타일 행 아래의
workflow · {done}/{seen} agents라인으로 타일까지 날아가지 않고 펼침 진행을 확인합니다. - 타일의 Context Gauge를 호버하면 메인 퍼센트와 분리되어 합산된 워크플로 토큰 수치가 표시됩니다.
- 워크플로가 끝나면 active 인디케이터가 꺼지고 진행 라인이 자동으로 사라집니다.
Claude 자체의 제한
이는 MadoHub이 아니라 Claude Code의 제한이며, MadoHub은 변경할 수 없습니다:
| 제한 | 값 |
|---|---|
| 최대 동시 서브에이전트 | 16(CPU가 제한된 머신에서는 더 적음) |
| 실행당 최대 서브에이전트 | 1,000 |
| 실행 중 사용자 입력 | 받지 않음 — 권한 프롬프트만 실행을 일시정지할 수 있음 |
일반적인 사용 사례
- "큰 리서치 작업을 여러 서브에이전트에 걸쳐 실행" — Claude Code 안에서 워크플로를 트리거하고 자리를 떠나지 않고 Fleet 패널에서 펼침 진행을 지켜봅니다.
- "저 워크플로가 아직 활성인가?" — Context Gauge의 펄스 닷과 툴팁의
(active)접미사가 한눈에 알려줍니다. - "워크플로가 토큰을 얼마나 소모하고 있나?" — Context Gauge를 호버하세요. 워크플로 토큰 수치가 메인 세션의 채움과 분리되어 표시됩니다.
팁과 모범 사례
- 타일까지 날아가는 대신 Fleet 패널의
workflow · {done}/{seen} agents라인으로 펼침 진행을 확인하세요 — 호환성 계층의 핵심 목적은 서브에이전트별 배지에 빠져드는 것을 막는 것입니다. - 워크플로 토큰 수치는 메인 게이지 퍼센트와 의도적으로 분리되어 추적됩니다. "총 컨텍스트"를 추정하려고 둘을 더하지 마세요 — 서브에이전트는 자신만의 컨텍스트에서 실행됩니다.
- 막 시작된 워크플로는 첫 usage 블록이 떨어지기 전에 토큰이 0인 활성 상태로 표시될 수 있습니다. 잠시 기다려 주세요.
- 워크플로가 끝나면 Claude Code이 권위 있는 합계를 기록합니다. MadoHub은 서브에이전트 파일을 다시 합산하지 않고 그 값을 읽으므로, 실행 중 수치보다 최종 수치가 더 정확합니다.
관련 기능
- Context Gauge — active 인디케이터와 툴팁이 워크플로 진행을 보여주는 타일별 채움 막대입니다.
- Fleet — 행별로
workflow · {done}/{seen} agents를 보여주는 패널입니다. - MadoAgent — MadoHub 자체의 멀티 에이전트 패턴(Ensemble Exploration, Orchestrator Mode)용입니다.
제한 사항
- Dynamic Workflows는 Claude Code의 리서치 프리뷰 기능입니다. MadoHub은 이를 감지하고 시각화할 뿐, 구현하지 않습니다.
- MadoHub이 여기서 읽는 모든 것은 공개된 계약이 아니라 Claude Code이 자체 목적을 위해 기록한 관찰된 동작입니다. Anthropic은 이 기능이 리서치 프리뷰를 벗어남에 따라 사전 고지 없이 형식을 바꿀 수 있습니다.
- 워크플로가 실행 중일 때는 사용자 입력이 받아들여지지 않습니다 — 권한 프롬프트만 실행을 일시정지할 수 있습니다. 트리거하기 전에 그에 맞춰 계획하세요.