Claude Projects ve Memory: Bağlam Yönetimi

1Claude Project
2├-- Project Knowledge (dosyalar, kodlar, dokumanlar)
3├-- Custom Instructions (özel talimatlar)
4├-- Conversations (konuşma
)
5│   ├-- Konuşma
 1: "Login Sayfası Tasarimi"
6│   ├-- Konuşma
 2: "API Entegrasyonu"
7│   └-- Konuşma
 3: "Test Yazımı"
8└-- Team Members (takım uyeleri - Teams planında)

1Kod Dosyaları:
2- .swift, .ts, .tsx, .js, .jsx, .py, .dart, .kt, .java
3- .json, .yaml, .toml, .xml
4- .css, .html, .md
5 
6Dokumanlar:
7- .pdf (100 sayfaya kadar)
8- .txt, .csv
9- Görsel dosyalar (png, jpg — sınırli analiz)

1// Örnek: Project Knowledge olarak yüklenecek dosyalar
2const projectKnowledge = {
3  architecture: {
4    files: ['ARCHITECTURE.md', 'src/app/structure.md'],
5    purpose: 'Proje mimarisi ve klasor yapısı'
6  },
7  apiSpec: {
8    files: ['openapi.yaml', 'api-examples.json'],
9    purpose: 'Backend API endpoint tanımları'
10  },
11  designSystem: {
12    files: ['design-tokens.json', 'components.md'],
13    purpose: 'UI component listesi ve stil kuralları'
14  },
15  conventions: {
16    files: ['CONVENTIONS.md', '.eslintrc.json'],
17    purpose: 'Kod yazım
 kuralları ve standartları'
18  },
19  context: {
20    files: ['MEMORY.md', 'README.md'],
21    purpose: 'Proje durumu ve genel bilgi'
22  }
23};

1# Proje: PartToTime iOS App
2 
3## Rol
4Sen senior iOS developer'sin. Swift 6, SwiftUI ve MVVM-C mimarisi konusunda uzmansın.
5 
6## Teknik Stack
7- Swift 6 + SwiftUI
8- MVVM-C + Coordinator Pattern
9- async/await + Structured Concurrency
10- SwiftData (Core Data değil)
11- SPM (CocoaPods değil)
12 
13## Kod Kuralları
14- Her dosya maksimum 400 satır
15- Protocol-oriented programming tercih et
16- Guard-let > if-let (early return)
17- Türkçe yorum yaz, değişken isimleri Ingilizce
18- any YASAK, some veya generics kullan
19 
20## Cevap Formati
21- Önce mimariyi açıkla
, sonra kodu yaz
22- Her kod blogi için neden bu yaklaşımi seçtiğini belirt
23- Test yazılabilir kod üret

24- Edge case'leri her zaman ele al

1❌ KOTU: "Iyi kod yaz"
2✅ IYI: "SOLID prensiplerine uygun, test edilebilir, maksimum 400 satır
 dosyalar üret
"
3 
4❌ KOTU: "Swift kullan"
5✅ IYI: "Swift 6, strict concurrency, @Sendable closure'lar, actor isolation kullan"
6 
7❌ KOTU: "Hatalsiz çalış"
8✅ IYI: "Her public fonksiyon için guard-let ile input validasyonu yap, Result<T, Error> don"

1# Seviye 1: Genel Kurallar (her konuşmada geçerli)
2- Türkçe açıklama, Ingilizce kod
3- Kısa ve net cevaplar
4- Her öneri için trade-off analizi
5 
6# Seviye 2: Proje Kuralları (proje bazında)
7- MVVM-C mimarisi
8- SwiftData kullan
9- Min iOS 17 target
10 
11# Seviye 3: Görev Kuralları (konuşma
 başında belirt)
12- "Bu konuşmada sadece network katmanı üzerinde çalışıyoruz"
13- "Test yazmaya odaklan"

1// Claude'un memory sistemi kavramsal yapısı
2interface ClaudeMemory {
3  // Otomatik kaydedilen bilgiler
4  userPreferences: {
5    language: 'Turkish';
6    codeStyle: 'functional';
7    architecture: 'MVVM-C';
8  };
9 
10  // Proje bazli bilgiler
11  projectContext: {
12    techStack: string[];
13    conventions: string[];
14    knownIssues: string[];
15  };
16 
17  // Kullanıcı tarafından eklenen bilgiler
18  customFacts: {
19    key: string;
20    value: string;
21    addedAt: Date;
22  }[];
23}

1"Bu bilgiyi hatirla: iOS projemde minimum target iOS 17"
2→ Claude memory'ye kaydeder
3 
4"Ne hatirliyorsun?"
5→ Claude kayitli memory'leri listeler
6 
7"iOS target bilgisini unut"
8→ Claude ilgili memory'yi siler
9 
10"Memory'lerimi güncelle: artik SwiftData kullanıyorum, Core Data değil"
11→ Claude mevcut memory'yi günceller

