İçeriğe atla

Antigravity kullanıcıları için

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

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, grafik 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.

Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

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.

// ajan ide

Antigravity

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

// manuel bağlam

@ anmaları + kurallar

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

// kod tabanı

Maguyva

MCP üzerinden otomatik kod tabanı bilgileri.

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.

// the fix

// 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.

// where it breaks

// 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.

// the fix

// 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.

// where it breaks

// 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.

// the fix

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

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

// where it breaks

// 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.

// the fix

// kural dosyalarını koruyun

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

// where it breaks

// 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 + grafik + 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ı grafiğine temellendirilmiş.

// workflow 01

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

agent> where does authentication happen in this monorepo?

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 entry points across 4 packages, ranked by call-site density.
[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.

// workflow 02

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

agent> how does normalizePhoneNumber handle E.164?

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.

// workflow 03

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

agent> what calls QueueDispatcher.publish across the monorepo?

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 indekslenmiş repo satırı, kart gerektirmez.

  1. // step 01

    maguyva.ai’de bir repo dizinleyin

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

  2. // step 02

    Antigravity’de Maguyva’yı bir MCP sunucusu olarak ekleyin

    // ~/.gemini/antigravity/mcp_config.json
    {
      "mcpServers": {
        "maguyva": {
          "serverUrl": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer <your-key>"
          }
        }
      }
    }
  3. // step 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.