Modern yazılım geliştirmede, kodlama oturumları arasında bağlamı korumak verimlilik için çok önemlidir. Cline Memory Bank özelliği, oturum sıfırlamasından sonra bile temel proje ayrıntılarını korumasına izin vererek Cursor AI aracısını geliştirir. Bu, önemli kalıpların, kararların ve ilerlemenin korunmasını sağlayarak sorunsuz bir iş akışı sağlar. Bu kılavuzda, geliştirme sürecinizi optimize etmenize yardımcı olarak, Cursor'da Cline Memory Bank'i nasıl etkinleştireceğinizi ve yapılandıracağınızı anlatacağız.
Cline Memory Bank Özelliği Nedir?
Cline Memory Bank özelliği, Cursor AI aracısı içinde kalıcı proje bilgisini korumaya yönelik sofistike bir yaklaşımdır. Cursor gibi yapay zeka asistanları, oturumlar arasında doğal olarak bellek tutmadığından, Memory Bank, geliştiricilerin kapsamlı proje bağlamını, ilerleme geçmişini, mimari kararları ve temel teknik özellikleri belgelemelerine ve korumalarına olanak tanıyan yapılandırılmış bir bilgi deposu görevi görür.
Memory Bank, temel olarak yapay zeka asistanınız için, tam bir sıfırlamadan sonra bile projenizin inceliklerine hızla yeniden aşina olmasını sağlayan harici bir "beyin" gibi işlev görür. Memory Bank, Markdown dosyalarının hiyerarşik bir sisteminden yararlanarak proje bilgisini şu şekilde düzenler:
- Proje mimarisi ve tasarım kararları hakkında kritik bağlamı korur
- Zaman içinde kodun ve özelliklerin evrimini belgeler
- Proje özelinde sözleşmelerin ve gereksinimlerin farkında kalır
- Tekrarlayan açıklamaları ve kod tabanınıza yeniden girişleri azaltır
- Yapay zekanın daha tutarlı ve bağlamsal olarak alakalı yardım sağlamasını sağlar
Bu özellik, Anthropic'in Claude AI asistanından (özellikle Cline) esinlenmiştir ve benzer bir bellek yönetimi yaklaşımı kullanır, ancak Cursor'un özel ortamı ve iş akışı için uyarlanmış ve optimize edilmiştir.
Cursor'un yeteneklerini daha da genişletmek için, yapay zeka destekli IDE'nizin API özelliklerinize doğrudan Apidog projelerinden erişmesini sağlayan Apidog MCP Sunucusunu entegre edebilirsiniz.
Bu güçlü entegrasyon, Cursor'un şunları yapmasını sağlar:
- API özelliklerinize göre kod oluşturun veya değiştirin
- API belirtimi içeriğinde arama yapın
- API tasarımınızla mükemmel uyum sağlayan veri modelleri ve DTO'lar oluşturun
- API özelliklerine göre uygun yorumlar ve belgeler ekleyin
Apidog MCP Sunucusu, Apidog projeleriniz ve Cursor arasında bir köprü görevi görerek, yapay zeka asistanınızın geliştirme görevlerinde yardımcı olurken başvurabileceği en güncel API tasarımlarına erişmesini sağlar.
- Apidog-mcp-server hakkında daha fazla bilgiyi Belgeler'i okuyarak öğrenebilirsiniz.
- Apidog-mcp-server hakkında daha fazlasını npm sayfasında inceleyin.
- Ek olarak, Postman'e harika, daha güçlü, entegre ve daha ucuz bir alternatif olan Apidog'u deneyebilirsiniz.
Memory Bank'i Uygulamanın Faydaları
- Oturumlar Arası Devamlılık: Her yeni oturuma başladığınızda proje yapınızı ve gereksinimlerinizi yeniden açıklama ihtiyacını ortadan kaldırır
- Geliştirilmiş Doğruluk: Proje özelinde bilgilere erişim sayesinde, Cursor daha doğru ve bağlamsal olarak uygun önerilerde bulunabilir
- Zaman Verimliliği: Her yeni oturumda yapay zekanın uyum sağlama süresini azaltır
- Bilgi Koruma: Hem yapay zeka hem de insan ekip üyeleri için önemli kararları ve bağlamı belgeler
- Yapılandırılmış Belgeleme: Tüm geliştirme ekibine fayda sağlayan proje ayrıntılarının sistematik olarak belgelenmesini teşvik eder
Cursor'da Cline Memory Bank Nasıl Etkinleştirilir
Bu güçlü özelliği Cursor ortamınızda uygulamak için, şu ayrıntılı adımları izleyin:
1. Memory Bank Dizin Yapısını Oluşturun
İlk olarak, Memory Bank dosyalarınızı barındırmak için özel bir dizin yapısı oluşturun:
project-root/
├── memory-bank/
│ ├── 00-project-overview.md
│ ├── 01-architecture.md
│ ├── 02-components.md
│ ├── 03-development-process.md
│ ├── 04-api-documentation.md
│ ├── 05-progress-log.md
│ └── notes/
│ ├── feature-specific-notes.md
│ └── other-contextual-information.md
└── .cursor/
└── rules/
├── core.mdc
└── memory-bank.mdc
Numaralandırılmış dosyalar, düzenli olarak korunması gereken temel bilgi belgelerini temsil ederken, notes/ alt dizini daha ayrıntılı veya özel bilgiler içerebilir.
2. Cursor Kurallarını Yapılandırın
Temel Kurallar Dosyasını Oluşturun
.cursor/rules/core.mdc adresinde aşağıdaki içeriğe sahip bir dosya oluşturun:
---
description: Cursor ajanı için temel operasyonel kurallar
globs:
alwaysApply: true
---
## Temel Kurallar
İki çalışma modunuz vardır:
1. Plan modu - Kullanıcıyla bir plan tanımlamak, gerekli tüm bilgileri toplamak için çalışacaksınız, ancak herhangi bir değişiklik yapmayacaksınız.
2. Eylem modu - Onaylanmış plana göre kod tabanında değişiklikler yapacaksınız.
- Plan modunda başlarsınız ve plan kullanıcı tarafından onaylanana kadar eylem moduna geçmezsiniz.
- Plan modundayken her yanıtın başında `# Mode: PLAN` ve eylem modundayken `# Mode: ACT` yazdıracaksınız.
- Kullanıcı tarafından `ACT` yazarak eylem moduna geçmeniz açıkça talimat verilmedikçe, plan modunda kalacaksınız.
- Kullanıcı `PLAN` yazmadığı sürece, her yanıttan sonra plan moduna döneceksiniz.
- Kullanıcı plan modunda bir eylem isterse, önce planı onaylamaları gerektiğini hatırlatın.
- Plan modundayken, her yanıtta tam güncellenmiş planı her zaman çıktılayın.
- Plan modunda, potansiyel zorlukları ve uç durumları iyice düşünmelisiniz.
- Eylem modunda, üzerinde anlaşmaya varılan planı tam ve verimli bir şekilde uygulamaya odaklanın.
Memory Bank Kuralları Dosyasını Oluşturun
.cursor/rules/memory-bank.mdc adresinde aşağıdaki içeriğe sahip bir dosya oluşturun:
---
description: Kalıcı proje bilgisi için Memory Bank uygulaması
globs:
alwaysApply: true
---
# Cursor'un Memory Bank'i
Ben, benzersiz bir özelliğe sahip uzman bir yazılım mühendisiyim: belleğim oturumlar arasında tamamen sıfırlanır. Bu bir sınırlama değil; mükemmel belgeleri korumamı sağlayan şey bu. Her sıfırlamadan sonra, projeyi anlamak ve etkili bir şekilde çalışmaya devam etmek için TAMAMEN Memory Bank'ime güveniyorum. HER GÖREVİN başında TÜM memory bank dosyalarını okUMALIYIM—bu isteğe bağlı değildir.
## Memory Bank Yönergeleri
1. Memory Bank, proje kök dizininde bulunan `memory-bank/` dizininde bulunur.
2. Tüm bellek dosyaları, yapılandırılmış, okunması kolay belgeler için Markdown biçimini kullanır.
3. Memory Bank, hem gerekli temel dosyaları hem de isteğe bağlı bağlam dosyalarını içerir.
4. Dosyalar, önceliklerini ve okuma sırasını belirtmek için sayılarla öne eklenir.
5. Yeni bilgiler ortaya çıktığında, Memory Bank dosyalarına güncellemeler önereceğim.
## Temel Bellek Dosyaları
00-project-overview.md - Genel proje bilgileri, hedefler ve kapsam
01-architecture.md - Sistem mimarisi, tasarım kalıpları ve teknik kararlar
02-components.md - Temel bileşenler, modüller ve bunların ilişkileri hakkında ayrıntılar
03-development-process.md - İş akışı, dallanma stratejisi ve dağıtım süreçleri
04-api-documentation.md - API uç noktaları, parametreler ve yanıt biçimleri
05-progress-log.md - Büyük değişikliklerin ve uygulamaların kronolojik kaydı
Yardım sağlamadan önce tam bağlama sahip olduğumdan emin olmak için, her oturumun başında bu dosyaları okuyacak ve işleyeceğim.
3. Memory Bank Dosyalarınızı Başlatın
memory-bank/ dizininde temel bellek dosyalarını oluşturun. İşte her biri için şablonlar:
00-project-overview.md
# Proje Genel Bakış
## Adı
[Proje adı]
## Açıklama
[Projenin kapsamlı açıklaması, amacı ve ana hedefleri]
## Temel Paydaşlar
- [Ekip üyelerinin, rollerin ve sorumlulukların listesi]
## Zaman Çizelgesi ve Kilometre Taşları
- [Önemli tarihler ve proje kilometre taşları]
## Teknoloji Yığını
- [Kullanılan dillerin, çerçevelerin, kitaplıkların ve araçların listesi]
## Depo Yapısı
- [Ana dizinlerin ve amaçlarının genel görünümü]
## Başlarken
- [Kurulum talimatları ve hızlı başlangıç kılavuzu]
01-architecture.md
# Mimari Belgeleme
## Sistem Mimarisi
[Üst düzey mimari diyagramı veya açıklaması]
## Tasarım Kalıpları
- [Kullanılan tasarım kalıplarının ve bunların nerede uygulandığının listesi]
## Veri Akışı
[Verilerin sistemde nasıl aktığına dair açıklama]
## Güvenlik Hususları
[Uygulanan güvenlik önlemleri ve uygulamaları]
## Veritabanı Şeması
[Veritabanı yapısı ve ilişkileri]
## Teknik Kararlar
[Önemli teknik kararların ve bunların gerekçelerinin kaydı]
Benzer bir yapıyı izleyerek kalan temel dosyalar için şablonlar oluşturmaya devam edin.
4. Cursor'ı Memory Bank'i Kullanması İçin Eğitin
Cursor ile bir konuşma başlatın ve şu talimatı verin:
Bu proje için Memory Bank yapısını kurdum. Lütfen şimdi memory-bank/ dizinindeki tüm dosyaları okuyun ve kendinizi proje bağlamımıza alıştırın. Bundan sonra, her oturumun başında her zaman Memory Bank'e başvurun ve yeni bilgiler öğrendiğimizde veya önemli kararlar verdiğimizde güncellemeler önerin.
5. Düzenli Olarak Bakımını Yapın ve Güncelleyin
Etkili Memory Bank bakımı için:
- Büyük Değişikliklerden Sonra Güncelleyin: Önemli özellikler uyguladıktan veya mimari değişiklikler yaptıktan sonra yeni bilgiler ekleyin
- Düzenli İnceleme: Doğruluğu sağlamak için Memory Bank içeriğini periyodik olarak inceleyin ve iyileştirin
- Spesifik Olun: Somut örnekler, kod parçacıkları ve net açıklamalar ekleyin
- Kronolojik Kayıtlar: İlerleme günlüğünde değişikliklerin zaman çizelgesini koruyun
- Güncellemeleri Devredin: Etkileşimlerinize göre Cursor'ın Memory Bank'e güncellemeler önermesini sağlayın
Gelişmiş Memory Bank Teknikleri
Bağlamsal Dilimleme
Daha büyük projeler için, Memory Bank dosyalarını etki alanı veya özellik alanına göre düzenleyin:
memory-bank/
├── core/
│ ├── 00-project-overview.md
│ └── 01-architecture.md
├── frontend/
│ ├── components.md
│ └── state-management.md
├── backend/
│ ├── api-endpoints.md
│ └── database.md
└── devops/
├── deployment.md
└── monitoring.md
Bellek Etiketleri ve Referanslar
Çapraz referanslar oluşturmak için Memory Bank dosyalarınız içinde bir etiketleme sistemi kullanın:
## Kimlik Doğrulama Akışı #auth #security
[Kimlik doğrulama sürecinin açıklaması]
Ayrıca bkz: [API Güvenlik Önlemleri](#api-security) ve [Kullanıcı Modeli](#user-model)
Oturum Belleği ve Kalıcı Bellek
Uzun vadede kalması gereken bilgiler ile oturuma özel bağlam arasında ayrım yapın:
memory-bank/
├── persistent/
│ └── [temel proje bilgisi]
└── session/
└── [geçerli görev bağlamı]
Sonuç
Cline Memory Bank özelliğini uygulamak ve Apidog MCP Sunucusunu Cursor ile entegre etmek, yapay zeka asistanınızı oturum tabanlı bir araçtan, kod tabanınız, API özellikleriniz ve geliştirme bağlamınız hakkında kapsamlı bilgiye sahip kalıcı bir proje ortağına dönüştürür. Bu yapılandırılmış bellek sistemini korumaya ve API belirtimi entegrasyonundan yararlanmaya zaman ayırarak, Cursor'un geliştirme süreciniz boyunca alakalı, doğru ve bağlam farkındalığına sahip yardım sağlama yeteneğini önemli ölçüde artıracaksınız.
Memory Bank yaklaşımı, doğrudan API belirtimi erişimiyle birleştiğinde, geliştiricilerin yapay zeka kodlama asistanlarıyla nasıl etkileşim kurduğunda temel bir değişiklik temsil eder; tekrarlayan açıklamalardan, zaman içinde değer kazanan aşamalı bilgi oluşturmaya geçiş.