1200K Token Bütçe
 Dagilimi:
2├-- System Prompt:        ~2K token
3├-- Project Knowledge:   ~50K token (dosyalar)
4├-- Custom Instructions:  ~2K token
5├-- Memory:               ~1K token
6├-- Konuşma
 Geçmişi:     ~100K token
7└-- Cevap için bos alan: ~45K token

1// Bağlam penceresi kullanım izleme
2function estimateTokenUsage(project: Project): TokenEstimate {
3  const knowledgeTokens = project.files
4    .reduce((sum, f) => sum + estimateTokens(f.content), 0);
5  const instructionTokens = estimateTokens(project.instructions);
6  const memoryTokens = estimateTokens(project.memories.join(' '));
7 
8  const totalUsed = knowledgeTokens + instructionTokens + memoryTokens;
9  const available = 200000 - totalUsed;
10  const conversationBudget = available * 0.7; // %70 konuşma
 için
11  const responseBudget = available * 0.3;     // %30 cevap için
12 
13  return {
14    totalUsed,
15    available,
16    conversationBudget,
17    responseBudget,
18    warning: available < 50000 ? 'Bağlam penceresi dolmak uzere!' : null
19  };
20}

1Tech Lead:
2├-- Project Knowledge oluşturur (mimari, kurallar)
3├-- Custom Instructions yazar
4└-- Proje standartlarını belirler
5 
6Senior Developer:
7├-- Knowledge'a teknik dokumanlar ekler
8├-- Kod inceleme konuşma
 yapar
9└-- Junior'lara rehberlik eder
10 
11Junior Developer:
12├-- Proje bağlamında sorular sorar
13├-- Claude'dan kod örnekleri alir
14└-- Code review için hazirlik yapar
15 
16QA Engineer:
17├-- Test senaryoları oluşturur
18├-- Bug raporları analiz eder
19└-- Regression test listesi çıkarır

1// Takım için ortaklasa Knowledge yapısı
2const sharedKnowledge = {
3  // Herkesin erisebilecegi
4  publicDocs: [
5    'ARCHITECTURE.md',
6    'API_SPEC.yaml',
7    'CODING_STANDARDS.md',
8    'DEPLOYMENT_GUIDE.md'
9  ],
10 
11  // Rol bazli instruction'lar
12  roleInstructions: {
13    developer: 'Kod yazarken SOLID, test edilebilirlik öncelikli',
14    qa: 'Test senaryoları BDD formatında, edge case öncelikli',
15    designer: 'Component spec HIG uyumlu, accessibility zorunlu'
16  }
17};

1# My iOS Project
2 
3## Tech Stack
4- Swift 6 + SwiftUI
5- MVVM-C Architecture
6- SwiftData + CloudKit
7 
8## Build Commands
9- Build: cmd+B in Xcode (local build YASAK sunucuda)
10- Test: swift test
11- Lint: swiftlint
12 
13## Code Rules
14- Maximum 400 lines per file
15- Protocol-oriented design
16- actor for shared mutable state
17- Result<T, Error> for fallible functions
18 
19## Golden Rules
201. Never force unwrap (!)
212. Always handle errors explicitly
223. Use structured concurrency (TaskGroup, async let)

1# MEMORY.md - Proje Durumu
2 
3## Son Durum
4- Login modulu tamamlandi
5- Payment entegrasyonu devam ediyor
6- API v2 migration %60
7 
8## Bilinen Sorunlar
9- iOS 17.0'da NavigationStack bug'i (Apple bug report #FB12345)
10- CloudKit sync 5+ saniye gecikme (investigate)
11 
12## Kararlar
13- [2026-02-01] Core Data yerine SwiftData seçildi (migration kolaylığı)
14- [2026-02-05] CocoaPods yerine SPM'e geçis (dependency azaltma)

1✅ YÜKLE:
2- Mimari dokümantasyon (ARCHITECTURE.md)
3- API spec (OpenAPI/Swagger)
4- Kod standartları (CONVENTIONS.md)
5- Önemli kaynak kodları (core modeller, servisler)
6- Proje durumu (MEMORY.md)
7 
8❌ YÜKLEME:
9- Tum kaynak kodu (bağlam tasirir)
10- node_modules, Pods (gereksiz)
11- Build artifact'lari
12- Hassas veriler (API key, credential)
13- Büyük binary dosyalar

11. Spesifik ol — "iyi kod yaz" değil, "SOLID uyumlu, test edilebilir, 400 satır max"
22. Öncelik belirt — en önemli kurallar ustte
33. Örnek ver — "su şekilde yazma, böyle
 yaz" örnekleri ekle
44. Güncelle — her sprint sonunda instruction'lari gozden geçir
55. Ölç — Claude'un cevap kalitesini izle, instruction'a göre ayarla