AI Asistanlarının Kâbusu: Bağlam Kaybı ve Mycelium ile Çözümü

Geliştiriciler arasında giderek popülerleşen AI coding asistanları, işleri gerçekten kolaylaştırıyor. Ancak bu araçlarla biraz vakit geçirmiş olanlar bilir: bazen durum tam bir felakete dönüşebilir.

Claude Code, Cursor veya GitHub Copilot kullanıyorsanız muhtemelen şu sahneyi tanıyorsunuzdur: Yapay zeka asistanınız dosyadan dosyaya koşturarak doğru bağlamı bulmaya çalışıyor. Aradan yirmi dakika geçtiğinde kırk dosya açmış, yarısını unutmuş ve projenizin asıl mimarisini tamamen göz ardı eden değişiklik önerileri sunuyor.

Bu tanıdık geldi mi? Yalnız değilsiniz. AI destekli geliştirmede karşılaşılan en büyük sorunlardan biri tam olarak bu, ve bu sorunu çözmek için tasarlanmış yeni bir araç var: Mycelium.

Bağlam Sorunu

Şöyle düşünün: AI asistanları ancak kendilerine verilen bağlam kadar iyi çalışabilir. Doğru bilgiyi baştan verirseniz, zarif ve doğru kod yazarlar. Ancak alakasız dosyaları ardı ardına önlerine sererseniz, baştan sona yeniden yazılması gereken karmaşık bir kod çöplüğü üretirler.

Mesele şu ki, çoğu AI kodlama aracı proje yapınız hakkında neredeyse hiçbir şey bilmeden işe koyuluyor. Hangi dosyaların kimlik doğrulama işlemlerini yönettiğini, hangilerinin temel iş mantığını içerdiğini, hangilerinin ise dokunulmaması gereken eski kodlar olduğunu bilmiyorlar. Bu yüzden tahmin yürütüyorlar. Dosyaları alfabetik sırayla, import sırasına göre veya akla gelebilecek herhangi bir heuristiğe bağlı olarak açıyorlar. Sonuç: yavaş, verimsiz ve çoğu zaman işe yaramaz bir süreç.

Mycelium Sahneye Çıkıyor

Mycelium işleri farklı bir şekilde hallediyor. AI asistanınızın kod tabanında körü körüne dolaşmasına izin vermek yerine, tüm projenizin kapsamlı bir haritasını çıkarıyor — her dosyayı, her bağımlılığı, aralarındaki tüm bağlantıları. Asistanınız bir değişiklik yapması gerektiğinde, bu haritaya sorgu atıyor ve tam olarak ihtiyaç duyduğu dosyaları, her birinin ne işe yaradığını açıklayan düz İngilizce açıklamalarla birlikte geri alıyor.

İş akışı oldukça basit. Tek seferlik npx @kopikocappu/mycelium init komutunu çalıştırarak Mycelium'un tüm kod tabanınızı parse etmesini, tüm import'ları çözmesini ve bir bağımlılık grafiği oluşturmasını sağlıyorsunuz. Hatta her dosya için küçük bir AI modeli (Claude Haiku) kullanarak düz İngilizce açıklamalar yazıyor.

Ardından, asistanınız herhangi bir görev üstlenmeden önce, ne yapması gerektiğini belirten bir açıklamayla /preflight komutunu çağırıyor. Mycelium geriye dört dosya döndürüyor — kırk değil, sadece gerçekten önemli olan dört dosya.

Sadece Dosya Aramanın Ötesinde

Ama Mycelium basit bir dosya arama motorundan çok daha fazlası sunuyor. Takımlar için gerçekten işe yarar birçok özellik barındırıyor:

Canlı graf görüntüleyici sayesinde tüm kod tabanınızı tarayıcınızda görselleştirebiliyorsunuz. Dosyalar düğüm (node) haline geliyor, import'lar kenarlar (edge) oluyor ve projenizin mimarisini bir bakışta görebiliyorsunuz. Bir projeye yeni katılan geliştiriciler için bu özellik bile kurulum süresine değer.

Asistan değişiklik geçmişi özelliği, her dosya değişikliğini zaman damgaları, görev açıklamaları ve asistan kimliğiyle birlikte logluyor. AI kodlama araçlarından uzun süredir eksik olan bir audit trail'i bu şekilde oluşmuş oluyor. Artık AI asistanlarınızın tam olarak neyi, ne zaman değiştirdiğini görebiliyorsunuz.

Anlamsal arama ise dosyaları anahtar kelime yerine kavram bazında bulmanızı sağlıyor. "Ödeme işleme" diye aradığınızda, dosyaların hiçbirinde "ödeme" kelimesi geçmese bile Mycelium doğru dosyaları buluyor. Terminolojinin zaman içinde değiştiği büyük kod tabanlarında bu özellik gerçekten işe yarıyor.

Güvenebileceğiniz Bir Gizlilik

Kurumsal kullanıcılar için önemli bir detay: Mycelium localhost:47821 üzerinde yerel olarak çalışıyor. Kodunuz geliştirme ortamınızdan hiç ayrılmıyor. Proprietary mantığınızı analiz eden bir bulut servisi yok — karışmayan, yerel bir araç bu.

Kuruma Değer Mi?

Küçük projeler üzerinde çalışan bireysel geliştiriciler için Mycelium fazla abartılı olabilir. Kod tabanınız tanıdık olduğunuz birkaç dosyadan ibaretse, muhtemelen bir bağımlılık grafiğine ihtiyacınız yoktur.

Ancak takımlar için, büyük projeler için veya AI asistanınızın doğru dosyayı bulmak için yirmi dakika debelendiğini izleyen herkes için Mycelium gerçek bir verimlilik artışı sağlıyor. Bir kerelik kurulum maliyeti, AI asistanınızın bağlamı anlaması gereken her seferinde kendini amorti ediyor.

Vaat cazip: AI kodlama asistanınız sonunda gerçekten ne üzerinde çalıştığını anlıyor. Dört dosya. Sıfır tahmin. Mimajinize gerçekten uyan kod.

AI asistanlarının akıllı görünüp hedefi ıskaladığına canınız sıkılıyorsa, Mycelium aradığınız harita olabilir.