Expo'nun Claude için yazdığı dosyalar

Proje klasörünü bir dosya gezgininde aç ve gizli dosyaları göster. Beklediğin şeylerin yanında — app, package.json, app.json — istemediğin üç tane daha var.

create-expo-app onları varsayılan olarak yazıyor ve bu, bu kursun ne olduğunu değiştiriyor: bir ajanı mobil uygulama yapmaya yönlendirmek artık akıllıca bir numara değil, üreticinin desteklediği çalışma biçimi. Onlar olmadan bir proje istersen, npx create-expo-app@latest --no-agents-md üçünü de atlıyor.

Her biri ne işe yarıyor

AGENTS.md, ajanı projenin SDK sürümüne uyan Expo belgelerine yönlendiriyor. Bu cümle göründüğünden değerli: modeller daha eski Expo üzerine eğitildi ve yapay zekânın yazdığı Expo kodunun çoğu iki, üç ya da dört SDK sürümü geride ve kendinden emin biçimde yanlış. Bu dosya o düzeltme.

CLAUDE.md tek bir satır içeriyor: @AGENTS.md. Bu, AGENTS.md'yi Claude Code'un bağlamına aktarıyor.

.claude/settings.json, Claude Code eklenti pazarındaki resmî Expo eklentisini önceden etkinleştiriyor.

Bir yerine üç dosya var, çünkü her biri farklı bir ajan geleneğini hedefliyor; böylece aynı proje, ajana özel hiçbir yapılandırma olmadan Claude Code, Codex ya da Cursor ile çalışıyor.

Tek bir import tutuyorsa CLAUDE.md neden var peki? Çünkü Claude Code AGENTS.md'yi değil, CLAUDE.md'yi okuyor. Anthropic'in belgeleri tam olarak bu deseni öneriyor: bir depo başka ajanlar için zaten AGENTS.md kullanıyorsa, onu içeri aktaran bir CLAUDE.md oluştur ki her iki araç da aynı talimatları çoğaltmadan okusun. Bir symlink de işe yarardı, ama Windows'ta symlink Yönetici hakları ya da Geliştirici Modu istiyor. Import istemiyor.

Yani kursun geri kalanı için kural şu ve bu Expo'nun kendi tavsiyesi:

Proje talimatlarını CLAUDE.md'ye değil, AGENTS.md'ye koy. Tek yer, her ajan, çoğaltma yok.

İlk düzenlemen

AGENTS.md yazıldığı hâliyle Expo'yu biliyor. Seni bilmiyor: Windows'ta olduğunu, bu makinede emülatör olmadığını, test cihazının masandaki telefon olduğunu.

AGENTS.md'yi herhangi bir metin düzenleyicide aç — Not Defteri olur — ve en alta şu dört kuralı ekle.

## Bu projenin makinesi
 
- `npx expo start` ile fiziksel bir Android cihazda çalıştır. Bir emülatör ya
  da simülatörün mevcut olduğunu asla varsayma.
- Paketleri `npm install` ile değil, her zaman `npx expo install <paket>` ile
  kur; böylece sürümler SDK ile eşleşir.
- Bu proje Windows'ta geliştiriliyor. Asla Xcode, CocoaPods ya da
  `npx expo run:ios` önerme.
- Bana önce sormadan `npx expo prebuild` çalıştırma.

Her satır belirli bir şeyi engelliyor. Birincisi 2. dersteki dört saatlik emülatör sapmasını durduruyor. İkincisi okunduğundan daha önemli: npx expo install SDK'na uyan paket sürümünü seçiyor, npm install en yenisini seçiyor ve bu uyumsuzluk, bir Expo build'inin kimsenin açıklayamadığı sebeplerle çökmesinin en yaygın nedeni. Üçüncüsü, çalıştıramayacağın bir makinede Xcode açman söylenmesinden kurtarıyor. Dördüncüsü bir korkuluk — SDK 57 itibarıyla expo prebuild varsayılan olarak yerel klasörleri siliyor ve yeniden üretiyor.

Dosyayı kısa tut. Anthropic'in tavsiyesi 200 satırın altı — daha uzun dosyalar daha fazla bağlam tüketiyor ve uyumu düşürüyor; bir ajanın kesinlikle yazdığın bir talimatı bazen görmezden gelmesinin gösterişsiz sebebi bu.

4. modül buraya bir kural daha ekliyor: Claude'un izin vermediğin build'lere paranı harcamasını durduran kural. Harcanacak para olana kadar bekleyebilir.

Claude'u projenin içinde başlat

1. dersteki hesabın önem kazanmaya başladığı yer burası: buradan sonra Claude'un klasörün içinde çalışması ve dosyalarını okuyup yazması gerekiyor, bu da abonelik ya da Console kredisi istiyor.

claude

Claude Code, CLAUDE.md'yi başlatıldığı klasörden ve üstündeki her klasörden okuyor; yani onu burada başlatmak @AGENTS.md'yi ve dört kuralını yükleyen şey. Bir üst dizin hiçbir şey yüklemiyor ve elinde hangi makinede olduğuna dair fikri olmayan, kendinden emin bir ajan oluyor.

Ona cevabı kontrol edilebilir bir soru sor:

AGENTS.md'yi oku ve bu makineyle ilgili eklediğim dört kuralı, her birini tek cümleyle bana söyle.

Dört kuralınla geri dönerse zincir çalışıyor. Expo hakkında genel bir şeyle dönerse yanlış klasörde başlatmışsın.

Eklenti ve MCP sunucusu

Birinci taraf iki parça daha var ve ikisi de 4. modülde gerçekten kullanışlı hâle geliyor.

Resmî Claude Code eklentisi, Expo'nun skill'lerini kuruyor ve Expo'nun MCP sunucusunu tek adımda kaydediyor. Bir oturumun içinden /plugin install expo@claude-plugins-official ile çalıştır. Skill'ler slash komutu olarak çağrılmak yerine konuşmadan keşfediliyor, yani ezberlenecek bir liste yok.

Expo MCP sunucusu https://mcp.expo.dev/mcp adresinde yaşıyor ve ajana güncel Expo belgelerine canlı erişim, build geçmişin ve — sonradan önemli olan kısım — çalışan uygulamanın ekran görüntüsünü alıp üzerine dokunma yeteneği veriyor. Bu, 4. modülün imza dersi ve yapay zekâyla uygulama yapmaya yönelik en eski şikâyetin cevabı: modelin telefonu göremediği şikâyetinin.