◣◢ Periskop AI
Legacy R&D takımı dönüşüm programı · v5

Claude Code Mastery

Terminal-native agentic geliştirme: planlama, refactor, test ve PR akışlarını Claude Code ile uçtan uca yürütme. Bu sayfa herkese açıktır — incelemek için giriş gerekmez.

7
AŞAMA
48
MICRO DERS
21
PRATİK PROJE
≈ 53–67 saat
SÜRE
yenigüncellendiyeni aşama
◆ Micro dersler
1.1
Claude Code nedir, agentic coding nedir?
Chat asistanından agentic araca geçiş: "kod öneren" ile "işi yapan" arasındaki fark. Claude Code'un ekosistemdeki konumu ve yüzeyleri (CLI, VS Code, desktop, web — tur Aşama 6'da). Kod yazmayanların bu kursta neden yeri var: kodu zaten Claude yazıyor; senin işin harness'i tasarlamak.
1.2
Agentic loop ve harness
Gather context → take action → verify results döngüsü. Model + tools + harness üçlüsü: modelin zekâsı herkes için aynı, sonucu belirleyen harness. "Harness" teriminin resmî tanımı ve kursun okuma anahtarı ilanı: bundan sonra öğrenilecek her mekanizma bu loop'un bir katmanıdır.
1.3
Kurulum ve ilk session
Native kurulum, hesapla oturum açma, ilk claude komutu. Temel komutlar (/help, /clear, Esc), workspace trust kavramı. Bu noktadan sonra tüm dersler canlı session deneyleriyle desteklenir.
1.4
Tool'lar: Claude'un elleri
Read/Edit/Write/Bash/Glob/Grep/WebFetch turu: Claude'un dünyaya dokunan elleri. Her tool çağrısının loop'taki yeri ve izin isteme davranışının ilk gözlemi. Tool çıktısını okuyup "Claude şu an ne yapıyor" sorusuna cevap verme.
1.5
Session'la konuşmak
Interrupt & steer: yanlış yöne giden Claude'u kesme ve düzeltme. "Be specific upfront" ve "delegate, don't dictate" ilkeleri. Checkpoint/rewind'e ilk dokunuş: her değişikliğin geri alınabildiği korkusuz deneme zemini.
1.6
Git ile çalışmak
Commit, diff okuma, branch açma işlerini Claude'a devretme. "Give Claude something to verify against" ilkesinin git'le ilk buluşması: diff, doğrulanabilir bir sözleşmedir.
1.7
İlk SDLC iskeleti: kara kutu teslimi
3 hazır skill'in (spec → build → verify) kurulumu ve ilk uçtan uca çalıştırma. "Bunların içini Aşama 4'te açacağız" dürüstlüğü. Kursun iki ipliği burada düğümlenir: pipeline bundan sonra her aşamada bir katman kazanacak.
◆ Pratik uygulamalar
Flappy Bird doğarbireysel
İlk session'da tek dosyalık Canvas oyununu Claude'a yazdır, çalıştır, oyna. Derin görev: fizik parametrelerini Claude'la pazarlık ederek değiştir; bir değişikliği rewind ile geri al.
Loop gözlem günlüğübireysel
Bir görevde Claude'un her tool çağrısını sınıflandır: hangi bağlamı topladı, hangi aksiyonu aldı, neyi doğruladı? Aşama 5'teki gözlemlenebilirlik dersinin tohumu.
Kara kutuyla ilk featurebireysel
spec → build → verify zinciriyle oyuna "boşluk tuşuyla da zıplama" ekle. Derin görev: verify skill'inin neyi kaçırdığını bul ve raporla.
◆ Aşama çıktısı
Minimum Viable Skill: Claude Code'u kurup session yönetebilir · agentic loop'u kendi kelimeleriyle anlatabilir · tool çağrılarını okuyup yorumlayabilir · git işlemlerini Claude'a devredebilir · hazır skill zincirini çalıştırabilir. — Kavramsal kazanım: "Claude Code bir loop'tur, gerisi harness'tir" zihinsel modelini edinmiş olur.
Aşamaya git →
◆ Micro dersler
2.1
Context window: sınırlı sahne
Context'i ne doldurur: system prompt, CLAUDE.md, tool sonuçları, konuşma geçmişi. /context ile canlı bakış. Ana kurstaki tokenizasyon dersinin Claude Code'a inen ayağı.
2.2
Compaction ve context yönetimi
Auto-compact ne zaman tetiklenir, /compact ile manuel özetleme, compaction'dan ne hayatta kalır. "Uzun session'da Claude neden unutuyor" sorusunun mekanik cevabı ve karşı stratejiler.
2.3
Prompt caching
Cache'in organizasyonu ve ömrü. Cache'i bozan eylemler (model değişimi, MCP bağlama/koparma, compaction) vs koruyan eylemler (dosya düzenleme, CLAUDE.md düzenleme, permission mode değişimi). Maliyet ve hıza doğrudan etkisi.
2.4
CLAUDE.md: projenin anayasası
Ne CLAUDE.md'ye yazılır, ne yazılmaz. Etkili talimat yazımı, hiyerarşik yükleme (user → project → dizin), import mekanizması, AGENTS.md uyumluluğu.
2.5
.claude klasör anatomisi
.claude klasörünün tam haritası: settings, rules/, skills/, agents/, hook konfigürasyonları ve uygulama verisi. Hangi dosya repo'ya commit edilir, hangisi kişisel kalır.
2.6
Rules ve auto memory
.claude/rules/ ile path-specific kurallar; katmanlı kural tasarımı. Auto memory vs CLAUDE.md ayrımı; /memory ile hafızayı denetleme ve düzenleme.
2.7
Context harness
Sentez dersi: bu aşamadaki her mekanizma tek sorunun cevabı — loop'a ne gösteriyorum? Az ama isabetli context, çok ama gürültülü context'i yener. Quiz havuzu, aşamanın derslerini birbirine bağlayan entegrasyon senaryolarına ağırlık verir.
◆ Pratik uygulamalar
Projeye anayasabireysel
Flappy Bird repo'suna CLAUDE.md + rules yaz; etkisini iki session karşılaştırarak ölç. Derin görev: kasıtlı çelişen kural ekle, hangisinin kazandığını ve nedenini raporla.
Cache dedektifibireysel
Aynı görevi cache'i bozan ve koruyan akışlarla yap; /usage üzerinden farkı ölç, hangi eylemin cache'i patlattığını tablola.
Compaction sınırındabireysel
Uzun bir session'ı bilinçli doldur; compaction öncesi/sonrası Claude'un neyi hatırladığını test et. Derin görev: kritik bilgiyi compaction'dan sağ çıkarma stratejisi tasarla.
◆ Aşama çıktısı
Minimum Viable Skill: /context ve /usage okuyabilir · etkili CLAUDE.md ve rules yazabilir · cache'i bozan/koruyan eylemleri sayabilir · compaction davranışını öngörebilir · .claude klasörünü yönetebilir. — Kavramsal kazanım: "Context bir bütçedir ve harness'in ilk katmanı bu bütçenin yönetimidir" refleksini edinmiş olur.
Aşamaya git →
◆ Micro dersler
3.1
Permission mode'lar
default, acceptEdits, plan, dontAsk, auto ve bypassPermissions: altı modun risk-hız dengesi ve geçiş mekanikleri. Mode seçimi bir hız tercihi değil, güven seviyesi beyanıdır. Davranış harness'inin ilk yarısı.
3.2
Plan mode derinlemesine
Explore → plan → approve → execute ritmi. Planı okuma, itiraz etme ve revize ettirme sanatı; plan mode'u default yapmak. "Önce tasarla sonra kodla" disiplininin Claude Code karşılığı.
3.3
Session yönetimi ve paralel çalışma
Resume, fork/branch, session adlandırma. Worktree'lerle paralel session'lar: aynı repo'da çakışmadan iki iş. Hangi iş yeni session ister, hangisi devam etmeli?
3.4
Common workflows ve prompt library
Resmî prompt tarifleri: codebase anlama, bug fix, refactor, test, PR üretimi. Prompt library'nin mantığı ve tarifleri kendi projenin bağlamına uyarlama.
3.5
Best practices
Verify-against ilkesi, zengin context verme, course-correct early, "let Claude interview you". Yaygın başarısızlık pattern'leri ve panzehirleri.
3.6
Checkpoint ve rewind derinlemesine
Otomatik izleme, rewind & summarize, sınırlar (bash değişiklikleri ve subagent edit'leri izlenmez). Git'in yerine geçmez; ikisinin işbölümü.
3.7
Permission rules ve settings katmanları
Allow/deny kural sözdizimi, tool-specific kurallar (Bash komut desenleri, dosya yolları), settings scope'ları ve öncelik sırası. Sandboxing: Bash için OS düzeyi izolasyon, permission rules'tan ayrı bir katman. Davranış harness'inin deklaratif yarısı.
◆ Pratik uygulamalar
Oyun disipline girerbireysel
Plan mode'da Flappy Bird refactor'u: oyun döngüsünü modüllere ayır, test suite ekle. Derin görev: plana bilinçli itiraz et, revize ettir, iki planı karşılaştır.
İzin matrisibireysel
Projeye allow/deny kuralları tasarla (ör. rm yasak, test komutları serbest). Kuralları kırmayı dene, hangi katmanın yakaladığını raporla.
Paralel worktree yarışıikili
İki feature'ı iki worktree'de paralel session'larla geliştir; merge ve çakışma deneyimini yaşa ve yönet.
◆ Aşama çıktısı
Minimum Viable Skill: işe uygun permission mode seçip gerekçelendirebilir · plan mode ritmiyle çalışabilir · allow/deny kuralları yazabilir · worktree ile paralel session yönetebilir · checkpoint/rewind'i güvenle kullanır. — Kavramsal kazanım: "Hız modu değil, güven seviyesi seçiyorsun" anlayışını edinmiş olur.
Aşamaya git →
◆ Micro dersler
4.1
Skill kavramı
SKILL.md anatomisi, frontmatter, skill'lerin nerede yaşadığı ve nasıl keşfedildiği. Aşama 1'deki kara kutunun kapağı burada açılır: spec/build/verify skill'lerinin kaynak okuması.
4.2
Skill yazma sanatı
Description'ın tetikleme rolü: iyi vs kötü skill açıklaması. Supporting files, argüman geçirme, skill'i subagent'ta çalıştırma. Bir skill'i değerlendirme ve iterasyon döngüsü.
4.3
Commands ve output styles
Slash command'ler, skill-komut ilişkisi, MCP prompt'larını komut olarak kullanma. Output style'larla davranış kalıbını değiştirme; ne zaman skill, ne zaman style.
4.4
Hook kavramı ve lifecycle
Hook nedir, neden deterministik? SessionStart'tan SessionEnd'e event haritası; PreToolUse/PostToolUse/Stop üçlüsünün merkezi rolü. Hook'ların permission sistemiyle ilişkisi.
4.5
Hook yazma
Input/output sözleşmesi: stdin JSON, exit code'lar (2 = engelle), JSON output ile karar kontrolü, matcher'lar. "Claude'a hook'u yazdır, ne yaptığını satır satır anla" — kod yazmayanlar için kapı burada açık kalır.
4.6
Hook pattern'leri
Format-on-edit, korumalı dosyalar, test gate, compaction sonrası context enjeksiyonu, bildirimler. Prompt-based ve agent-based hook'lara bakış: deterministik scriptin yetmediği yerde LLM'li hook.
4.7
Otomasyon harness'i
Deterministik çit (hook) vs olasılıksal yetenek (skill) işbölümü. "Güvenmek istediğini koda, esneklik istediğini modele bağla" kararının sistematiği.
◆ Pratik uygulamalar
Kara kutu senin oldubireysel
spec/build/verify skill'lerini oku, kendi projene göre genişlet (ör. verify'a lint + type-check ekle). Derin görev: dördüncü bir skill tasarla (ör. document).
Test gatebireysel
Testler geçmeden Claude'un "bitti" diyememesini sağlayan Stop/PostToolUse hook düzeneği. Derin görev: hook'u sıfırdan yazdır, bir edge case'te bilerek delik bırak ve yakala.
Oyun canlıya çıkarbireysel
Leaderboard: Next.js API route + Neon Postgres; Vercel'e ilk deploy. Deploy öncesi hook gate'leri (test + lint + migration kontrolü) akışı korur.
◆ Aşama çıktısı
Minimum Viable Skill: sıfırdan skill yazıp tetikletebilir · en az 2 event'e hook bağlayabilir · exit code / JSON output sözleşmesini uygular · deterministik-olasılıksal işbölümü kararını gerekçelendirebilir · deploy akışını gate'lerle korur. — Kavramsal kazanım: "Güvenmek istediğin şeyi koda, esneklik istediğin şeyi modele bağla" refleksini edinmiş olur.
Aşamaya git →
◆ Micro dersler
5.1
Subagent kavramı
Context izolasyonu: ana konuşmayı kirletmeden yüksek hacimli iş. Otomatik delegasyon vs açık çağrı. "Loop içinde loop" zihinsel modeli; ne zaman subagent, ne zaman ana konuşma.
5.2
Subagent konfigürasyonu
Agent dosyaları ve frontmatter: tool kısıtlama, model seçimi, permission mode, skill preload, persistent memory. Kısıtlı subagent = öngörülebilir subagent.
5.3
Paralel çalışma: background ve agent view
Foreground/background çalıştırma, agent view ile session'ları izleme, dispatch. Agent teams'e kısa pencere: ne vaat ediyor, kapsam sınırı neden burada.
5.4
MCP temelleri
Protokolün derdi, transport'lar (stdio/HTTP/SSE), server ekleme, scope'lar (local/project/user), auth akışı. Ana kursla işbölümü: orada server geliştirmek, burada Claude Code'a bağlamak merkezde.
5.5
Oyun için MCP server
Flappy Bird API'sine bağlanan minimal MCP server: skor sorgula, oyun başlat, hamle gönder. Claude'a yazdırılır, satır satır okunur — "Agent'lar oyuna girer" pratiğinin altyapısı.
5.6
Plugins
Plugin yapısı: skill + hook + agent + MCP'yi tek pakette taşıma. Marketplace'ler, kurulum/yönetim, sürümleme. Capstone'daki "pipeline'ı plugin yap" hedefinin temeli.
5.7
Code intelligence ve artifacts
Code intelligence (LSP) plugin'lerinin Claude'a kazandırdıkları: tanım bulma, referans takibi, daha az dosya okuyarak daha isabetli düzenleme. Artifacts ile session'dan paylaşılabilir görsel çıktı.
5.8
Gözlemlenebilirlik harness'i
/context, /usage, statusline özelleştirme; subagent'ların cache ve maliyet etkisi. "Loop'u göremiyorsan yönetemezsin" — gözlem katmanının harness'teki yeri.
◆ Pratik uygulamalar
Reviewer + tester ekibiikili
Pipeline'a iki subagent: code-reviewer ve test-runner. Derin görev: reviewer'a tool kısıtı ve özel model ata, farkı ölç.
Agent'lar oyuna girerikili
Oyun API'si + MCP server; bir Claude Code session'ının oyunu oynayıp skora girmesi. Derin görev: agent'ın stratejisini skill olarak yaz.
Statusline dashboard'ubireysel
Context doluluğu, maliyet ve git durumunu gösteren statusline. Derin görev: cache hit oranını da ekle.
◆ Aşama çıktısı
Minimum Viable Skill: işe uygun subagent tasarlayıp tool/model kısıtlarıyla yapılandırabilir · MCP server bağlayıp scope yönetebilir · basit bir MCP server'ın kodunu okuyup anlatabilir · plugin kurup yönetebilir · session'ın maliyet ve context durumunu izleyebilir. — Kavramsal kazanım: "Ölçek, daha büyük tek loop değil; iyi sınırlanmış küçük loop'ların koordinasyonudur" anlayışını edinmiş olur.
Aşamaya git →
◆ Micro dersler
6.1
VS Code extension
Kurulum, prompt box, dosya referansları, diff görünümü, çoklu konuşma. Extension vs CLI karşılaştırması ve terminal moduna geçiş.
6.2
Desktop app
Session yönetimi, preview server ile değişiklikleri otomatik doğrulama, diff review, paralel session'lar. Computer use'a kısa bakış. CLI'dan gelenler için harita.
6.3
Web ve mobil
Cloud session'lar, GitHub bağlantısı, web ↔ terminal teleport, Remote Control ile masadan uzakta devam. "Masadan kalkınca iş durmaz" akışı.
6.4
Non-interactive mode (eski adıyla headless)
claude -p ile tek atımlık çalıştırma, structured output, pipe'lama, script'e gömme. CI için bare mode. Otomasyonun kapısı; kod yazmayanlar için de "tek komutluk rapor" pratiği.
6.5
GitHub Actions ve Code Review
@claude mention akışı, CI'da skill çalıştırma, otomatik PR review. Credential hijyeni ve maliyet yönetimi.
6.6
Hangi iş hangi yüzeyde?
Karar çerçevesi: etkileşim yoğunluğu × süre × ortam matrisi. Scheduled tasks, /loop ve /goal'a kısa tur — Aşama 7'nin fragmanı.
◆ Pratik uygulamalar
Üç yüzey, tek görevbireysel
Aynı küçük feature'ı CLI, VS Code ve web'de yap; sürtünme noktalarını karşılaştır, kendi karar matrisini yaz.
PR kapıcısıbireysel
Flappy Bird repo'suna GitHub Actions + otomatik code review; @claude mention ile issue'dan PR üretme.
Gece bekçisibireysel
Headless mode ile günlük rapor script'i (test durumu + açık TODO'lar); scheduled task olarak bağla.
◆ Aşama çıktısı
Minimum Viable Skill: dört yüzeyde de temel akışı yürütebilir · headless mode ile script yazabilir · GitHub Actions entegrasyonunu kurabilir · iş-yüzey eşleşmesini gerekçelendirebilir. — Kavramsal kazanım: "Claude Code bir araç değil, birden çok yüzeyi olan tek bir yetenek" anlayışını edinmiş olur.
Aşamaya git →
◆ Micro dersler
7.1
SDLC pipeline mimarisi
Skill + subagent + hook + permission'ın tek tasarımda sentezi. Handoff protokolü, insan onay noktaları, sorumluluk sınırları. Ana kurstaki multi-agent SDLC aşamasıyla akrabalık ve fark: orada API'yle inşa, burada Claude Code'un kendi mekanizmalarıyla.
7.2
Loop engineering
Stop hook'larıyla "koşul sağlanana kadar" döngüleri; /loop ile tekrarlı çalışma, /goal ile hedef-koşul tanımı. Sonsuz döngü ve maliyet tavanı korumaları.
7.3
Harness engineering sentezi
Kursun tüm katmanlarının tek şemada okunması: context → izin → otomasyon → gözlem. Harness audit pratiği: "bu pipeline neye güveniyor, neyi doğruluyor?"
7.4
Pipeline'ı plugin yapmak
Skill/hook/agent/MCP bileşenlerini tek plugin'de paketleme, yerel marketplace, versiyonlama, ekiple paylaşım.
7.5
Platform: insanlar ve agent'lar yarışıyor
Turnuva modu, replay, server-side anti-cheat, agent kayıt akışı. Tüm feature'lar artık elle değil pipeline'dan geçerek eklenir — kursun iki ipliği burada birleşir.
7.6
Ölçme ve kapanış
Pipeline kalite metrikleri: test coverage, review yakalama oranı, tur başı maliyet. Manual vs pipeline karşılaştırma çerçevesi; "sonra ne?" haritası.
◆ Pratik uygulamalar
Feature factorytakım
5 farklı feature'ı uçtan uca pipeline'dan geçir (spec → build → review → test → PR). Derin görev: pipeline'da bir darboğazı bulup düzelt.
Pipeline benchmarkikili
Aynı feature'ları manual (pipeline'sız Claude Code) vs pipeline ile geliştir; kalite, süre, maliyet tablosu çıkar.
Platform capstonetakım
Turnuva platformunun Vercel + Neon'da canlıya çıkışı; en az bir insan ve bir agent'ın gerçekten yarıştığı demo + retro analiz.
◆ Aşama çıktısı
Minimum Viable Skill: uçtan uca SDLC pipeline'ı Claude Code mekanizmalarıyla tasarlayıp çalıştırabilir · pipeline'ı plugin olarak paketleyip dağıtabilir · loop'ları koşul ve maliyet korumalarıyla tasarlayabilir · pipeline kalitesini ölçüp manual'la karşılaştırabilir. — Kavramsal kazanım: "Uzman Claude Code kullanıcısı, iyi prompt yazan değil; iyi harness tasarlayan kişidir."
Aşamaya git →