thewaltero/mythos-router

何を解決するか

Mythos Router は、AI支援開発における「AIの不正確な出力」や幻覚の問題に対処します。AIエージェントが誤ったまたは部分的なファイル変更を行うのを防ぐために、ファイルシステムの実際の状態がAIが主張する内容と一致していることを保証する検証レイヤーを導入しています。これにより、部分適用された変更や幻覚的なファイル状態によるコードベースの破損リスクが完全に排除されます。

動作方法

コアメカニズムは 厳格な書き込み規律（SWD） です。AIエージェントがファイル変更を提案すると、Mythos Router は操作の前後でファイルシステムの SHA-256 スナップショットを取得します。実際の結果がエージェントの主張と一致しない場合、すべてのバッチ処理がロールバックされます。

3つの主な動作モードがあります：

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にガイドとして提供し、監査受領書に記録される。