Claude Projects ve Memory: Baglam Yonetimi

1Claude Project
2├── Project Knowledge(dosyalar, kodlar, dokumanlar)
3├── Custom Instructions(ozel talimatlar)
4├── Conversations(konusmalar)
5│   ├── Konusma 1: "Login Sayfasi Tasarimi"
6│   ├── Konusma 2: "API Entegrasyonu"
7│   └── Konusma 3: "Test Yazimi"
8└── Team Members(takim uyeleri - Teams planinda)

1Kod Dosyalari:
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- Gorsel dosyalar(png, jpg — sinirli analiz)

1// Ornek: Project Knowledge olarak yuklenecek dosyalar
2const projectKnowledge = {
3  architecture: {
4    files: ['ARCHITECTURE.md', 'src/app/structure.md'],
5    purpose: 'Proje mimarisi ve klasor yapisi'
6  },
7  apiSpec: {
8    files: ['openapi.yaml', 'api-examples.json'],
9    purpose: 'Backend API endpoint tanimlari'
10  },
11  designSystem: {
12    files: ['design-tokens.json', 'components.md'],
13    purpose: 'UI component listesi ve stil kurallari'
14  },
15  conventions: {
16    files: ['CONVENTIONS.md', '.eslintrc.json'],
17    purpose: 'Kod yazim kurallari ve standartlari'
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 uzmansin.
5 
6## Teknik Stack
7- Swift 6 + SwiftUI
8- MVVM-C + Coordinator Pattern
9- async/await + Structured Concurrency
10- SwiftData (Core Data degil)
11- SPM (CocoaPods degil)
12 
13## Kod Kurallari
14- Her dosya maksimum 400 satir
15- Protocol-oriented programming tercih et
16- Guard-let > if-let (early return)
17- Turkce yorum yaz, degisken isimleri Ingilizce
18- any YASAK, some veya generics kullan
19 
20## Cevap Formati
21- Once mimariyi acikla, sonra kodu yaz
22- Her kod blogi icin neden bu yaklasimi sectigini belirt
23- Test yazilabilir kod uret
24- Edge case'leri her zaman ele al

1❌ KOTU: "Iyi kod yaz"
2✅ IYI: "SOLID prensiplerine uygun, test edilebilir, maksimum 400 satirlik dosyalar uret"
3 
4❌ KOTU: "Swift kullan"
5✅ IYI: "Swift 6, strict concurrency, @Sendable closure'lar, actor isolation kullan"
6 
7❌ KOTU: "Hatalsiz calis"
8✅ IYI: "Her public fonksiyon icin guard-let ile input validasyonu yap, Result<T, Error> don"

1# Seviye 1: Genel Kurallar (her konusmada gecerli)
2- Turkce aciklama, Ingilizce kod
3- Kisa ve net cevaplar
4- Her oneri icin trade-off analizi
5 
6# Seviye 2: Proje Kurallari (proje bazinda)
7- MVVM-C mimarisi
8- SwiftData kullan
9- Min iOS 17 target
10 
11# Seviye 3: Gorev Kurallari (konusma basinda belirt)
12- "Bu konusmada sadece network katmani uzerinde calisiyoruz"
13- "Test yazmaya odaklan"

1// Claude'un memory sistemi kavramsal yapisi
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  // Kullanici tarafindan 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 guncelle: artik SwiftData kullaniyorum, Core Data degil"
11→ Claude mevcut memory'yi gunceller

1200K Token Butce Dagilimi:
2├── System Prompt:        ~2K token
3├── Project Knowledge:   ~50K token(dosyalar)
4├── Custom Instructions:  ~2K token
5├── Memory:               ~1K token
6├── Konusma Gecmisi:     ~100K token
7└── Cevap icin bos alan: ~45K token

1// Baglam penceresi kullanim 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 konusma icin
11  const responseBudget = available * 0.3;     // %30 cevap icin
12 
13  return {
14    totalUsed,
15    available,
16    conversationBudget,
17    responseBudget,
18    warning: available < 50000 ? 'Baglam penceresi dolmak uzere!' : null
19  };
20}

1Tech Lead:
2├── Project Knowledge olusturur(mimari, kurallar)
3├── Custom Instructions yazar
4└── Proje standardlarini belirler
5 
6Senior Developer:
7├── Knowledge'a teknik dokumanlar ekler
8├── Kod inceleme konusmalari yapar
9└── Junior'lara rehberlik eder
10 
11Junior Developer:
12├── Proje baglaminda sorular sorar
13├── Claude'dan kod ornekleri alir
14└── Code review icin hazirlik yapar
15 
16QA Engineer:
17├── Test senaryolari olusturur
18├── Bug raporlari analiz eder
19└── Regression test listesi cikarir

1// Takim icin ortaklasa Knowledge yapisi
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 oncelikli',
14    qa: 'Test senaryolari BDD formatinda, edge case oncelikli',
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 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 secildi (migration kolayligi)
14- [2026-02-05] CocoaPods yerine SPM'e gecis (dependency azaltma)

1✅ YUKLE:
2- Mimari dokumantasyon(ARCHITECTURE.md)
3- API spec(OpenAPI/Swagger)
4- Kod standartlari(CONVENTIONS.md)
5- Onemli kaynak kodlari(core modeller, servisler)
6- Proje durumu(MEMORY.md)
7 
8❌ YUKLEME:
9- Tum kaynak kodu(baglam tasirir)
10- node_modules, Pods(gereksiz)
11- Build artifact'lari
12- Hassas veriler(API key, credential)
13- Buyuk binary dosyalar

11. Spesifik ol — "iyi kod yaz" degil, "SOLID uyumlu, test edilebilir, 400 satir max"
22. Oncelik belirt — en onemli kurallar ustte
33. Ornek ver — "su sekilde yazma, boyle yaz" ornekleri ekle
44. Guncelle — her sprint sonunda instruction'lari gozden gecir
55. Olc — Claude'un cevap kalitesini izle, instruction'a gore ayarla