Claude Architect · Ders

Artımlı İnceleme Örüntüsü

Giriş noktalarında Grep, dosyalarda Read, kullanımlarda Grep, tüketicilerde Read.

4. ders / 413 adım

Artımlı İnceleme Örüntüsü, CoddyKit'te ücretsiz bir Claude Architect dersidir. Bu, 4 dersinin 4. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Claude Architect öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Claude Architect kursu toplamda 4 dersten oluşur.

Neden Artımlı İnceleme Yapılmalı

Claude Code tanımadığınız bir kod tabanına geldiğinde her dosyayı bağlama yığmak israfa yol açar ve güvenilir değildir. Büyük veri yığınları ortada kaybolma etkisini tetikler: model bağlamın ortasına kıyasla başına ve sonuna çok daha fazla odaklanır; bu nedenle dev bir yapıştırmanın içine gömülmüş bilgiler gözden kaçar.

Artımlı İnceleme Deseni bu sorunu çözer. Her şeyi yüklemek yerine Claude, doğrulanmış her adımda anlayışı bilinçli bir zincirle genişletir ve yalnızca önemli dosyaları getirir.

Dört Adımlı Zincir

Yerleşik araçlar için temel döngü şöyledir:

Giriş noktalarında Grep — bir özelliğin nerede başladığını bulmak için dosya içeriklerinde arama yapın.
Dosyaları Read ile okuyun — tanımı anlamak için eşleşen dosyaları yükleyin.
Kullanımlarda Grep — bu sembolün başvurulduğu tüm yerleri arayın.
Tüketen kodu Read ile okuyun — gerçekte nasıl kullanıldığını görmek için çağrı noktalarını açın.

Her adım, önceki adımdan elde edilen kanıtı kullanarak arama alanını daraltır. Hangi dosyaların önemli olduğunu asla tahmin etmezsiniz — bunu size kod tabanı söyler.

# Conceptual flow with Claude Code built-in tools
# 1) Grep -> find entry points
# 2) Read  -> the matched definition files
# 3) Grep -> usages of the symbol
# 4) Read  -> the consumer / call-site files

Kullanacağınız Yerleşik Araçlar

Bu desen Claude Code'un yerleşik araçlarına dayanır. Her birinin ne yaptığını tam olarak bilin:

Glob — ad kalıbına göre dosya bulur; örneğin **/*.test.tsx.
Grep — dosya içeriklerinde arama yapar.
Read — tek bir dosyayı bağlama yükler.
Edit — hassas, benzersiz eşleşmeli bir değişiklik yapar.
Bash — kabuk komutlarını çalıştırır.

Artımlı inceleme neredeyse tamamen Grep ve Read üzerine kuruludur — keşfetmek için arayın, doğrulamak için okuyun.

1. Adım — Giriş Noktasında Grep Kullanma

Özelliği sabitleyen sembolü veya dizeyi arayarak başlayın. Henüz her geçtiği yeri değil, tanımı bulmaya çalışıyorsunuz. Odaklı bir sorgu, sonuç kümesini küçük ve ilgili tutar.

İçeriklerde arama yapmak (Grep), dizinleri gelişigüzel açmaktan daha etkilidir: eşleşme sizi doğrudan ilgilendiğiniz davranışı tanımlayan dosyaya götürür.

# Find where the checkout handler is defined
# Grep tool query:
#   pattern: "def process_checkout"
#   glob:    "**/*.py"
# -> returns: billing/checkout.py:42

2. Adım — Tanımı Read ile Okuma

Yalnızca Grep'in ortaya çıkardığı dosyayı (veya dosyaları) açın. Şimdi gerçek uygulamayı okuyorsunuz: girdilerini, döndürülen değerlerini ve bağlı olduğu diğer sembolleri inceliyorsunuz. Bu bağımlılıklar sonraki aramanız için başlangıç noktaları olur.

Bu, desenin disiplinidir — her yüklediğiniz dosyanın daha önceki kanıtlarla gerekçelendirilmesi için Grep'ten sonra Read kullanırsınız.

# Read tool:
#   file_path: billing/checkout.py
#
# You learn: process_checkout() calls
#   - validate_cart()
#   - charge_card()
# These become your next Grep targets.

3. Adım — Kullanımları Grep ile Bulma

Şimdi yönü değiştirin. Tanımı anladınız; sırada onu kimin çağırdığını bulmak var. Her tüketiciyi listelemek için sembol adını kod tabanında Grep ile arayın.

Bu, güvenli bir değişiklik için önemli soruların yanıtını verir: Kaç çağrı noktası var? Argümanları doğru şekilde mi iletiyorlar? Burada yapacağınız bir düzenleme dışarıya doğru yayılarak başka yerleri etkiler mi?

# Grep tool query:
#   pattern: "process_checkout\("
#   glob:    "**/*.py"
# -> api/routes.py:88
# -> tasks/retry_jobs.py:19
# -> tests/test_checkout.py:55

4. Adım — Tüketicileri Okuma

Kullanım aramasının Grep ile döndürdüğü çağrı noktalarını açın. Tüketicileri okumak, yalnızca tanımın gösteremeyeceği gerçek kullanım davranışlarını ortaya çıkarır: uç durumlar, hata işleme ve her çağırıcının yaptığı varsayımlar.

Tanımı ve tüketicileri anladığınızda, tüm depoyu yüklemeden kanıta dayalı, eksiksiz bir görünüm elde edersiniz.

# Read tool on each consumer:
#   api/routes.py        -> HTTP entry, validates auth first
#   tasks/retry_jobs.py  -> retries failed charges
#   tests/test_checkout  -> documents expected contract
# Now an Edit is safe and well-scoped.

