modiqo/waggle

해결하는 문제

Waggle은 다중 에이전트 간 전달에서의 비효율성과 책임 부재를 해결합니다. 현재 오케스트레이터는 일반적으로 하위 에이전트에게 전체 컨텍스트 블록을 전달하지만, 이는 높은 토큰 비용, 컨텍스트 창의 포화, 그리고 하위 에이전트가 실제로 필요한 정보를 읽었는지 여부에 대한 텔레메트리 부족을 초래합니다. Waggle은 버전 관리와 귀속 정보가 없는 원시 파일 경로나 비용이 큰 전체 텍스트를 전달하는 기존 방식을, 가볍고 귀속 정보가 있는 참조 시스템으로 대체합니다.

작동 방식

Waggle은 약 30바이트의 토큰을 아티팩트에 대한 참조로 사용합니다. 아티팩트 자체를 전달하는 대신 오케스트레이터는 토큰을 전달합니다. 하위 에이전트가 토큰을 해결하면, 해당 에이전트의 특정 모델이나 필요에 맞게 조정된 데이터의 '프로젝션'—예를 들어 요약이나 특정 슬라이스—를 받게 되며, 바이트 제한 내에서 제공됩니다.

주요 기술 구성 요소는 다음과 같습니다:

• MCP 서버: Model Context Protocol (MCP) 서버로 통합되어, Claude Code, Cursor, Codex와 같은 도구에 커스텀 SDK 없이 추가할 수 있습니다.
• 귀속 매니페스트: 누구에게 토큰이 발행되었는지, 위임의 계보, 그리고 다양한 소비자용 변형을 추적합니다.
• 이벤트 로그: 모든 읽기 및 해결 기록을 추가 전용 로그로 기록하여, 어떤 콘텐츠가 접근되었는지 검증 가능한 감사 추적(수신 확인)을 제공합니다.
• 렌즈: 다양한 파일 유형에 특화된 엔진. 예를 들어 소스 코드는 마이닝 시점에 tree-sitter로 처리되어, 검색 시 전체 파일을 파싱하지 않고도 특정 심볼을 읽을 수 있습니다.
• 엣지 배포: 토큰은 머신 간에 페더레이션하거나 Cloudflare의 엣지에 푸시할 수 있어, 원본 호스트의 소스 파일이 전혀 노출되지 않은 채로 원격 에이전트가 콘텐츠를 검색하거나 해결할 수 있습니다.

대상 사용자

Claude Code나 Codex와 같은 도구를 사용하는 다중 에이전트 오케스트레이터 및 허니스를 개발하는 개발자에게 적합합니다. 토큰 오버헤드를 줄이고, 하위 에이전트가 실제로 올바른 데이터를 소비하고 있는지 보장하며, 다양한 AI 벤더와 환경 간에 일관된 참조 레이어를 유지하고자 하는 분들입니다.

주요 특징

• 토큰 기반 전달: 거대한 컨텍스트 덤프를 30바이트 참조로 대체합니다.
• 검증 가능한 소비: 에이전트가 아티팩트의 어떤 부분을 읽었는지 증명할 수 있는 '수신 확인'과 커버리지 리포트를 제공합니다.
• 컨텍스트 인식 프로젝션: 소비자의 컨텍스트와 예산에 따라 필요한 데이터 조각만 제공합니다.
• MCP 통합: MCP 호환 AI 허니스와 즉시 호환되며, 커스텀 SDK가 필요 없습니다.
• 심볼 수준 접근: tree-sitter 개요를 통해 에이전트가 특정 코드 심볼에 직접 접근할 수 있습니다.
• 분산형 접근: 로컬, 페더레이션, 엣지 기반의 토큰 해결을 지원합니다.