Meta-Agent Orchestration and the UX of Removing Features
oss-agent-lab이 9개의 독립 에이전트를 메타-에이전트로 조율하는 오케스트레이션 계층을 추가해 사용자가 에이전트 선택·순서·파라미터를 수동으로 지정할 필요를 제거
AI 요약
Context
9개의 독립적인 specialist 에이전트(라이선스 스캔, 의존성 감사, README 생성 등)가 존재했지만 사용자가 어떤 에이전트를 어떤 순서로 어떤 파라미터로 호출해야 하는지 알아야 했다. 이는 사용자 경험을 제한했고 다단계 워크플로우 실행이 어려웠다.
Technical Solution
- AgentManifest 클래스 도입: 각 specialist 에이전트가 이름, capabilities, input_schema, output_schema, dependencies를 선언하는 메타데이터 구조 정의
- MetaAgent 오케스트레이션 계층 구축: 사용자의 자연어 요청을 파싱해 의도를 추출하고, 등록된 모든 매니페스트를 기반으로 실행 계획을 생성
- 의존성 그래프 기반 topological ordering: 매니페스트에 선언된 의존성으로부터 자동 파생되는 실행 순서로 단계별 실행, 하드코딩된 시퀀싱 제거
- intent_parser, planner, output_generator 모듈화: 메타-에이전트가 도메인 로직을 포함하지 않고 조율에만 집중하도록 설계
- 6 epoch 구조적 빌드: E1-E3 개별 specialist 에이전트, E4 공유 프로토콜, E5 CI 강화 및 테스트 커버리지, E6 메타-에이전트 및 출력 생성기
Key Takeaway
복잡한 멀티스텝 워크플로우는 도메인 로직을 각 specialist에 분리하고 의도 해석과 조율만 담당하는 메타 계층을 추가함으로써 사용자 의도를 자동으로 실행 계획으로 변환할 수 있다. 또한 마켓플레이스 사례에서 보듯이 아키텍처 개선은 기능 추가뿐 아니라 사용자 경험을 해치는 요소의 제거(검증 배지 UI 제거)도 포함되며, 기저 기술은 유지하되 표시 방식만 개선하는 유연한 설계가 필요하다.
실천 포인트
여러 개의 독립적인 서비스·에이전트·모듈을 통합해야 하는 시스템에서 각 컴포넌트가 명시적 매니페스트(capability, input/output schema, 의존성)를 선언하도록 강제하면, 상위 계층의 오케스트레이터가 하드코딩 없이 의도 기반 계획을 자동 생성하고 topological sorting으로 올바른 순서를 보장할 수 있다. 또한 프로덕트 개선 시 새 기능 추가만 고려하지 말고, 검증 완료 전까지는 해당 데이터를 백그라운드에서 수집하되 UI에 표시하지 않는 방식으로 사용자 경험 품질과 기술 투자의 균형을 맞출 수 있다.