# Antigravity jalankan ejen. Maguyva bagi mereka peta.

Canonical source: https://maguyva.ai/ms/for-antigravity

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Antigravity ialah IDE ejen-dahulu: ejen merancang dan menyunting merentasi editor, terminal, dan pelayar. Pada monorepo sebenar mereka masih perlukan peta fail mana yang penting. Maguyva indeks pangkalan kod anda dan sampaikannya semula melalui MCP (semantik, AST, graf, dan teks), supaya “di mana auth berlaku” pulangkan aliran auth sebenar, bukan tujuh stub ujian.

> Antigravity jalankan ejen. Maguyva beritahu ia fail mana nak disentuh.

## Apa setiap lapisan buat

Empat bahagian. Setiap satu ada kerja.

### Antigravity

Tempat ejen anda merancang, menyunting, dan mengesahkan.

### sebutan @ + peraturan

Konteks manual menang, sehingga repo jadi besar.

### Maguyva

Fakta pangkalan kod automatik melalui MCP.

### Ruang kerja, bukan pengguna

Tiada caj per pengguna untuk ejen. [Lihat harga](https://maguyva.ai/ms/pricing)

## Antigravity jalankan ejen. Biarkan ia.

IDE ejen bukan masalahnya. Agent Manager, pelaksanaan pelbagai permukaan, dan fail peraturan memang hebat, dan anda dah pun guna untuk:

- Merancang dan menjalankan ejen merentasi editor, terminal, dan pelayar.
- Suntingan pelbagai fail bila perubahan itu setempat.
- Peraturan ejen untuk konvensyen repo dan sekatan gaya.
- Sebutan `@` untuk tarik fail tertentu ke dalam konteks.

Teruskan buat begitu. Semua itu tak hilang.

Tapi dalam monorepo sebenar (TypeScript dengan dependensi workspace, servis Python, pakej bercampur) konteks ejen pecah sebaik saja fail yang berkaitan belum ada dalam radar ejen.

## Pembetulan manual yang anda dah cuba, dan di mana ia pecah

Empat pembetulan manual dipadankan dengan mod kegagalannya. Kiri = apa yang anda buat sekarang. Kanan = di mana ia pecah.

### // sebut fail

Anda sebut `@` tiga fail yang anda rasa penting. Ejen sunting dengan bersih di dalamnya.

### // sebutan cuma tekaan

Ia berfungsi bila anda dah tahu fail mana yang terlibat. Ejen autonomi perlukan fail yang anda tak tahu nak sebut.

### // tampal snippet

Anda tampal 200 baris daripada pakej lain ke dalam ejen untuk bagi ia konteks yang cukup.

### // kod tampal jadi basi

Snippet yang anda tampal pukul 9 pagi tak cerminkan rebase yang rakan sepasukan anda landing pukul 11 pagi. Ejen sedang sunting berdasarkan versi hantu pakej itu.

### // tulis dokumen konteks

Anda tulis fail peraturan ejen atau markdown seni bina. Betul untuk hari ini.

### // dokumen menyimpang lebih laju daripada kod

Apa jua yang anda tulis dengan tangan akan menyimpang. Kod itulah sumber kebenaran. Dokumen yang terangkan lapisan queue betul untuk seminggu, kemudian salah selamanya.

### // kekalkan fail peraturan

Anda tambah peraturan ejen untuk penamaan, lint, dan arahan binaan. Bagus untuk kelakuan.

### // peraturan ≠ indeks

Peraturan ialah tempat yang betul untuk “sentiasa jalankan pnpm tsc -b sebelum commit.” Ia bukan indeks yang boleh ditanya untuk setiap simbol, fail, dan tapak panggilan dalam monorepo anda.

## Maguyva ialah lapisan di bawahnya

Bukan pengganti Antigravity. Lapisan konteks repo yang bergantung pada sokongan MCP-nya.

- **Semantik + AST + graf + teks**: cari ikut makna, struktur, kebergantungan, atau teks literal. Setiap padanan pulangkan laluan fail dan nombor baris.
- **Merentas pakej secara lalai**: tapak panggilan dan pengimport merentasi setiap pakej dalam monorepo, bukan sekadar yang sedang dibuka ejen.
- **Sedar cabang (branch)**: Maguyva nampak versi kod yang sedang disunting oleh ejen.
- **Dibina untuk autonomi**: ejen yang merancang banyak suntingan perlukan lingkungan impak terus di depan, bukan selepas CI jadi merah.

> Antigravity tentukan apa nak disunting.
> Maguyva beritahu ejen *apa yang disentuh oleh suntingan itu.*

## Tiga aliran kerja monorepo

Merentas pakej, merentas bahasa. Terbukti berdasarkan graf panggilan sebenar, bukan grep ejen.

### 01. Cari aliran auth merentasi pakej, tanpa sebut apa-apa

```text
agent> di mana pengesahan berlaku dalam monorepo ini?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

→ 4 titik masuk merentasi 4 pakej, disusun ikut kepadatan tapak panggilan.
[exit 0]
```

Anda tak sebut apa-apa fail. Anda tak tampal snippet. Ejen ada empat fail yang penting, dalam susunan yang betul, dan boleh buat suntingan berasaskan bukti.

### 02. Cari implementasi sebenar, bukan stub ujian

```text
agent> macam mana normalizePhoneNumber uruskan E.164?

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

Nama boleh menipu. Mock membayangi kod sebenar. Maguyva susun implementasi sebenar di atas mock ujian, merentasi setiap pakej.

### 03. Semak lingkungan impak sebelum ejen refactor

```text
agent> apa yang panggil QueueDispatcher.publish merentasi monorepo?

graph::callers(QueueDispatcher.publish)
  3 dalam packages/billing/*
  1 dalam packages/audit/*
  1 dalam packages/notifications/*
  1 dalam services/python-worker/*  ← merentas bahasa melalui stub gRPC
[exit 0]
```

Merentas pakej, dan merentas bahasa bila repo anda poliglot, tapak panggilan tertonjol terus. Ejen autonomi dapat lingkungan impak sebelum ia sunting, bukan selepas CI jadi merah.

## Sediakan Antigravity

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

### 01. Indeks repo di maguyva.ai

Pilih monorepo yang paling menyusahkan anda kerana kekurangan konteks.

### 02. Tambah Maguyva sebagai pelayan MCP dalam Antigravity

`~/.gemini/config/mcp_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. Tanya satu soalan yang anda dah tahu jawapannya

Jangan arahkan ejen ke seluruh syarikat anda. Mula dengan satu repo dan satu soalan yang boleh disahkan, seperti “apa yang panggil `formatInvoice` merentasi pakej?”

## Indeks satu repo yang anda dah kenal.

Uji satu soalan yang anda boleh sahkan jawapannya.