İlerledikçe Araç Çıktısını Kısaltın

Grep ve Read ayrıntılı çıktılar döndürebilir. Bunların birikmesine izin vermeyin — ayrıntılı araç çıktısını, bağlam pencerenizi doldurmadan önce ilgili alanlarla sınırlayın.

Bağlamı yalın tutmak, ortada kaybolma sorunuyla doğrudan mücadele eder: daha küçük ve daha odaklı bir bağlam, topladığınız bilgilerin gürültünün altında gömülmek yerine modelin dikkatine yakın kalmasını sağlar. Her adım hacim değil, bilgi değeri eklemelidir.

Glob mu Grep mi — Doğru Kapıyı Seçin

İki keşif aracı, iki farklı görev:

Dosyanın biçimini bildiğinizde Glob kullanın — "tüm sınama dosyaları", "her geçiş" — örneğin **/*.test.tsx.
Kodun içinde bir sembolü veya dizeyi bildiğinizde ve bunun nerede bulunduğunu ya da kimler tarafından kullanıldığını bulmanız gerektiğinde Grep kullanın.

Artımlı inceleme genellikle Grep ile başlar (bir sembolün peşindesinizdir) ve dosya türüne göre kapsam belirlemek istediğinizde Glob'a başvurur.

# Glob: enumerate by pattern
#   pattern: "src/**/*.controller.ts"
# Grep: enumerate by content
#   pattern: "checkout", glob: "src/**/*.ts"

Sabit Bir İşlem Hattı Değil, Uyarlanabilir

Adımlar biliniyor ve sıralıysa sabit bir işlem hattı / istem zinciri kullanın. Ancak inceleme açık uçludur; bu nedenle bu kalıp en iyi uyarlanabilir ayrıştırma ile yürütülür — model, son adımın ortaya çıkardıklarına göre bir sonraki Grep veya Read adımını seçer.

Bunu aracı döngüsü üzerinden yürütün: her araç sonucu stop_reason: "tool_use" döndürür, sonucu geçmişe eklersiniz ve model bir sonraki hamleye karar verir. end_turn geldiğinde sonlandırın — asla metni "done" gibi sözcükler için tarayarak sonlandırmayın.

while True:
    resp = client.messages.create(
        model="claude-opus-4-1",
        max_tokens=2048,
        messages=history,
        tools=[grep_tool, read_tool, glob_tool],
    )
    if resp.stop_reason == "end_turn":
        break  # model decided investigation is complete
    # stop_reason == "tool_use": run tool, append result, loop
    history.append(run_tools(resp))

İnceleme Aracısının Kapsamını Belirleyin

İncelemeyi bir alt aracıya devrederseniz ona sıkı biçimde sınırlandırılmış bir araç kümesi verin. Aracı başına 4-5 araç en uygunudur; 18 veya daha fazlası seçim güvenilirliğini düşürür. Bir inceleyicinin Glob, Grep ve Read'den fazlasına genellikle ihtiyacı yoktur.

En az ayrıcalık ilkesini uygulayın: salt okunur bir gezginin Edit, Write veya Bash yetkisi OLMAMALIDIR. Ayrıca alt aracıların koordinatörün geçmişini devralmadığını unutmayın — hedef sembolü, amacı ve önceki bulguları istemde açıkça iletin.

explorer = AgentDefinition(
    name="code-explorer",
    description="Read-only incremental investigation of a symbol",
    system_prompt="Grep entry points -> Read -> Grep usages -> Read consumers. Report findings only.",
    allowed_tools=["Glob", "Grep", "Read"],  # least privilege, no Edit/Write
)

Hızlı Kontrol

Kalıbın temel kararını ne kadar kavradığınızı sınayın.

İnteraktif derste cevapla

Özet — İnceleme Disiplini

Temel çıkarımlar:

Giriş noktalarını Grep ile bul → dosyaları Read ile oku → kullanımları Grep ile bul → tüketicileri Read ile oku. Her adımı kanıt yönlendirir.
Tüm depoları yüklemekten kaçının — büyük bağlam ortada kaybolmaya neden olur; araç çıktısını ilgili alanlarla sınırlayın.
Grep içerikteki sembolleri bulur; Glob dosyaları kalıba göre bulur.
Bunu aracı döngüsü üzerinden uyarlanabilir bir inceleme olarak çalıştırın; end_turn ile sonlandırın, "done" gibi bir metinle veya katı bir yineleme sınırıyla asla sonlandırmayın.
Devredilen gezgin salt okunur kalır (Glob, Grep, Read), 4-5 araçla sınırlı tutulur ve tüm bağlam kendisine açıkça iletilir.

Bir mimar gibi inceleyin: keşfetmek için arayın, doğrulamak için okuyun, güvenle düzenleyin.

Başlamak ücretsiz

Yapay zeka eğitmeniyle Python öğren — ücretsiz

Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.

Kurslar: 26
Dersler: 104

Ücretsiz öğrenmeye başla Tüm kursu görüntüle

Sıkça Sorulan Sorular

“Artımlı İnceleme Örüntüsü” dersi ücretsiz mi?

Evet — “Artımlı İnceleme Örüntüsü” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Claude Architect kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Claude Architect kursu toplamda 4 dersten oluşur.

“Artımlı İnceleme Örüntüsü” dersinde ne öğreneceğim?

Giriş noktalarında Grep, dosyalarda Read, kullanımlarda Grep, tüketicilerde Read. Claude Architect ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Claude Architect öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Claude Architect, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 4. dersidir.

“Artımlı İnceleme Örüntüsü” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Claude Architect dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Claude Architect dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Claude Architect Sayfasına Dön