thewaltero/mythos-router

해결하는 문제

Mythos Router는 AI 지원 개발에서 "AI의 부정확한 작업"과 환각 현상을 해결합니다. AI 에이전트가 잘못되거나 부분적인 파일 변경을 하지 못하도록, 파일 시스템의 실제 상태가 AI가 주장한 내용과 일치하는지 검증하는 레이어를 도입합니다. 이로 인해 부분 적용된 변경 사항이나 환각된 파일 상태로 인한 코드베이스 손상 위험이 완전히 제거됩니다.

작동 방식

핵심 메커니즘은 엄격한 쓰기 규율(SWD)입니다. AI 에이전트가 파일 변경을 제안하면, Mythos Router는 작업 전후로 파일 시스템의 SHA-256 스냅샷을 캡처합니다. 실제 결과가 에이전트의 주장과 일치하지 않으면 전체 배치가 롤백됩니다.

주로 세 가지 방식으로 작동합니다:

1. 내장형 에이전트: Claude Opus 5와 같은 모델을 사용해 작업을 수행하는 CLI 도구(mythos chat 또는 run).
2. 외부 에이전트 인터페이스: 모델에 의존하지 않는 레이어(swd apply)로, GPT, DeepSeek 등 어떤 외부 에이전트도 JSON 또는 stdin을 통해 파일 작업을 제출하여 검증받을 수 있습니다.
3. MCP 어댑터: 이러한 검증 및 수신 도구를 Model Context Protocol (MCP) 호환 클라이언트에 노출합니다.

또한, Markdown 기반의 "유일한 권위" 메모리 시스템(MEMORY.md)을 사용하며, SQLite에 인덱싱해 빠른 검색이 가능하고 저비용 모델로 압축해 효율성을 유지합니다.

대상 사용자

• 검증 가능하고 위변조가 명확한 AI 지원 개발을 원하는 개발자.
• CI/CD 또는 로컬 정책을 통해 AI 생성 코드 변경에 안전 장치가 필요한 팀.
• 자체 AI 에이전트를 개발하고 있지만, 자체 검증 로직을 구축하지 않고도 파일 변형을 신뢰할 수 있게 적용하고 검증할 수 있는 방법이 필요한 개발자.

주요 특징

• 엄격한 쓰기 규율: 사전/사후 스냅샷과 해시 체인된 수령 증명으로 모든 파일 작업을 검증.
• 격리된 실행: 실제 트리에 적용하기 전에 리포지토리의 일시적 복사본에서 AI 변경 사항을 테스트할 수 있음.
• 비용 라우터: 저가 모델이 SWD 검증에 실패할 경우에만 더 비싼 모델로 자동 전환.
• 자기 복구 메모리: 소스 오브 트루스로 Markdown 로그를 사용하며, 손상된 경우 SQLite 인덱스로 재구성 가능.
• 예산 제한기: 실시간 토큰 및 비용 추적과 작업 손실을 방지하기 위한 부드러운 저장 기능.
• 검증된 스킬 팩: 프로젝트별 규칙(SKILL.md)을 AI에게 안내로 제공하고 감사 수령 증명에 기록됨.