Unutulan Symlink: 'Çalışıyor' Bakımlı Olmakla Aynı Değildir
ai-assistant-dot-files deposunda Cursor için önceden kurulmuş ama unutulmuş symlink'ler, çalışan kodun bakımlı kod anlamına gelmediğini gösteriyor.
Çapraz araç AI yapılandırma deposu ai-assistant-dot-files'a Cursor için native ajan ve yetenek desteği eklenirken, .cursor/agents ve .cursor/skills dizinlerinin zaten shared/agents ve shared/skills'e symlink olarak bağlı olduğu ortaya çıktı. Bu symlink'ler 2026-04-09'da commit edilmişti ama zamanla sistemin tasarım hafızasından silinmişti.
Repo, Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini/Antigravity ve OpenAI Codex için tek kanonik doğruluk kaynağına (shared/) dayanıyor; platforma özgü dosyalar ya symlink ya da üretilmiş kopyalardan oluşuyor. Cursor native agent/skill desteği gelmeden önce yazılan bu symlink'ler capability tier sistemine, parity kontrolüne ve platform kayıt dosyasına hiç dahil edilmemişti; yani doğru bir tasarım kararı vardı ama sistemin geri kalanı onu korumuyordu.
Çözüm yeni symlink yaratmak değil, mevcut olanı görünür ve doğrulanabilir kılmaktı: mimari dokümantasyonu güncellendi, platform kayıt dosyasına Cursor'ın karma stratejisi eklendi, kurulum betiği symlink'leri otomatik oluşturacak hale getirildi, parity kontrol betiği bu symlink'lerin sessizce kaybolmasını engelleyecek şekilde genişletildi ve README'deki yetenek matrisi gerçek davranışı yansıtacak biçimde düzeltildi.
Asıl ders, mühendislikte 'çalışıyor'un zayıf bir güvence olduğu: doğruluk kaynağı adlandırılmalı, projeksiyon mekanizmaları belgelenmeli, platform yetenek farkları açıkça ifade edilmeli ve parity kontrolleri drift'i yakalamalı. Cursor için sonuç artık karma bir strateji: ajan ve yetenekler symlink, kurallar ise tamamen gömülü üretilmiş dosyalar - daha az zarif ama çok daha gerçekçi.