# Antigravity ajanları çalıştırır. Maguyva onlara haritayı verir.

Canonical source: https://maguyva.ai/tr/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, ajan öncelikli bir IDE’dir: ajanlar editör, terminal ve tarayıcı genelinde planlar ve düzenlemeler yapar. Gerçek bir monorepo’da yine de hangi dosyanın önemli olduğuna dair bir haritaya ihtiyaçları vardır. Maguyva kod tabanınızı dizinler ve MCP üzerinden (anlamsal, AST, graf ve metin) geri sunar; böylece “kimlik doğrulama nerede yapılıyor” sorusu yedi test taslağı değil, gerçek kimlik doğrulama akışını döndürür.

> Antigravity ajanı çalıştırır. Maguyva ona hangi dosyaya dokunacağını söyler.

## Her katman ne yapar

Dört parça. Her birinin bir işi var.

### Antigravity

Ajanlarınızın planladığı, düzenlediği ve doğruladığı yer.

### @ anmaları + kurallar

Repo büyüyene kadar manuel bağlam kazanır.

### Maguyva

MCP üzerinden otomatik kod tabanı bilgileri.

### Koltuk değil, çalışma alanı

Ajanlar koltuk için ödemez. [Fiyatlandırmayı görün](https://maguyva.ai/tr/pricing)

## Antigravity ajanları çalıştırır. Bırakın çalıştırsın.

Sorun ajan IDE’si değil. Agent Manager, çoklu yüzey çalıştırma ve kural dosyaları mükemmel ve bunları zaten şunlar için kullanıyorsunuz:

- Editör, terminal ve tarayıcı genelinde ajanları planlama ve çalıştırma.
- Değişiklik yerel olduğunda çoklu dosya düzenlemeleri.
- Repo kuralları ve stil sınırları için ajan kuralları.
- Belirli bir dosyayı bağlama çekmek için `@`-anmaları.

Bunu yapmaya devam edin. Hiçbiri ortadan kalkmıyor.

Ancak gerçek bir monorepo’da (çalışma alanı bağımlılıklarıyla TypeScript, Python servisleri, karışık paketler) ilgili dosya henüz ajanın radarında değilken ajan bağlamı bozulur.

## Zaten denediğiniz manuel çözümler ve nerede bozuldukları

Dört manuel çözüm, başarısızlık modlarıyla eşleştirilmiş. Sol = bugün yaptığınız. Sağ = nerede bozulduğu.

### // dosyalardan bahsedin

Önemli olduğunu düşündüğünüz üç dosyayı `@` ile anıyorsunuz. Ajan bunların içinde temiz bir şekilde düzenleme yapıyor.

### // bahsetmek bir tahmindir

Hangi dosyaların dahil olduğunu zaten biliyorsanız işe yarar. Otonom bir ajanın, bahsetmeyi bilmediğiniz dosyalara ihtiyacı vardır.

### // kod parçalarını yapıştırın

Ajana yeterli bağlam vermek için başka bir paketten 200 satırı yapıştırıyorsunuz.

### // yapıştırılan kod eskir

Sabah 9’da yapıştırdığınız kod parçası, ekip arkadaşınızın saat 11’de yaptığı rebase’i yansıtmaz. Ajan, paketin hayalet bir sürümüne karşı düzenleme yapıyordur.

### // bir bağlam dokümanı yazın

Bir ajan kuralları dosyası ya da bir mimari markdown’u yazıyorsunuz. Bugün doğru.

### // dokümanlar koddan daha hızlı savrulur

Elle yazdığınız her şey savrulur. Kod, gerçeğin kaynağıdır. Kuyruk katmanını açıklayan bir doküman bir hafta doğrudur, sonra sonsuza dek yanlış kalır.

### // kural dosyalarını koruyun

Adlandırma, lint ve derleme komutları için ajan kuralları ekliyorsunuz. Davranış için harika.

### // kurallar ≠ dizin

Kurallar, “commit’lerden önce her zaman pnpm tsc -b çalıştır” gibi bir kural için doğru yerdir. Monorepo’nuzdaki her sembolün, dosyanın ve çağrı noktasının sorgulanabilir bir dizini değildir.

## Maguyva altındaki katmandır

Antigravity’nin yerini almaz. MCP desteğine takılan repo bağlamı katmanıdır.

- **Anlamsal + AST + graf + metin**: anlama, yapıya, bağımlılığa veya harfi harfine göre arayın. Her sonuç bir dosya yolu ve satır numarası döndürür.
- **Varsayılan olarak paketler arası**: yalnızca ajanın açık olduğu pakette değil, monorepo’daki her pakette çağrı noktaları ve import edenler.
- **Dal farkında**: Maguyva, ajanın düzenlediği kod sürümünü görür.
- **Otonomluk için inşa edildi**: birçok düzenleme planlayan bir ajanın etki yarıçapına, CI kırmızıya dönmeden önce, sonra değil ihtiyacı vardır.

> Antigravity neyin düzenleneceğine karar verir.
> Maguyva ajana *düzenlemenin neye dokunduğunu* söyler.

## Üç monorepo iş akışı

Paketler arası, diller arası. Ajanın grep’ine değil, gerçek çağrı grafına temellendirilmiş.

### 01. Hiçbir şeyden bahsetmeden paketler arasında kimlik doğrulama akışını bulun

```text
agent> Bu monorepo'da kimlik doğrulama nerede yapılıyor?

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 pakette 4 giriş noktası, çağrı noktası yoğunluğuna göre sıralandı.
[exit 0]
```

Bir dosyadan bahsetmediniz. Bir kod parçası yapıştırmadınız. Ajan, önemli olan dört dosyaya doğru sıralamayla sahip ve temellendirilmiş bir düzenleme yapabilir.

### 02. Test taslağını değil, gerçek uygulamayı bulun

```text
agent> normalizePhoneNumber, E.164 biçimini nasıl işliyor?

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

İsimler yalan söyler. Mock’lar gerçek kodu gölgeler. Maguyva, her pakette gerçek uygulamayı test mock’unun üzerinde sıralar.

### 03. Ajan refactor yapmadan önce etki yarıçapını kontrol edin

```text
agent> Monorepo genelinde QueueDispatcher.publish metodunu ne çağırıyor?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← cross-language via gRPC stub
[exit 0]
```

Paketler arası, ve çoklu dilli bir reponuz varsa diller arası olarak, çağrı noktaları satır içinde ortaya çıkar. Otonom bir ajan, CI kırmızıya dönmeden önce etki yarıçapını alır, sonra değil.

## Antigravity ile kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar dizinlenmiş repo satırı, kart gerektirmez.

### 01. maguyva.ai’de bir repo dizinleyin

Bağlam sıkıntısını en çok hissettiğiniz monorepo’yu seçin.

### 02. Antigravity’de Maguyva’yı bir MCP sunucusu olarak ekleyin

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

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

### 03. Yanıtını zaten bildiğiniz bir soru sorun

Ajanı tüm şirketinize yönlendirmeyin. Bir repo ve doğrulanabilir bir soruyla başlayın, örneğin “paketler arasında `formatInvoice`’u ne çağırıyor?” gibi.

## Zaten bildiğiniz bir reponuzu dizinleyin.

Yanıtını doğrulayabileceğiniz bir soruyu test edin.