> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Bir kodlama ajanıyla geliştirin

Kodlama aracısına görevler verin: okuduğu dosyalar, dahil edilen beceriler ve sizi kontrolde tutan inceleme.

## Başlangıç seviyesinde izlenecek yol

Ön koşullar: aşağıdaki iki başlangıç kılavuzunu okuyun ve Mobile yerel kurulumunu tamamlayın. Bir kodlama aracısı, projenizi okuyan, dosyaları düzenleyen ve komutları çalıştıran bir AI aracıdır — Cursor, Claude Code, Devin veya benzeri bir asistan. Bu sayfadaki her şey hangi aracı kullanırsanız kullanın geçerlidir.

Kısa terimler: İstem, ajana yapıştırdığınız talimat metnidir. Diff, ajanın önerdiği dosya değişikliklerinin listesidir. Depo kökü, `package.json`'u içeren en üst klasördür — ajan her zaman oradan başlamalıdır.

1. Depo kökündeki `.agents/skills/`'i açın ve görevinize en yakın beceriyi kopyalayın — `add-a-mobile-screen` iyi bir ilk denemdir.

2. Bunu aracınıza yapıştırın ve değişikliğinizi açıklayın, ardından bir satır ekleyin: Koda dokunmadan önce `llms.txt`, sonra `AGENTS.md`, sonra `.ai/PROJECT_CONTEXT.md`'yi okuyun.

3. Ajanın düzenlemeye başlamadan önce değiştireceği dosyaları ve çalıştıracağı kontrolleri listelemesini isteyin. Bittiğinde diff'i gözden geçirin — ürününüzdeki gerçek değişiklikleri onaylıyorsunuz.

4. Yayınlama, mağaza gönderimi ve ücretli sağlayıcı çağrıları bir görev isteminin parçası asla olamaz. Açıkça onayladığınız ayrı adımlar olarak tutun.

