MadoHub Docs

Agent 라우팅

지능형 변환을 통해 AI 에이전트 간에 출력과 컨텍스트를 자동으로 전달합니다.

Agent 라우팅은 MadoHub의 핵심 오케스트레이션 엔진입니다. 한 에이전트가 작업을 마치면 MadoHub는 그 결과를 자동으로 캡처하여 구조화된 프롬프트로 변환한 뒤, 다음 에이전트의 작업 영역으로 원활하게 전달하여 자율적인 멀티 에이전트 파이프라인을 구성합니다.

작동 방식

  1. 트리거 (Trigger) — 연결된 소스 타일이 사전 설정된 조건(유휴 감지, 완료 신호, 정규식 일치, 연속 스트리밍)에 따라 라우팅을 활성화합니다.
  2. 추출 (Extract) — MadoHub가 에이전트의 최신 출력을 캡처합니다. Claude Code와 같은 주요 CLI의 경우 터미널 잡음이 배제된 네이티브 세션 추출 기술을 사용합니다.
  3. 변환 (Transform) — 캡처된 출력을 다운스트림 에이전트가 이해할 수 있는 최적화된 프롬프트로 재구성합니다(AI 변환, 템플릿 래핑, 원본 전달).
  4. 전달 (Deliver) — 변환된 프롬프트는 적응형 페이싱 제어를 통해 대상 터미널에 안정적으로 입력되며, 각 에이전트에 맞는 실행 핸드셰이크 프로토콜로 제출됩니다.

고충실도 세션 캡처 (High-Fidelity Session Capture)

전통적인 터미널 스크레이핑 방식은 ANSI 색상 이스케이프 코드, 프로그레스 스피너, 깨진 줄바꿈 등이 섞여 매우 취약합니다.

MadoHub는 네이티브 구조화 세션 캡처 아키텍처를 적용했습니다.

  • 순수 컨텍스트 추출: 에이전트의 세션 기록과 직접 연동하여 Assistant가 생성한 실제 추론, 코드 패치, 도구 실행 결과만을 정확히 추출하므로 터미널 디스플레이 잡음이 일절 섞이지 않습니다.
  • 프로젝트 작업 공간 자동 정렬: 캔버스 타일과 실제 프로젝트 디렉터리를 지능적으로 매핑하여, 핸드오프 과정에서 상대 경로와 파일 컨텍스트가 완벽히 보존됩니다.
  • 비침습적 모니터링: 에이전트의 핵심 소스코드를 변조하지 않고 표준 CLI 환경의 무결성을 그대로 유지합니다.

트리거 유형 (Trigger Types)

유형동작 방식 및 권장 시나리오
on-idle유휴 감지 (권장): 에이전트가 작업을 마치고 짧은 대기 상태를 유지할 때 트리거됩니다. 가장 안정적입니다.
on-complete완료 신호: 에이전트가 작업 완료 신호를 명시적으로 출력하는 즉시 트리거됩니다.
on-keyword패턴 일치: 터미널 출력에서 지정한 정규식이나 키워드가 감지되는 즉시 트리거됩니다.
always연속 스트림: 완료를 기다리지 않고 새롭게 생성되는 터미널 텍스트를 실시간으로 대상에 계속 전달합니다.

변환 유형 (Transform Types)

유형설명 및 활용
ai-routingAI 지능형 변환 (핵심): AI 모델을 활용해 다음 에이전트의 역할에 최적화된 고품질 프롬프트를 자동 합성합니다. 설정에서 모델을 지정할 수 있습니다.
prompt-wrap템플릿 래핑: 사용자 정의 템플릿으로 출력을 감쌉니다. 지원 변수: {output}, {round}, {maxRounds}, {source}.
summary지능형 요약: 이전 에이전트의 핵심 결론과 변경 Diff 요약을 생성하여 전달합니다.
full-output전체 전달: 터미널 출력의 마지막 30줄을 그대로 전달합니다.
raw간략 전달: 터미널 출력의 마지막 10줄을 전달합니다.

적응형 터미널 전달

복잡하고 긴 프롬프트도 누락 없이 안정적으로 전달하기 위해, MadoHub는 적응형 디스패치 프로토콜을 적용했습니다.

  • 지능형 입력 속도 제어: 대상 터미널의 입력 버퍼 처리 능력에 맞춰 입력 간격을 자동 조절하므로 고속 입력 중 글자 유실이나 터미널 멈춤 현상을 방지합니다.
  • 프로토콜 적응형 실행: Claude Code, Codex, Amp, OpenCode 및 표준 셸의 고유 실행 시퀀스를 자동 인식하여 명령이 결정론적으로 실행되도록 보장합니다.

순환 방지 보호 장치

에이전트 간 무한 루프 호출과 토큰 낭비를 원천 차단하기 위한 안전장치를 기본 제공합니다.

설정 항목기본값범위설명
maxRounds51–20자동 비활성화되기 전까지의 최대 라우팅 사이클 수.
cooldownMs3s1–30s연속 트리거 사이의 강제 쿨다운 시간.
stopKeyword—문자열"LGTM"이나 "RESOLVED"와 같은 종료 키워드가 감지되면 즉시 라우팅을 중단합니다.

워크플로 예시

터미널 1 (Claude Code: 리팩토링)      터미널 2 (Claude Code: 코드 리뷰)
┌──────────────────────┐    →    ┌──────────────────────┐
│ "auth 모듈 리팩토링"   │         │ 수신 내용:            │
│                      │         │ "src/auth/ 변경 사항  │
│ ✓ 완료 — 파일 3개     │         │  에 대해 리뷰 진행..."  │
└──────────────────────┘         └──────────────────────┘

에이전트 1이 작업을 마치면 MadoHub가 순수한 코드 변경점을 포착하고 ai-routing을 통해 구체적인 리뷰 프롬프트를 생성한 뒤 에이전트 2로 전달하여 독립적인 테스트 및 검토를 시작합니다.

On this page