ta1sph.info/docs/KURULUM.md

Kurulum Rehberi — Skill'i VS Code'daki Claude Code'a ekleme

Neden proje skill'i?

Skill proje klasöründeki .claude/skills/ altında durur. Böylece:

• VS Code'u bu klasörde açtığınız her an Claude Code skill'i otomatik görür,
• skill git deposuyla birlikte yedeklenir ve sürümlenir,
• CLAUDE.md her oturumda otomatik okunur ve PROJECT_MEMORY.md'yi (hafıza) içe aktarır.

Ön koşullar

• Node.js 22 LTS veya üzeri (node -v)
• Git (git --version)
• VS Code + Claude Code eklentisi (Marketplace'te "Claude Code", yayıncı Anthropic), Claude hesabınızla giriş yapılmış

Adımlar

1. Zip'i açın ve içeriğini proje klasörünüzün köküne kopyalayın. Sonuç şöyle olmalı:

   proje-klasoru/
   ├── .claude/
   │   └── skills/
   │       └── ta1sph-site/
   │           ├── SKILL.md
   │           ├── references/  (7 dosya)
   │           └── templates/article.md
   ├── docs/
   │   ├── design-reference/  (5 ekran görüntüsü)
   │   ├── ILK_PROMPT.md
   │   └── KURULUM.md
   ├── CLAUDE.md
   └── PROJECT_MEMORY.md
   

   .claude gizli bir klasördür. macOS Finder'da görmek için Cmd+Shift+., Windows'ta Gezgin → Görünüm → Gizli öğeler.

2. Git'i başlatın (önerilir, terminalde proje klasöründe):

   git init -b main
   git add .
   git commit -m "chore: add Claude Code skill and project memory"
   

3. VS Code'u bu klasörde açın: Dosya → Klasör Aç… (veya terminalde code .).

4. Claude Code panelini açın (kenar çubuğundaki Claude simgesi veya Komut Paleti → "Claude Code: Open"). Klasör ilk açıldığında "bu klasöre güveniyor musunuz" sorulursa onaylayın.

5. Skill'in yüklendiğini doğrulayın. Panelde şunu yazın:

   Hangi skill'ler yüklü? ta1sph-site skill'ini görüyor musun, kısaca ne yaptığını söyle.
   

   Claude ta1sph-site'ı ve komutları (Siteyi Kur, Makale Ekle…) saymalı. Görmüyorsa: dosya yolunun tam olarak .claude/skills/ta1sph-site/SKILL.md olduğunu kontrol edin ve paneli yeniden başlatın.

6. İlk prompt'u gönderin: docs/ILK_PROMPT.md içindeki kod bloğunu kopyalayıp yapıştırın.

7. Aşamaları onaylayarak ilerleyin. Claude her aşamanın sonunda durup özet verecek. "Devam" yazmanız yeterli. Komut çalıştırma izinleri sorulduğunda (npm install, git commit vb.) okuyup onaylayın.

Kullanım ipuçları

• Yeni bir sohbet başlattığınızda Claude hafızayı CLAUDE.md → PROJECT_MEMORY.md üzerinden okur; projeyi baştan taramaz.
• Bir oturum çok uzarsa yeni sohbet açın; hafıza sayesinde kaldığı yerden devam eder.
• Hafızanın kodla uyumsuz olduğunu düşünürseniz: Hafızayı Güncelle.
• Skill'i daha sonra değiştirmek isterseniz SKILL.md veya references/*.md dosyalarını düzenleyin ya da Claude'a "skill'e şu kuralı ekle" deyin.

Deploy (site hazır olduğunda)

Yayına Al komutunu verin; Claude size references/deployment.md'deki Dokploy kontrol listesini (DNS, port yönlendirme, domain, SSL, volume, www→apex) adım adım uygulatacak.