alinaqi/maggy

何を解決するか

Maggy と Claude Bootstrap は、Claude Code のユーザー向けに構造化されたエンジニアリングシステムを提供し、AI補助開発における一般的な課題、たとえば高コストなAPI使用、コンテキストウィンドウの飽和、品質基準の不備を解決します。AIが単純なタスクに高価なモデルを使用することを防ぎ、コードがテストを通過し、アーキテクチャレビューを経るまで「完了」と見なされないことを保証します。

動作方法

このプロジェクトは2つのコンポーネントに分かれています：Claude Bootstrap は Claude Code 環境に直接インストールされる設定パック（スキル、フック、ルール）であり、Maggy はローカルの FastAPI サーバーと Web ダッシュボードを備えています。

主なメカニズムは以下の通りです：

• 13段階ルーティング：ローカル分類器（Qwen3）がタスクの複雑さをスコアリングし、要求を処理できる最もコスト効率の良いモデル（ローカルモデルから Claude Opus まで）にルーティングします。
• TDDの強制：テストが通るまでAIがタスクを完了できないようにするストップフック。
• メモリシステム：Mnemos と Engram はタスク固有および複数セッションにわたるメモリを提供し、コンテキスト圧縮時の状態喪失を防ぎます。
• Polyphony：Docker/OrbStack を使用して並列エージェントセッションを個別のコンテナで隔離し、ファイルの競合を回避します。
• Cortex MCP：SQLite グラフストアを用いたAST抽出と双方向走査を行うコードインテリジェンスサーバー。
• Telos：テスト適合性、アーキテクチャのずれ、シンボルの整合性を組み合わせて「意図の正確性（Intent Fidelity）」を測定するテストフレームワーク。

対象ユーザー

• Claude Code ワークフロー内で TDD の強制と永続的メモリを求める個人エンジニア。
• 複数のLLMプロバイダー（Claude、DeepSeek、Geminiなど）間で作業をルーティングし、コストを管理したいチーム。
• 意図追跡とプラグインベースのAI開発者ツールのリファレンス実装を探しているプラットフォームエンジニア。

主な特徴

• 73の組み込みスキル：React、Python、Flutterなど、さまざまな言語とフレームワークをカバー。
• Webプロジェクトの視覚的検証：Playwright を使用して作業の証明動画を記録。
• Context Shunt：大規模なファイル読み込みを、メインコンテキストに入る前に安価なワーカーモデルで要約することで短縮。
• Council PR Review：GitHub PRのためのマルチモデル敵対的レビュー処理で、誤検出を低減。
• セキュリティ監査：ハーネスに統合された構造的で多段階の敵対的監査プロセス。