Tips · CLAUDE.md & rules

01

agent teams with tmux ve git worktrees ile paralel geliştirme
kaynak ↗
02

Herhangi bir geliştirici Claude'u başlatıp "testleri çalıştır" dediğinde ilk denemede çalışmalıdır — eğer çalışmıyorsa, CLAUDE.md dosyanızda temel kurulum/derleme/test komutları eksik demektir.
kaynak ↗
03

Her skill'de bir Gotchas bölümü oluşturun — en yüksek sinyalli içerik, zamanla Claude'un başarısızlık noktalarını ekleyin.
kaynak ↗
04

CLAUDE.md dosyası, dosya başına 200 satırın altında hedeflenmelidir. humanlayer'da 60 satır (yine de %100 garanti değil)
kaynak ↗
05

.claude/rules/*.md dosyaları, CLAUDE.md gibi her oturuma otomatik olarak yüklenir — yalnızca Claude, glob ile eşleşen dosyalara dokunduğunda tembel yükleme yapmak için paths: YAML frontmatter ekleyin.
kaynak ↗
06

Claude'u skill'lerde dar kalıplara sokmayın — adım adım buyurgan talimatlar değil, hedefler ve kısıtlamalar verin 🚫👶
kaynak ↗
07

becerilerde bariz olanı belirtme — Claude'u varsayılan davranışının dışına iten şeylere odaklan 🚫👶
kaynak ↗
08

!command'i SKILL.md dosyasına gömerek dinamik shell çıktısını prompt'a enjekte edin — Claude bunu çağrıldığında çalıştırır ve model yalnızca sonucu görür.
kaynak ↗
09

Özellik spesifik alt-ajanlar (ekstra bağlam) ve beceriler (aşamalı açıklama) kullanın, genel QA veya backend mühendisi yerine.
kaynak ↗
10

Günde birden fazla kez yaptığın bir işi skill veya command haline getir — /techdebt, context-dump veya analytics gibi komutlar oluştur.
kaynak ↗
11

Yeteneklere script ve kütüphaneleri dahil edin, böylece Claude tekrar tekrar şablon kod yazmak yerine bunları birleştirerek kullanır.
kaynak ↗
12

kod tabanlarını temiz tut ve geçişleri tamamla — kısmen taşınmış framework'ler, yanlış kalıbı seçebilecek modellerin kafasını karıştırır
kaynak ↗
13

"use subagents" diyerek bir soruna daha fazla işlem gücü harcayın — ana context'inizi temiz ve odaklı tutmak için görevleri devredin 🚫👶
kaynak ↗
14

skill açıklama alanı bir tetikleyicidir, özet değil — model için yazın ("ne zaman ateşlemeliyim?").
kaynak ↗
15

beceriler (skills) klasörlerdir, dosya değil — aşamalı açıklama için references/, scripts/, examples/ alt dizinlerini kullanın
kaynak ↗
16

.claude/rules/ kullanarak büyük talimatları bölün.
kaynak ↗
17

İş akışlarınızda sub-agent yerine commands kullanın.
kaynak ↗
18

context: fork kullanarak bir skill'i izole bir sub-agent içinde çalıştırabilirsiniz — ana context yalnızca nihai sonucu görür, ara tool çağrılarını görmez. agent alanı, sub-agent türünü belirlemenizi sağlar.
kaynak ↗
19

Monorepo'lar için birden fazla CLAUDE.md kullanın — üst + alt yükleme
kaynak ↗
20

Harness tarafından zorunlu kılınan davranışlar (atıf, izinler, model) için settings.json kullanın — attribution.commit: "" deterministik olduğunda CLAUDE.md dosyasına "ASLA Co-Authored-By ekleme" yazmayın.
kaynak ↗
21

Monorepo'lar için alt klasörlerdeki skill'leri kullanın.
kaynak ↗
22

Her "inner loop" iş akışınızda, günde birçok kez yaptığınız işlemler için slash commands kullanın — tekrarlayan prompt'ları ortadan kaldırır, komutlar .claude/commands/ dizininde yaşar ve git'e commit edilir.
kaynak ↗
23

test time compute kullanın — ayrı context pencereleri sonuçları iyileştirir; bir agent hatalara neden olabilir ve başka bir agent (aynı model) bunları bulabilir
kaynak ↗
24

Alan adına özgü CLAUDE.md kurallarını, dosyalar uzadıkça Claude'ın bunları görmezden gelmesini engellemek için <important if="..."> etiketleri ile sarın.
kaynak ↗

← Tüm tips