Bugün tek session'da 20 bug fixledim. Hepsi "review et" dedikten sonra çıktı. Bu genel olarak yaşadığım bir şey. Çözüm olarak CLAUDE.md'ye bi kural yazdım, aşağıda paylaşıyorum. Olan şu: B12 diye bir Claude Code'um için "memory" projem var. 17 dosyada aynı macOS path hardcode edilmiş. Claude'a fixle dedim, 1 dosyada fixledi, "bitti" dedi. Ama sonra review et diyince review agent'ı baktı: "16 dosyada daha aynı path var." Sonra os.getuid() fixledim, ama sadece baktığım dosyalarda. Review: "5 dosyada daha var." Sonra /tmp hardcode, 4 dosyada daha. 3 tur review, 20 fix. Hep aynı şey: bir yerde fixliyor, aynı pattern'ın başka dosyalarda olduğuna bakmıyor. Bu sadece Claude değil, GPT'de de Gemini'de de aynı. (Aşağıdaki ss'lerde kuralın çalışması görünüyor. Detayları görmek için Claude Code'da ctrl+o ile genişletebilirsiniz.) Bunun için bi kural yazdım. İki katmanlı: Birincisi her commit öncesi, 30 saniye sürüyor: - Edit'in etrafındaki 5 satıra bak, bişeyi bozmuş mu - Eski string'i tüm repo'da grep'le, 0 sonuç olmalı - Setup değiştirdiysen yeni kullanıcı kafasıyla düşün, git clone yapsa çalışır mı İkincisi aynı şeyi birden fazla dosyada değiştirdiysen, 2 dakika: - Eski pattern için grep at, kaçırdığın dosya var mı - DB path fixlediysen socket path'e de bak, PID path'e de bak (bunlara "platform kardeşi" diyorum) - os.getuid(), /tmp, config'lerdeki ~ gibi OS-specific şeyleri kontrol et Kuralın kendisi burada: 👉 https://gist.github.com/dorukardahan/0953d804685fb0ae9e57d17de049b496 Agent'ınıza gist linkini verip "bunu kural dosyama ekle" deyin, o hangi tool'u kullandığınızı bilir. Elle eklemek isterseniz: - Claude Code: CLAUDE.md - OpenClaw: AGENTS.md - Cursor: .cursorrules - Codex CLI: AGENTS.md - Windsurf: .windsurfrules Kural İngilizce çünkü agent'lar İngilizce talimatları daha iyi takip ediyor. Bunu koyduktan sonraki session'da fark gördüm. Sıfır hata demiyorum ama review'da çıkan sürpriz sayısı azaldı.