docs: add project memory, Claude instructions and design references

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -0,0 +1,15 @@
+# ta1sph.info — Claude Code Proje Talimatları
+
+Bu dosya Claude Code tarafından her oturumda otomatik okunur.
+
+- Proje: Suphi Çakır (TA1SPH) amatör telsizcilik Blog & Portfolio sitesi — Astro + TailwindCSS, Dokploy ile `https://ta1sph.info`.
+- Tüm işler için **`ta1sph-site` skill'ini** kullan (kullanıcı düzeyinde yüklü; repoda kopyası yok).
+- Astro CLI / dev server kuralları: @AGENTS.md
+- Komutlar: **Siteyi Kur · Makale Ekle · Makale Düzenle · Uygulama Düzenle · Yayına Al · Hafızayı Güncelle**
+- Kullanıcıyla Türkçe konuş; kod/commit İngilizce.
+- **Projeyi baştan tarama.** Önce aşağıdaki proje hafızasını oku, sadece görevin gerektirdiği dosyaları aç.
+- Her görevin sonunda `PROJECT_MEMORY.md` dosyasını güncelle (skill Bölüm 5).
+
+## Proje hafızası
+
+@PROJECT_MEMORY.md

PROJECT_MEMORY.md

@@ -0,0 +1,47 @@
+# PROJECT_MEMORY — ta1sph.info
+
+> Claude'un bu proje için kalıcı hafızası. Her görev sonunda güncellenir. Kısa ve güncel tutulur.
+> Son güncelleme: 2026-10-15 · Güncelleyen: kurulum kiti
+
+## 1. Durum
+
+- **Aşama:** 0 — Proje henüz kurulmadı. Sıradaki komut: `Siteyi Kur`.
+- **Tamamlanan:** Skill + hafıza dosyaları eklendi.
+- **Açık işler:** Aşama 0–8 (`references/build-plan.md`).
+- **Bilinen sorunlar:** —
+
+## 2. Ortam
+
+- Astro sürümü: _(Aşama 0'da doldurulacak)_
+- TailwindCSS sürümü: _(Aşama 0'da doldurulacak)_
+- Node sürümü: _(Aşama 0'da doldurulacak)_
+- Repo: _(doldurulacak)_ · Branch: `main`
+- Canlı: https://ta1sph.info (Dokploy, HomeServer Atlas) — _henüz yayında değil_
+
+## 3. Dosya Haritası
+
+_(Kurulumdan sonra önemli dosya/klasörler tek satır açıklamayla buraya yazılır.)_
+
+## 4. Kararlar (ADR)
+
+| Tarih | Karar | Gerekçe |
+|---|---|---|
+| 2026-10-15 | Statik çıktı + `@astrojs/node` ile sadece `/api/views` dinamik | "Öne çıkan = en çok okunan" için sayaç gerekli; site geri kalanı statik ve hızlı |
+| 2026-10-15 | Sayaç: SQLite (`better-sqlite3`), volume `/app/data` | Harici servis yok, ev sunucusunda basit ve kalıcı |
+| 2026-10-15 | Arama: Pagefind | Statik, sunucusuz, Türkçe destekli |
+| 2026-10-15 | Harita: Leaflet + OpenStreetMap | API anahtarı / ücret yok, KVKK dostu |
+| 2026-10-15 | İkonlar: astro-icon + Tabler | Tutarlı çizgi seti, anten kulesi ve marka ikonları mevcut |
+| 2026-10-15 | Lisans: Kod MIT, içerik CC BY-SA 4.0 | Kaynak gösterilerek serbest kullanım talebi |
+| 2026-10-15 | Kanonik alan: apex `ta1sph.info`, www → 301 | SEO tekilleştirme |
+| 2026-10-15 | Fontlar self-host (Fontsource: Rubik + Inter) | Performans + gizlilik |
+| 2026-10-15 | Locator KN41KB99HW → 41.08307 N, 28.91094 E | Harita merkezi |
+
+## 5. İçerik Envanteri
+
+| Slug | Başlık | Kategori | Oluşturma | Güncelleme | Durum |
+|---|---|---|---|---|---|
+| — | — | — | — | — | — |
+
+## 6. Değişiklik Günlüğü (en yeni üstte)
+
+- 2026-10-15 | Kurulum | Skill, CLAUDE.md ve PROJECT_MEMORY.md eklendi | `.claude/`, `CLAUDE.md`, `PROJECT_MEMORY.md`

docs/ILK_PROMPT.md

@@ -0,0 +1,42 @@
+# İlk Prompt — Claude Code'a yapıştırın
+
+```text
+Siteyi Kur
+
+ta1sph-site skill'ini kullan. Önce PROJECT_MEMORY.md ve skill'in references/ klasöründeki
+project-spec.md, design-system.md, content-model.md ve build-plan.md dosyalarını oku.
+Tasarım referansı için docs/design-reference/ içindeki ekran görüntülerine bak
+(Huemint "Website / Magazine" önizlemesi, palet: #f2efee #d5d09b #111012 #c95748).
+
+Aşama 0'dan başla: ortamı kontrol et, Astro ve TailwindCSS'in güncel sürümlerini doğrula,
+bana kısa bir uygulama planı sun ve onayımı bekle. Sonra build-plan.md'deki aşamaları
+sırayla uygula; her aşama sonunda build al, commit at, PROJECT_MEMORY.md'yi güncelle,
+bana kısa durum ver ve devam için onay iste.
+
+Emin olmadığın kişisel veya teknik bilgiyi uydurma, bana sor.
+```
+
+## Sonraki oturumlarda örnek komutlar
+
+```text
+Makale Ekle
+Dosya: ~/Belgeler/makaleler/moxon-anten.docx — görseller aynı klasörde. Kategori: antenler.
+```
+
+```text
+Makale Düzenle
+"moxon-anten-yapimi" makalesine ölçü tablosundan sonra SWR ölçüm sonuçları bölümü ekle: ...
+```
+
+```text
+Uygulama Düzenle
+Ana sayfadaki Telegram kartlarına üye sayısı yerine kısa açıklama ekle ve kartları 3 sütun yap.
+```
+
+```text
+Yayına Al
+```
+
+```text
+Hafızayı Güncelle
+```

docs/KURULUM.md

@@ -0,0 +1,67 @@
+# 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):
+
+   ```bash
+   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:
+
+   ```text
+   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.