本文へスキップ

Gemini CLIユーザー向け

GEMINI.mdは、Geminiにあなたのルールを教える。
あなたのコードは教えない。

GEMINI.mdは、作業のコンテキストを定めます。MCPは、Geminiがツールに手を伸ばせるようにします。Maguyvaは、あなたのリポジトリの問い合わせ可能な地図をGeminiに与えるMCPサーバーです。だから、最初の編集がファイル構造の当てずっぽうにならずに済みます。

無料で始めるGeminiのセットアップを読む

Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

GEMINI.mdはコンテキスト。MCPはチャネル。Maguyvaは地図。

レイヤー構造

4つの考え方。それぞれがひとつの役割を果たします。

// コンテキスト

GEMINI.md

このリポジトリで、Geminiがどう振る舞うべきか。

// 伝送路

MCP

Geminiが、外部ツールやコンテキストにどう手を伸ばすか。

// コードベース

Maguyva

根拠のあるリポジトリの事実を返す、MCPサーバー。

// 支払うのは誰か

課金対象はワークスペース、シートではありません

エージェントはシート料金を払いません。料金を見る

GEMINI.mdは作業上のコンテキストです。使いましょう。

永続的な指示は、GEMINI.mdに置くべきものです。以下のことを書くのに適した場所です:

  • Geminiが実行すべき、ビルド、テスト、lintコマンド。
  • ディレクトリ単位でスコープされた「常にXをする / 決してYをしない」というガードレール。
  • 命名規則とリファクタリングの好み。
  • 正式な意思決定ログやアーキテクチャノートへのポインタ。

簡潔にまとめてください。スコープを絞ってください。コミットしてください。

しかし、GEMINI.mdは、リポジトリ内のすべてのシンボル、ファイル、呼び出し箇所を問い合わせ可能にするインデックスとして設計されたことは一度もありません。

GEMINI.mdだけでは足りなくなる場所

4つの失敗モード、カードひとつにつきひとつ。

// コンテキストはインデックスではない

Geminiにどう作業するかを教えても、何が存在するかは教えられません。見慣れないパッケージでの最初の編集は、ファイルパスや関数名についての当てずっぽうになります。GEMINI.mdは、すべてのシンボルを列挙することはできませんし、そうすべきでもありません。

// ドキュメントはコードから乖離する

キューのトポロジーを説明するGEMINI.mdの記述は、誰かが新しいコンシューマーを導入するまでは正しい。今や信頼できる情報源はコードであり、ドキュメントは自信満々に古くなっています。Geminiは、間違った方を読んでしまいます。

// リネームはグラフの問題

「このクラスを参照しているのは何か?」は、マークダウンファイルからは答えられません。Geminiは、モノレポ全体をgrepして祈るか、呼び出し箇所をチャットに貼り付けるようあなたに頼むしかありません。

// コンテキストウィンドウはタダではない

大きなウィンドウは、問い合わせ可能なインデックスと同じではありません。Geminiが「十分に知っている」と思えるまでGEMINI.mdを読み込ませても、推論の予算を静的なコンテキストの量と引き換えにするだけです。

3つのレイヤーがどう組み合わさるか

Geminiユーザーは、すでにこの形で考えています。このページは、それを明確にするべきです。

GEMINI.md

コンテキスト

Geminiがどう振る舞うか

MCP

チャネル

どう手を伸ばすか

Maguyva

コードベースの事実

何を見るか

  • GEMINI.md このリポジトリで、Geminiがどう振る舞うか。
  • MCP Geminiが、ツールやコンテキストにどう手を伸ばすか。(仕様)
  • Maguyva Geminiがコードベースに質問したときに何を見るか。Semantic、AST、グラフ、テキスト検索の結果が、ファイルパスと行番号付きで返ってきます。

GEMINI.mdは、Geminiにどう作業するかを教える。

Maguyvaは、Geminiに作業の拠り所を与える。

3つのワークフロー

Gemini特有。Geminiのgrepではなく、実際のコールグラフに根ざしています。

// workflow 01

共有クラスをリネームする前に、すべての依存先を見つける

gemini> PaymentClient → BillingClientにリネーム

graph::callers(PaymentClient)            12 references across 7 packages
graph::importers(src/payments/client.ts)  9 importers
graph::extends(PaymentClient)             2 subclasses (RetryClient, MockClient)

→ Geminiは、ファイル一覧を添えた21件の編集からなる移行を提案します。
[exit 0]

Geminiは、編集を始める前に、Maguyvaに依存先を尋ねます。移行リストは、Geminiの記憶ではなく、実際のグラフに根ざした形で返ってきます。

// workflow 02

テストスタブではなく、実際の実装を見つける

gemini> normalizePhoneNumberはE.164をどのように処理していますか?

semantic::query("normalize phone E.164")
  src/util/phone.ts:88   normalizePhoneNumber()   ← real impl
  test/util/phone.spec.ts:14  jest.mock(...)      ← stub
[exit 0]

名前は嘘をつきます。モックは実際のコードを覆い隠します。Maguyvaは、実際の実装をテストモックより上位にランク付けします。

// workflow 03

リファクタリングの前に、ブラストラディウスを確認する

gemini> QueueDispatcher.publishを呼び出しているのは?

graph::callers(QueueDispatcher.publish)
  3 in src/billing/*    1 in src/audit/*    1 in src/notifications/*
[exit 0]

パッケージ横断の呼び出し箇所がインラインで表示されます。差分は、Geminiのgrepではなく、実際のインポート元に根ざしています。

Gemini CLIでのセットアップ

3ステップ。Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

  1. // step 01

    maguyva.aiでリポジトリをインデックス化

    回答を検証できるよう、よく知っているものを選びましょう。

  2. // step 02

    Gemini CLIの設定にMCPサーバーとしてMaguyvaを追加

    // ~/.gemini/settings.json
{
  "mcpServers": {
    "maguyva": {
      "httpUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

    答えをすでに知っている質問をひとつ投げてみる

    会社全体から始めないでください。1つのリポジトリと、検証可能な質問1つから始めましょう。

セルフサーブ登録受付中。

すでに知っているリポジトリを1つインデックス化。

MCP経由でGeminiを接続。検証できる質問を1つ、試してみましょう。

最初のリポジトリをインデックスする互換性ドキュメントを見る

Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。