imece ve CLAUDE.md, AGENTS.md
Karşılaştırma · Son güncelleme: 10 Ekim 2026
CLAUDE.md, AGENTS.md ve Cursor rules, agent'ına önceden verdiğin talimatlardır. imece ise agent'lar çalışırken ekibin kararlarını, gerekçelerini ve handoff'larını kaydeder. İkisi farklı iş yapar ve birlikte kullanılabilir. Bu sayfa farkı 10 Ekim 2026 itibarıyla anlatıyor.
Hangisi ne için
İkisini birlikte kullan. Talimat dosyaları ekibin sabit kurallarını taşır. imece, iş sürerken ekibin verdiği kararları ve handoff'ları taşır.
- CLAUDE.md, AGENTS.md ve Cursor rules: build komutları, kod stili, repo yapısı gibi her session'da geçerli proje kuralları. Statik kurallar için doğru araç bunlar.
- imece: dünkü karar, gerekçesi, birinin deneyip bıraktığı yaklaşım, yarım kalan iş, başka bir role handoff edilen iş. Bunlar gün gün değişir.
CLAUDE.md nasıl çalışıyor
Anthropic'in dokümanına göre her Claude Code session'ı temiz bir context window ile başlar. CLAUDE.md, Claude'un her session'a senin talimatlarınla başlaması için yazdığın dosyadır.
- Düzeyler: organizasyon (managed policy), kullanıcı (
~/.claude/CLAUDE.md), proje (./CLAUDE.md ya da ./.claude/CLAUDE.md, source control ile paylaşılır) ve yerel (./CLAUDE.local.md, .gitignore'a eklenir). - Çalışma dizinindeki ve üstündeki dizinlerdeki dosyalar session başında yüklenir. Alt dizinlerdeki dosyalar, Claude orada bir dosya okuyunca ya da düzenleyince yüklenir.
@path/to/import ile başka dosyalar içeri alınır; en fazla dört seviye. İçeri alınan dosyalar da session başında yüklenir..claude/rules/ altındaki kurallar, paths alanıyla belirli dosya desenlerine bağlanabilir.- Doküman, her CLAUDE.md için 200 satırın altını öneriyor.
- Doküman CLAUDE.md'yi zorunlu bir ayar olarak değil, context olarak ele alıyor: Claude onu okur ve uymaya çalışır, ama sıkı uyum kesin değil. Bir işi Claude'un kararından bağımsız engellemek için
PreToolUse hook'una yönlendiriyor. - Auto memory ayrı bir özellik: Claude'un kendi için yazdığı notlar. Bu notlar o makinede
~/.claude/projects/<project>/memory/ altında durur ve makineler arasında paylaşılmaz.
AGENTS.md nasıl çalışıyor
- Biçim: düz Markdown, zorunlu alan yok.
- Monorepo'da her paketin kendi
AGENTS.md'si olabilir. Talimatlar çakışırsa düzenlenen dosyaya en yakın olan kazanır. - Site, dosyayı destekleyen araçlar arasında Codex, Cursor, Gemini CLI, Jules ve Aider'ı sayıyor. Yönetimi Linux Foundation çatısındaki Agentic AI Foundation yapıyor.
- Claude Code, Anthropic'in dokümanına göre (v2.1.277 ve sonrası) çalışma dizininde ve üstünde
CLAUDE.md yoksa AGENTS.md'yi okur. İkisi de varsa varsayılan olarak yalnız CLAUDE.md okunur; ikisini birlikte okutmak için /config içinde bir ayar var.
Cursor rules nasıl çalışıyor
- Proje kuralları
.cursor/rules altında .mdc dosyaları olarak durur ve version control'e girer. Oradaki düz .md dosyası yok sayılır. - Bir kural her chat'e uygulanabilir, açıklamasına bakıp Agent ilgili bulunca uygulanabilir, dosya desenine uyunca uygulanabilir ya da
@kural-adı ile elle çağrılabilir. - Kural içeriği model context'inin başına eklenir. Doküman kurallar için 500 satırın altını öneriyor.
- User Rules, tüm projeler için kişisel tercihlerdir. Team Rules dashboard'dan yönetilir ve Team ile Enterprise planlarında bulunur. Çakışmada önce Team Rules, sonra Project Rules, sonra User Rules geçerli.
- Cursor, proje kökünde ve alt dizinlerde
AGENTS.md'yi de destekliyor. - Kurallar Cursor Tab'i ve diğer AI özelliklerini etkilemez.
imece ne yapıyor
imece, agent'ına MCP araçları ve hook'lar ekler. Agent bir karar verdiğinde ya da bir yaklaşımdan vazgeçtiğinde imece bunu kaydetmesini ister; ekip arkadaşlarının agent'ları ilgili kaydı sonra görür.
- Yazma: agent kararları, biten işi, öğrenilenleri, denenip bırakılan yaklaşımları, yarım kalan işi ve bir role verilen handoff'ları kaydeder. Ekibin kayıtlarında arama da yapabilir.
- Okuma: Claude Code'da imece, ekibin ilgili kayıtlarını agent çalışırken context'ine ekler.
- Codex ve Cursor session'larını masaüstü uygulamasından açtığında imece'nin MCP sunucusu o session'a bağlanır.
- Ekip arkadaşının yazdığı metin agent'a talimat olarak değil, veri olarak işaretli ulaşır.
- Kayıtlar ekip üyelerinin cihazlarında tutulur ve ekip içinde senkronlanır. Kişisel olarak işaretlenen kayıtlar makinenden çıkmaz.
- imece projende git'e girmeyen bir
.imece/ klasörüne okunabilir bir kopya yazar. CLAUDE.md'ni değiştirmez.
imece nasıl çalışır
Fark nerede
- Kim yazıyor: talimat dosyalarını sen ve ekibin yazarsın. imece kayıtlarını agent yazar; ekip arkadaşların da masaüstü uygulamasından ekip kanalına yazar ve handoff gönderir.
- Kime ulaşıyor: proje
CLAUDE.md'si repoyu çeken herkese gider. imece kayıtları ekip üyelerinin makineleri arasında senkronlanır; handoff bir role gider ve o rolü taşıyan üyeler görür. - Context'e ne zaman giriyor: talimat dosyaları session başında yüklenir, alt dizinlerdekiler istek üzerine. imece, iş sürerken ilgili olanı ekler.
- Agent nasıl okuyor: CLAUDE.md talimat olarak yazılır. imece kayıtları talimat olarak değil, veri olarak işaretlenir.
- Nerede duruyor:
CLAUDE.md repoda durur, git ile paylaşılır ve sürümlenir. imece kayıtları repoda durmaz; ekip içeriği imece'nin Almanya'daki sunucularında ve ekip üyelerinin cihazlarında tutulur.
Birlikte nasıl kullanılır
- Build komutları, kod stili, repo yapısı ve diğer sabit kurallar
CLAUDE.md, AGENTS.md ya da Cursor rules'ta kalsın. - Dünkü kararlar, gerekçeleri, bırakılan yaklaşımlar ve handoff'lar imece'de dursun.
- Bir karar kalıcı bir proje kuralına dönüşürse onu
CLAUDE.md'ye ya da AGENTS.md'ye taşı. - imece, Claude Code ayarlarındaki başka araçların girdilerine dokunmaz; kaldırınca yalnız kendi girdilerini siler.
Sınırlar
- Bunlar kilit değil. Anthropic'in dokümanı CLAUDE.md'yi context olarak ele alıyor; Claude ona uymayabilir. imece'nin eklediği kayıtlar da context: agent onları görür ama kendi yolunda gidebilir. imece agent'ın işini engellemez.
- Agent kaydı yazmayabilir. imece agent'tan kaydetmesini ister, ama agent kaydetmezse kayıt oluşmaz.
- Kullanıcı ilgisiz bir şey sorduğunda agent bekleyen bir handoff'u kendiliğinden gündeme getirmeyebilir.
- imece servisi çalışmıyorsa ya da geç kalırsa o turda context'e bir şey eklenmez; agent beklemeden devam eder.
- Kayıtlar eskiyebilir. imece eskimiş kayıtların bir kısmını işaretler, hepsini yakalamaz.
- imece kapalı betada, erişim talebiyle giriliyor; masaüstü uygulaması macOS ve Windows'ta çalışıyor.