Maggy:palgu>によるオープンソースのAIエンジニアリングハーネス。
palgu>の開発チームがお届けするMaggyは、Claude Code、Codex、Kimi、Gemini CLIを、テスト強制と品質ゲートを備えたワークフローへと進化させるオープンソースのハーネスです。13段階のモデルティアにわたるコスト最適化ルーティング、セッション横断メモリ、プラグインシステムを搭載しています。ローカルで実行でき、すべてのコードを自社で完全に管理できます。チームでガバナンスの効いたゲートウェイが必要になった際は、接続先をpalgu>に向けるだけです。
- 自身のキーを使い、タスクごとに要件を満たす最安のモデルを選ぶ独自のマルチモデルルーティングをローカルで実行できます。
- お使いのCLIに、TDD、ゲート、メモリ、エージェントチームを備えた本格的なエンジニアリングハーネスを追加します。
- エンドツーエンドでセルフホストして完全に管理。オープンソースで、アカウントもゲートウェイも不要です。
2つのコンポーネント、1つのリポジトリ
Bootstrapなら30秒で開始できます。ルーティング、プロトコル、ダッシュボードが必要になった段階でMaggyサーバーを追加してください。
~/.claude/に配置するだけで次のセッションから適用される、インストール可能な設定パック(67のスキル、フック、ルール、テンプレート)です。約30秒でインストールでき、Claude Code、Codex、Kimi、Gemini CLIで動作します。
13階層ルーティング、スキルプロトコル、MCP経由のCortexコードグラフ、Polyphonyによる分離、プラグインを追加する、オプションのローカルFastAPIサーバーおよびWebダッシュボードです。maggy serve → localhost:8080
コアシステム
Maggyがもたらすあらゆる機能を、ひとつに。
すべてのタスクを、確実に遂行できる最も低コストなモデルへルーティングします。
- 各メッセージは無料のQwen3分類器によってローカルで処理され、複雑度とリスク(ブラストスコア)が1〜10でスコアリングされるとともにタスク種別ごとに分類されるため、トリアージにコストは一切かかりません。
- スコアに応じてティアが選択されます。分類や一括処理向けのT0 Qwen3(ローカル)から始まり、DeepSeek、Kimi、Gemini、Grok、Codexを経て、アーキテクチャやセキュリティレビュー向けのClaude Sonnet/Opus(T11〜T12)まで段階的に上がります。実際の作業の約80%は、低コストながら高性能な中間ティアで処理されます。
- 予算上限に応じた自動ダウングレード機能を搭載しています。組織の上限が近づくと、処理をブロックするのではなく、より安価な階層へとルーティングを段階的に引き下げます。疲労を考慮したカスケード方式により、呼び出しが失敗した場合はチェーンの下位へとフォールバックします。
単なるプロンプトではなく、インテントに応じた決定論的なワークフロー。
- プロトコルはYAMLファイル(maggy/skills/protocols/)です。インテント(「Gitへプッシュ」「機能をリリース」など)が一致すると、Maggyは厳格なゲートを伴い順番にステップを実行します。
- 例(git-push):lint、型チェック、テスト、ステージング、コミット(AIによるコミットメッセージ生成)、プッシュ。いずれかのステップが失敗するとプロトコルは停止し、中途半端なコードがリリースされることはありません。
- .yamlファイルを配置するだけで独自のスキルを追加できます。標準搭載された67種類のスキルは、Python、TypeScript、React、React Native、Flutter、Supabase、Stripe、Playwright、セキュリティ、ADR、エージェント間のタスク委譲をカバーしています。
テストはパスしたかどうかを教えてくれますが、Telosは本来の意図を満たしているかどうかを教えてくれます。
- Telosは、意図忠実度スケール(IFS = F1 x F2 x F3)に基づいて成果物を採点します。評価は「適合性(記述された仕様を満たしているか)」「妥当性(正しい動作をしているか)」「完全性(堅牢かつ安全か)」の3つの側面で行われます。
- スコアは乗算方式です。いずれか1つの側面でもゼロになると、合計スコアはゼロになります。2つの側面で満点を取って3つ目を無視するといった方法では合格できません。
- プラグインとして提供されるため、後から手動で行うのではなく、パイプラインの一部として実行されます。
あらゆるハーネスがMCP経由で利用できる、クエリ可能なコードグラフです。
- Cortexは、10種類のエッジタイプ、循環的複雑度(サイクロマティック複雑度)メトリクス、FTS5全文検索、双方向トラバーサルを備えたコードプロパティグラフを、単一のSQLiteデータベース上に構築します。
- 15種類のMCPツールを公開しているため、Claude Code、Codex、その他のMCPクライアントは、grepで検索する代わりに「何がこれを呼び出しているか」「この変更で何が壊れるか」といった構造化されたクエリを実行できます。
- 単純なコードベースメモリ手法とのベンチマーク比較において、「なぜ」や「影響範囲」を問う質問では、グラフトラバーサルがフラットなRAGを上回ります。
ファイルの競合を起こさずに、1つのリポジトリで複数のエージェントを実行できます。
- 同時実行される各エージェントセッションには、2つ目のセッションの開始時に自動でプロビジョニングされる、Dockerで分離されたワークスペースが割り当てられます。
- 各エージェントが独立したチェックアウト環境で作業するため、共有リポジトリで複数のエージェントを実行する際によくある、他のエージェントのファイルを上書きしてしまう問題が決して起きません。
- 分離モードにより、実行ごとに分離の厳密さを選択できます。
コンパクション後も失われず、数週間にわたって持続するメモリ。
- Mnemosは、4次元の疲労モデルと型付きチェックポイントを備えたタスク単位のメモリです。Claude Codeのセッショントランスクリプトを取り込み、各セッションの「曖昧さ」をスコアリングして、コンテキストが失われる前に自動でチェックポイントを作成します。
- コンテキストが圧縮されると、Mnemosはタスクの再説明を求めるのではなく、型付きのチェックポイントを復元するため、文脈を維持したままトークンを解放できます。
- Engramは長期記憶レイヤーです。アーキテクチャに関する知見を数週間にわたって永続化し、7種類の「記憶喪失(アムネジア)」に対処することで、セッション間で意思決定の経緯が失われるのを防ぎます。
コードの内容だけでなく、なぜそのコードが存在するのかを記録します。
- 意図で拡張されたコードプロパティグラフ(iCPG)は、コードの構造とともに、その背後にある推論、ReasonNodes、および制約を記録します。
- 6つの次元でドリフト(逸脱)を検知し、実装が当初のインテントから外れた際にフラグを立てます。
- さらに、重複実装も防止します。新しい機能を構築する前に、すでに存在していることをグラフが教えてくれます。
記憶に頼らずルールを強制する、6エージェント構成のTDDパイプラインです。
- 単一のモデルがすべてを行うのではなく、Lead、Quality、Security、Review、Merger、Featureの6つのロールが実際のパイプラインとして各機能を実行します。
- ストップフックによりTDDを強制します。テストが通過しない限りタスクは完了とみなされません。グリーンでなければマージは不可です。
- 品質ゲートはファイル単位で強制されます(関数あたり最大20行、引数3つまで、ネスト2階層まで)。また、重要な変更にはADRが必須となります(存在しない場合はGit履歴からリバースエンジニアリングされます)。
ルーティング:13ティア、要件を満たす最安モデルを選択
すべてのメッセージは(ローカルのQwen3によって)複雑度が1〜10でスコアリングされ、タスク種別ごとに分類されます。簡単な質問は無料のローカルモデルで処理し、高度なアーキテクチャ設計はClaudeへとエスカレーションします。予算上限の設定や自動ダウングレードにも対応しています。
| T0 | Qwen3(ローカル) | 分類、トリアージ、無料の一括処理 |
| T1 | Gemini Flash-Lite | 一括抽出、パイプライン |
| T2 | DeepSeek Flash | ドキュメント、テスト、スキャフォールディング |
| T3 | Gemini Flash | マルチモーダル、ビジョン、オーディオ |
| T4 | DeepSeek Pro | 複雑なコーディング、リファクタリング |
| T5 | Gemini CLI | 複数ファイルのエージェントコーディング |
| T6 | AGY | エンドツーエンド(git + コード + テスト) |
| T7 | Kimi | ロングコンテキスト分析 |
| T8 | Gemini Pro Search | ディープリサーチ、2Mコンテキスト |
| T9 | Grok | 競合調査、推論 |
| T10 | Codex | 一括生成、機密性の高い処理 |
| T11 | Claude Sonnet | 品質重視のコード、デバッグ |
| T12 | Claude Opus | アーキテクチャ、セキュリティ、ADR |
プラグイン:ドロップイン拡張機能
シンプルなプラグインシステムです。配置するだけでMaggyのイベントにフックします。標準で複数のプラグインが同梱されています。
リリースされた成果物を投稿記事に変換し、ボイスエンジン(プレーンテキスト、emダッシュなし)とコメント返信のハートビート機能を使って、LinkedIn、X、Redditに公開します。
GitHub、Asana、Mondayのプロバイダーにより、タスクやIssueをハーネスに直接連携できます。
Telosはプラグインとして提供されます。小さなplugin.yamlとplugin.pyを用意するだけで、独自のプラグインも作成できます。
Maggyの独自性
多くの「AIエンジニアリング」ツールは、既存のCLIを置き換える自律型エージェントループ(Hermes型)か、付加価値のない薄いラッパーのどちらかです。Maggyは、現在お使いのツールを強化する規律とルーティングのレイヤーです。
| 機能 | Maggy | 自律型エージェントフレームワーク | 素のClaude Code |
|---|---|---|---|
| マルチモデルルーティング | あり:13ティア、要件を満たす最安モデル | 通常は単一モデル / 独自ループ | なし:すべてを単一モデルで処理 |
| 規律の徹底 | TDDストップフック + 品質ゲート + ADR | 任意(プロンプト依存) | なし |
| セッション横断メモリ | Engram / Mnemos、コンパクション後も維持 | まれ / ベクトルストアの後付け | セッションごとに消失 |
| コードインテリジェンス | iCPG + Cortex MCP(コードが存在する理由) | 通常はファイルに対する単純なRAG | なし |
| 並列実行の安全性 | Polyphony、Dockerで分離されたワークスペース | 手動 / 共有リポジトリでのコンフリクト | N/A |
| お使いのCLIと連携 | Claude Code / Codex / Kimi / Geminiを拡張 | 既存ツールを独自ツールに置き換え | n/a |
| オープンソース | MITライセンス、1100以上のテスト、セルフホスト可能 | ツールにより異なる | クローズド |
動作イメージ
You: "review the auth middleware for timing attacks" → Blast score: 8/10 (security + architecture) → Routed to: Claude (Tier 12) → ADR gate: found docs/adr/0003-jwt-strategy.md → injected as context → Review runs with full architectural context You: "push to git" → Intent matched: git-push protocol → ✅ lint · ✅ typecheck · ✅ tests · ✅ commit (AI-written) · ✅ push
Maggyとpalgu>
両者は連携して機能します。Maggyは開発者個人向けのオープンソースのエージェントハーネスであり、ローカルかつ無料で動作し、適切なモデルを選択してエンジニアリングの規律を徹底します。palgu>はチーム向けの完全なエンジニアリング・スーパーハーネスであり、組織が必要とする予算管理、ポリシー、監査機能を備え、あらゆるエージェントとモデルを統括してエンジニアリングを遂行します。Claude Codeの接続先はどちらにでも指定できます。個人なら無料でMaggyを使い、チームでガバナンスが必要になった時点でpalgu>を追加してください。どちらを選んでもベンダーロックインはありません。