[Başlamadan önce](https://supastack.dev/tr/docs/mobile/before-you-start.md)

[Terminal temelleri](https://supastack.dev/tr/docs/mobile/terminal-basics.md)

[Mobil yerel kurulum](https://supastack.dev/tr/docs/mobile/ship-in-5-minutes.md)


## Ajanınızın okuduğu dosyalar

Depo, yalnızca insanlar için değil ajanlar için de yazılmış küçük bir dosya yığınıyla gelir. Bu bağlamı asla elle yapıştırmazsınız — ajanı `llms.txt`'ye yönlendirin, gerisini kendisi okur.

Okuma sırası önemlidir: `llms.txt` haritadır, `AGENTS.md` sınırları belirler ve `.ai/PROJECT_CONTEXT.md` önceki oturumların öğrendiklerini taşır. Sınırları atlayan bir ajan, yayınlayamayacağınız kod üretir.

| Dosya | Ajana ne sağlar |
|---|---|
| `llms.txt` | Deponun giriş haritası, bu checkout'un gerçekten neler içerdiğini listelemek için oluşturuldu |
| `AGENTS.md` | Vazgeçilemez sınırlar: siz daha fazlasını onaylayana kadar yalnızca yerel çalışma, workspaceId kapsamı, yalnızca sunucuda kalan sırlar |
| `.ai/PROJECT_CONTEXT.md` | Oturumlar arası bellek — son zamanlarda ne ve neden değişti; kod değişikliklerinden önce okunur |
| `.ai/` ayna belgeleri | Önemli dosyaların yanında eşleşen bir .ai/<path>.md notu; dosya başına kararları ve açık konuları kaydeder |
| `.agents/skills/` | Araçlar için yazılmış görev çalıştırma kitapları — aşağıda listelenen altı Mobile becerisi |
| `docs/agent-security.md` | Kabul kontrol listesi — kimlik doğrulama, workspace ve izin kontrolleri, sansürlü günlükler |
| `docs/mobile-store-submission.md` | Mağaza sürümü çalıştırma kitabı — hesaplar, derlemeler, inceleme notları ve gönderim sırası |
| `.env.example` | Eksiksiz ortam envanteri — ajan bu dosyada bulunmayan bir değişken adını asla uydurmaz |


## Dahil edilen beceriler

`.agents/skills/` altındaki her dosya tam bir brief'tir: yapıştırın veya aracının okumasına izin verin ve kitin kuralları onunla birlikte taşınır — sunucu öncelikli veriler, pakette gizli bilgi yok, çevrimdışı yalnızca ağ hatası geri dönüşü.

Yapıştırılabilir `prompts/` kitaplığı yalnızca Web deposunda bulunur; bu checkout bunun yerine beceriler taşır. Gözetimsiz bir kurulum için agent-setup kılavuzundaki hazır istemi kullanın.

[Aracının kurulumu çalıştırmasına izin verin](https://supastack.dev/tr/docs/mobile/agent-setup.md)

- `add-a-mobile-screen` — bir ekranı, veri akışını ve çevrimdışı davranışını ekleyin veya değiştirin
- `adding-a-dependency` — bir npm bağımlılığını güvenli bir şekilde ekleyin, yükseltin veya taşıyın
- `reviewing-a-pr` — bir farkı doğruluk, workspace izolasyonu ve gizli bilgiler açısından inceleyin
- `upgrading-from-upstream` — daha yeni bir kit sürümünü uygulamanıza getirin
- `verify-changes` — teslimattan önce doğru kontrolleri seçin ve çalıştırın
- `writing-unit-tests` — yeni mantığı Vitest ile kapsayın


## Ajan oturumlar arasında nasıl hatırlıyor

Araçların oturumlar arasında belleği yoktur — `.ai/` klasörü bellektir. `.ai/PROJECT_CONTEXT.md`, son zamanlarda neyin değiştiğini ve nedenini kaydeder. Yanında, `.ai/apps/mobile/src/ideas/index.md` gibi bir yansıma belgesi, `apps/mobile/src/ideas/index.ts`nin arkasındaki kararları kodun tek başına gösteremediği şekilde açıklar.

Sözleşme basittir: bir dosyayı düzenlemeden önce aynasını okuyun ve değişiklik yerleştiğinde aynayı güncelleyin. Open Threads girdileri bitmemiş işleri kaydeder, böylece sonraki oturum baştan başlamak yerine kaldığı yerden devam eder. Güncelliğini yitirmiş bir ayna hiç olmamasından daha kötüdür — ajanın diff'ini incelerken, değişen dosyaların aynalarının da onunla birlikte güncellendiğini kontrol edin.


## Ajanın işini dürüstçe gözden geçirin

Tamamlanmış bir görev özet değil, kanıttır. Ajanın çalışmasını saklamadan önce, `docs/agent-security.md`'nin bir dağıtımı denetlediği şekilde denetleyin:

Bir şeyler yanlışsa diff'i geri gönderin — ajan, başarısız kontrolü adlandırdığınızda kendi işini en hızlı şekilde düzeltir. Tek başına asla denememesi gereken bir şey için bunu bir kez açıkça söyleyin; sınır oturumun geri kalanında geçerli kalır.

[Doğrulama kapıları ve test paketi](https://supastack.dev/tr/docs/mobile/testing.md)

- İddia ettiği testleri gerçekten çalıştırdı — sonuç değil, komutu ve çıktısını isteyin.
- Sırlar yalnızca sunucuda kaldı — hiçbir yeni değer `NEXT_PUBLIC_` veya `EXPO_PUBLIC_` öneki taşımıyor ve hiçbir anahtar bir rapora veya commit'e yazılmadı.
- Kullanıcıya ait her okuma ve yazma `workspaceId` ile kapsamlandı — hiçbir sorgu tarayıcının gönderdiği bir kimliğe güvenmiyor.
- Değişen her dosyanın `.ai/` aynası kodla birlikte ilerledi.
- Yayınlama, dağıtma ve ücretli sağlayıcı çağrıları sizin onayladığınız ayrı adımlar olarak kaldı — ajan asla kendi kendine birleştirmedi, göndermedi veya dağıtmadı.
- Bir adım iki kez başarısız olursa, etrafından dolaşmak yerine durup başarısız komutu bildirdi.


Kuruluma devam etmek için [Yerel kimlik doğrulama](https://supastack.dev/tr/docs/mobile/authentication.md) kılavuzunu okuyun.


## Sonraki

[Yerel kimlik doğrulama](https://supastack.dev/tr/docs/mobile/authentication.md)