MadoHub Docs

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이 진행 상황을 자동으로 보여줍니다.

  1. Claude Code 타일을 열고 세션 안에서 워크플로를 트리거합니다(ultracode 입력, /effort ultracode 실행, 또는 /config의 Workflows 토글 켜기).
  2. 워크플로가 실행되는 동안 타일의 Context Gauge active 인디케이터가 켜지는 것을 확인합니다.
  3. Fleet 패널에서 해당 타일 행 아래의 workflow · {done}/{seen} agents 라인으로 타일까지 날아가지 않고 펼침 진행을 확인합니다.
  4. 타일의 Context Gauge를 호버하면 메인 퍼센트와 분리되어 합산된 워크플로 토큰 수치가 표시됩니다.
  5. 워크플로가 끝나면 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은 이 기능이 리서치 프리뷰를 벗어남에 따라 사전 고지 없이 형식을 바꿀 수 있습니다.
  • 워크플로가 실행 중일 때는 사용자 입력이 받아들여지지 않습니다 — 권한 프롬프트만 실행을 일시정지할 수 있습니다. 트리거하기 전에 그에 맞춰 계획하세요.

On this page