modu-ai/moai-adk

해결하는 문제

MoAI-ADK는 AI 생성 코드의 신뢰성을 보장하기 위해 설계된 검증 기반 에이전트 오케스트레이션 허브입니다. 실제로 테스트를 실행하지 않고 "테스트가 통과했다"고 주장하는 "환각적 완료 주장" 문제를 시스템 수준에서 검증되지 않은 주장을 금지하고, 모든 성공 주장이 실제 명령어 실행 결과와 연결되도록 함으로써 해결합니다.

작동 방식

Claude Code를 구조적으로 감싸는 래퍼로 작동하며, 모델 오케스트레이션, 추론 깊이, 검증을 관리합니다. 구조화된 SPEC 라이프사이클(계획 → 실행 → 동기화)을 구현하고, "칸반 모드"를 사용하여 여러 터미널(리드, 계획, 실행, 동기화 세션)에 작업을 분할합니다. 각 세션이 특정 단계에 필요한 컨텍스트만 유지하도록 하여 컨텍스트 창의 과부하를 방지합니다. 또한 격리된 워크트리와 브랜치 가드를 사용하여 에이전트 간 코드 오버라이드를 방지하는 병렬 안전한 실행을 가능하게 합니다.

대상 사용자

에이전트 기반 코딩 도구를 사용하면서 엄격한 품질 관리, 비용 효율성(토큰 경제), 세션 초기화에도 불구하고 장기적인 작업을 관리할 수 있는 개발자 및 엔지니어링 팀을 위한 것입니다.

주요 특징

• 증거 기반 검증: 검증되지 않은 완료 주장 금지; 모든 주장은 실제 명령어 실행과 그 출력과 연결되어야 함.
• 칸반 및 팩토리 모드: 여러 전문 세션 간에 작업을 오케스트레이션하여 컨텍스트 사용을 최적화하고 병렬 처리를 가능하게 함.
• 병렬 안전한 격리: 전용 워크트리와 브랜치 상태 가드를 사용하여 병렬 실행 중 코드 오버라이드를 방지.
• 토큰 경제 최적화: 작업 단계에 따라 모델과 추론 깊이를 선언적으로 할당하여 토큰 소비를 줄임 (예: 구현에는 저렴한 모델, 계획에는 고추론 모델 사용).
• 자율적 경계: 자율 실행 중 무한 루프를 방지하기 위해 턴 수, 월클록 시간, 정체 감지 경계에 하드한 제한을 설정.
• 자기 개선 루프: 실패 패턴과 라우팅 결정을 결정 메모리에 저장하여 향후 실행을 개선.