// anlaşma
AGENTS.md
Codex’in bu repoda nasıl davranması gerektiği.
Codex CLI kullanıcıları için
AGENTS.md Codex’e nasıl çalışacağını söyler.
Repoda ne bulunduğunu değil.
AGENTS.md çalışma anlaşmasını belirler. MCP, Codex’in araçlara uzanmasını sağlar. Maguyva, Codex’e reponuzun sorgulanabilir bir haritasını veren MCP sunucusudur; böylece ilk düzenleme dosya yapısına dair bir tahmin olmaz.
Free katmanı: 3 repo, 50K'ya kadar dizinlenmiş repo satırı, kart gerektirmez.
AGENTS.md anlaşmadır. MCP kanaldır. Maguyva haritadır.Katmanlı yığın
Dört fikir. Her biri tek bir iş yapar.
// taşıma
MCP
Codex’in harici araçlara ve bağlama nasıl uzandığı.
// kod tabanı
Maguyva
Temellendirilmiş repo bilgilerini döndüren MCP sunucusu.
// kim ödüyor
Koltuk değil, çalışma alanı
Ajanlar koltuk için ödemez. Fiyatlandırmayı görün
AGENTS.md bir çalışma anlaşmasıdır. Onu kullanın.
Kalıcı talimatlar AGENTS.md içinde yer alır. Şunlar için doğru yerdir:
- Codex’in çalıştırması gereken derleme, test ve lint komutları.
- Bir dizine sınırlandırılmış “her zaman X yap / asla Y yapma” kuralları.
- Adlandırma kuralları ve refactor tercihleri.
- Kanonik karar günlüklerine ve mimari notlarına işaretçiler.
Kısa tutun. Kapsamını belirleyin. Commit’leyin.
Ama AGENTS.md hiçbir zaman reponuzdaki her sembolün, dosyanın ve çağrı noktasının sorgulanabilir bir dizini olarak tasarlanmadı.
Yalnız başına AGENTS.md’nin ölçekte statikleştiği yer
Dört başarısızlık modu, kart başına bir tane.
// anlaşmalar bir dizin değildir
Codex’e nasıl çalışacağını söylemek, ona repoda ne bulunduğunu söylemez. Bilinmeyen bir paketteki ilk düzenleme, dosya yolları ve fonksiyon isimleri hakkında bir tahmindir. AGENTS.md her sembolü listeleyemez, zaten bunu istemezsiniz.
// doküman koddan savrulur
Kuyruk topolojinizi açıklayan bir AGENTS.md bloğu, biri yeni bir tüketici ekleyene kadar doğrudur. Kod artık gerçeğin kaynağıdır ve doküman kendinden emin bir şekilde eskimiştir. Codex yanlış olanı okur.
// yeniden adlandırma bir graf problemidir
“Bu sınıfa ne referans veriyor?” bir markdown dosyasından yanıtlanamaz. Codex ya monorepo genelinde grep atıp dua eder ya da çağrı noktalarını sohbete yapıştırmanızı ister.
// bağlam pencereleri bedava değildir
Codex “yeterince bilene” kadar AGENTS.md’yi doldurmak, akıl yürütme için ödemesi gereken token’ları yer. Birkaç KB’ı geçtiğinizde statik bağlam hacmi için yanıt kalitesinden ödün verirsiniz.
Üç katman birlikte nasıl çalışır
Codex kullanıcıları zaten bu şekilde düşünüyor. Sayfa bunu bariz kılmalı.
AGENTS.md
anlaşmalar
Codex nasıl davranır
MCP
kanal
nasıl uzanır
Maguyva
kod tabanı bilgileri
ne görür
- AGENTS.md Codex’in bu repoda nasıl davrandığı.
- MCP Codex’in araçlara ve bağlama nasıl uzandığı. (spesifikasyon)
- Maguyva Codex, kod tabanına bir soru sorduğunda ne gördüğü. Dosya yolları ve satır numaralarıyla döndürülen anlamsal, AST, graf ve metin araması.
AGENTS.md Codex’e nasıl çalışacağını söyler.
Maguyva Codex’e üzerine çalışacak bir şey verir.
Üç iş akışı
Codex’e özgü. Codex’in grep’ine değil, gerçek çağrı grafına temellendirilmiş.
// workflow 01
Paylaşılan bir sınıfı yeniden adlandırın, önce her bağımlıyı bulun
codex> Şöyle yeniden adlandır: PaymentClient → BillingClient graph::callers(PaymentClient) 7 pakette 12 referans graph::importers(src/payments/client.ts) 9 içe aktaran graph::extends(PaymentClient) 2 alt sınıf (RetryClient, MockClient) → Codex, dosya listesini de içeren 21 düzenlemelik bir geçiş önerir. [exit 0]
Codex, düzenlemeye başlamadan önce Maguyva’dan bağımlıları ister. Geçiş listesi, Codex’in hatırladığına değil, gerçek grafa temellendirilmiş olarak döner.
// workflow 02
Test taslağını değil, gerçek uygulamayı bulun
codex> normalizePhoneNumber, E.164 biçimini nasıl işliyor? 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]
İsimler yalan söyler. Mock’lar gerçek kodu gölgeler. Maguyva, gerçek uygulamayı test mock’unun üzerinde sıralar.
// workflow 03
Bir refactor’dan önce etki yarıçapını kontrol edin
codex> QueueDispatcher.publish metodunu ne çağırıyor? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* [exit 0]
Paketler arası çağrı noktaları satır içinde ortaya çıkar. Diff, Codex’in grep’ine değil, gerçek import edenlere temellendirilir.
Codex CLI’de kurulum
Üç adım. Free katmanı: 3 repo, 50K'ya kadar dizinlenmiş repo satırı, kart gerektirmez.
-
// step 01
maguyva.ai’de bir repo dizinleyin
Yanıtları doğrulayabilmeniz için iyi bildiğiniz birini seçin.
-
// step 02
Codex yapılandırmanızda Maguyva’yı bir MCP sunucusu olarak ekleyin
export MAGUYVA_API_KEY=mgv_xxxx codex mcp add maguyva --url https://maguyva.tools/mcp --bearer-token-env-var MAGUYVA_API_KEY~/.codex/config.toml[mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY" -
// step 03
Yanıtını zaten bildiğiniz bir soru sorun
Tüm şirketinizle başlamayın. Bir repo ve doğrulanabilir bir soruyla başlayın.