Agent 라우팅
지능형 변환을 통해 AI 에이전트 간에 출력과 컨텍스트를 자동으로 전달합니다.
Agent 라우팅은 MadoHub의 핵심 오케스트레이션 엔진입니다. 한 에이전트가 작업을 마치면 MadoHub는 그 결과를 자동으로 캡처하여 구조화된 프롬프트로 변환한 뒤, 다음 에이전트의 작업 영역으로 원활하게 전달하여 자율적인 멀티 에이전트 파이프라인을 구성합니다.
작동 방식
- 트리거 (Trigger) — 연결된 소스 타일이 사전 설정된 조건(유휴 감지, 완료 신호, 정규식 일치, 연속 스트리밍)에 따라 라우팅을 활성화합니다.
- 추출 (Extract) — MadoHub가 에이전트의 최신 출력을 캡처합니다. Claude Code와 같은 주요 CLI의 경우 터미널 잡음이 배제된 네이티브 세션 추출 기술을 사용합니다.
- 변환 (Transform) — 캡처된 출력을 다운스트림 에이전트가 이해할 수 있는 최적화된 프롬프트로 재구성합니다(AI 변환, 템플릿 래핑, 원본 전달).
- 전달 (Deliver) — 변환된 프롬프트는 적응형 페이싱 제어를 통해 대상 터미널에 안정적으로 입력되며, 각 에이전트에 맞는 실행 핸드셰이크 프로토콜로 제출됩니다.
고충실도 세션 캡처 (High-Fidelity Session Capture)
전통적인 터미널 스크레이핑 방식은 ANSI 색상 이스케이프 코드, 프로그레스 스피너, 깨진 줄바꿈 등이 섞여 매우 취약합니다.
MadoHub는 네이티브 구조화 세션 캡처 아키텍처를 적용했습니다.
- 순수 컨텍스트 추출: 에이전트의 세션 기록과 직접 연동하여 Assistant가 생성한 실제 추론, 코드 패치, 도구 실행 결과만을 정확히 추출하므로 터미널 디스플레이 잡음이 일절 섞이지 않습니다.
- 프로젝트 작업 공간 자동 정렬: 캔버스 타일과 실제 프로젝트 디렉터리를 지능적으로 매핑하여, 핸드오프 과정에서 상대 경로와 파일 컨텍스트가 완벽히 보존됩니다.
- 비침습적 모니터링: 에이전트의 핵심 소스코드를 변조하지 않고 표준 CLI 환경의 무결성을 그대로 유지합니다.
트리거 유형 (Trigger Types)
| 유형 | 동작 방식 및 권장 시나리오 |
|---|---|
| on-idle | 유휴 감지 (권장): 에이전트가 작업을 마치고 짧은 대기 상태를 유지할 때 트리거됩니다. 가장 안정적입니다. |
| on-complete | 완료 신호: 에이전트가 작업 완료 신호를 명시적으로 출력하는 즉시 트리거됩니다. |
| on-keyword | 패턴 일치: 터미널 출력에서 지정한 정규식이나 키워드가 감지되는 즉시 트리거됩니다. |
| always | 연속 스트림: 완료를 기다리지 않고 새롭게 생성되는 터미널 텍스트를 실시간으로 대상에 계속 전달합니다. |
변환 유형 (Transform Types)
| 유형 | 설명 및 활용 |
|---|---|
| ai-routing | AI 지능형 변환 (핵심): AI 모델을 활용해 다음 에이전트의 역할에 최적화된 고품질 프롬프트를 자동 합성합니다. 설정에서 모델을 지정할 수 있습니다. |
| prompt-wrap | 템플릿 래핑: 사용자 정의 템플릿으로 출력을 감쌉니다. 지원 변수: {output}, {round}, {maxRounds}, {source}. |
| summary | 지능형 요약: 이전 에이전트의 핵심 결론과 변경 Diff 요약을 생성하여 전달합니다. |
| full-output | 전체 전달: 터미널 출력의 마지막 30줄을 그대로 전달합니다. |
| raw | 간략 전달: 터미널 출력의 마지막 10줄을 전달합니다. |
적응형 터미널 전달
복잡하고 긴 프롬프트도 누락 없이 안정적으로 전달하기 위해, MadoHub는 적응형 디스패치 프로토콜을 적용했습니다.
- 지능형 입력 속도 제어: 대상 터미널의 입력 버퍼 처리 능력에 맞춰 입력 간격을 자동 조절하므로 고속 입력 중 글자 유실이나 터미널 멈춤 현상을 방지합니다.
- 프로토콜 적응형 실행: Claude Code, Codex, Amp, OpenCode 및 표준 셸의 고유 실행 시퀀스를 자동 인식하여 명령이 결정론적으로 실행되도록 보장합니다.
순환 방지 보호 장치
에이전트 간 무한 루프 호출과 토큰 낭비를 원천 차단하기 위한 안전장치를 기본 제공합니다.
| 설정 항목 | 기본값 | 범위 | 설명 |
|---|---|---|---|
| maxRounds | 5 | 1–20 | 자동 비활성화되기 전까지의 최대 라우팅 사이클 수. |
| cooldownMs | 3s | 1–30s | 연속 트리거 사이의 강제 쿨다운 시간. |
| stopKeyword | — | 문자열 | "LGTM"이나 "RESOLVED"와 같은 종료 키워드가 감지되면 즉시 라우팅을 중단합니다. |
워크플로 예시
터미널 1 (Claude Code: 리팩토링) 터미널 2 (Claude Code: 코드 리뷰)
┌──────────────────────┐ → ┌──────────────────────┐
│ "auth 모듈 리팩토링" │ │ 수신 내용: │
│ │ │ "src/auth/ 변경 사항 │
│ ✓ 완료 — 파일 3개 │ │ 에 대해 리뷰 진행..." │
└──────────────────────┘ └──────────────────────┘에이전트 1이 작업을 마치면 MadoHub가 순수한 코드 변경점을 포착하고 ai-routing을 통해 구체적인 리뷰 프롬프트를 생성한 뒤 에이전트 2로 전달하여 독립적인 테스트 및 검토를 시작합니다.