Kitaplığa kitap ekle

Kitaplık bir okuma listesi değil, bir tavsiye listesi. Okunmuş ama tavsiye edilmeyen kitap buraya girmez — kullanıcı emin değilse sor.

Adımlar

1. Kitabı doğrula. Yazar adı ve yayın yılı konusunda emin değilsen WebFetch ile kontrol et. Yıl ve yazar uydurma — yanlış bibliyografik veri sitenin güvenilirliğini düşürür. Doğrulayamazsan year alanını boş bırak.

2. Notu yaz. Tek cümle: neden bu listede. Kitabın özeti değil, kullanıcı üzerindeki etkisi. Kullanıcı kendi cümlesini söylediyse onu kullan, düzeltme.

   İyi: “Mimari diyagramı okuma şeklimi herhangi bir mimari kitabından daha çok değiştirdi.” Kötü: “Sistem düşüncesinin temellerini anlatan klasik bir eser.”

3. Sırayı belirle. order alanı küçükten büyüğe sıralanır. Yeni kitap genelde sona gider: mevcut en büyük order + 1.

   grep -h '^order:' src/content/library/en/*.md | sort -t' ' -k2 -n | tail -1

4. Dosyayı yaz: src/content/library/en/<slug>.md Slug kebab-case, kitabın İngilizce adından, ASCII.

---
title: '<kitap adı>'
author: '<yazar>'
year: <yıl>
note: '<tek cümle: neden bu listede>'
order: <sayı>
---

Opsiyonel url: kitabın resmî sayfası veya yayıncısı. Affiliate link koyma. Verilirse kapak tıklanabilir olur.

5. pnpm verify çalıştır. Build ve kırık link kontrolü birlikte koşar.

Notlar

• Kapak görseli yok ve olmayacak — kapaklar başlıktan tipografik üretiliyor. Kitap kapağı indirip koyma.
• Türkçe kitaplık ayrı tutulmuyor; tr/ boşsa site İngilizce listeyi gösterir. Türkçe bir kitap eklenecekse src/content/library/tr/ altına konur ama o zaman tüm liste Türkçe doldurulmalı, yoksa yarım görünür.
• title ve author tek tırnak içinde yazılmalı — kitap adlarında sık sık iki nokta ve tırnak geçiyor, YAML bozuluyor.

Yazı / not / playbook ekle

1. Koleksiyonu seç

Kullanıcı söylemediyse sor, tahmin etme. Ayrım konuya göre değil, yazının olgunluğuna göredir:

Seç	Ne zaman
essays	Argüman bitmiş, iddia net, fikir değiştirmeyi amaçlıyor
notes	Henüz düşünüyor, emin değil, yarım. “Bunu çözemedim” havası
playbooks	Tekrar eden bir karar. Başkası aynı durumda kullanabilir

Kullanıcı uzun bir metin paylaştıysa ve hangisi olduğu belliyse sorma — söyle ve devam et.

2. Alanları hazırla

Ortak zorunlular:

title:       # başlık. İddiayı söyle, konuyu değil
description: # tek cümle. Liste sayfasında ve meta description'da çıkar
pubDate:     # bugün — `date +%F` ile al, tahmin etme
topics:      # src/config.ts TOPICS enum'undan en az bir tane. Uydurma

Koleksiyona özel:

• essays → featured: false (kullanıcı öne çıkarmak isterse true)
• notes → status: seedling (olgunlaştıkça budding, evergreen)
• playbooks → problem ve context zorunlu. İkisi de tek cümle. problem: hangi durumda bu playbook’a bakılır. context: hangi ölçek/teknoloji/sınırlar içinde geçerli.

topics değerlerini uydurma — önce src/config.ts dosyasındaki TOPICS listesini oku.

3. Dosyayı yaz

Yol: src/content/<koleksiyon>/<dil>/<slug>.md Dil varsayılan en; kullanıcı Türkçe yazdıysa tr. Slug kebab-case, İngilizce, ASCII, tarih içermez.

playbooks gövdesi bu başlıkları bu sırayla içermeli:

## Problem
## Context
## Approach
## Tradeoffs
## When this stops working

Son başlık atlanmamalı — playbook’u dürüst kılan o.

4. Doğrula

pnpm build

Şema hatası varsa düzelt ve tekrar çalıştır. Build geçmeden bitirme.

5. Çeviri

Kullanıcı istemedikçe çeviri üretme. Çeviri opsiyoneldir; aynı slug iki dilde varsa site otomatik bağlar. İstenirse diğer dil klasörüne aynı slug’la yaz — çeviri değil, o dilde yeniden yaz.

Kurallar

• Kullanıcının sesiyle yaz. Metin verdiyse onu düzeltme, yerleştir.
• Gövdeyi kullanıcı için uydurma. Taslak yoksa taslağı iste veya sadece iskeleti oluşturup draft: true koy.
• Başlıkta “The Ultimate Guide to”, “Everything You Need to Know” gibi kalıpları kullanma.

Sinyal ekle

Sinyal = bir link ve neden önemli olduğu. İki cümle, fazlası değil. Daha uzun bir şey söylemek gerekiyorsa bu bir sinyal değil, not veya yazıdır — kullanıcıya söyle ve new-entry skill’ini öner.

Adımlar

1. Linki oku. WebFetch ile sayfayı getir; başlık, yazar/yayıncı ve ana iddiayı çıkar. Sayfa alınamıyorsa kullanıcıdan özet iste, uydurma.

2. Alanları belirle.

   • title — sinyalin başlığı. Kaynağın başlığını kopyalama; senin ilgini çeken şeyi söyle. Örnek: kaynak “Building effective agents” ise başlık “Workflow mu agent mı” olabilir.
   • url — kanonik URL (takip/kampanya parametrelerini at).
   • source — yayıncı veya yazar. “Anthropic Engineering”, “@simonw” gibi.
   • description — tek cümle, liste sayfasında görünür.
   • topics — src/config.ts içindeki TOPICS enum’undan. Uydurma.
   • pubDate — bugün. Tarihi date +%F ile al, tahmin etme.

3. Dosyayı yaz: src/content/signals/en/<slug>.md Slug kebab-case, İngilizce, ASCII, tarihsiz. Kullanıcı Türkçe yazmak isterse tr/ altına koy.

---
title: <başlık>
description: <tek cümle>
pubDate: <YYYY-MM-DD>
url: <kanonik url>
source: <yayıncı>
topics: [<enum değerleri>]
tags: []
---

<Kaynağın ne dediği ve neden önemli olduğu — iki cümle. Özet değil, yorum.
Katılmadığın bir yer varsa söyle; sinyali değerli kılan o.>

4. pnpm build çalıştır. Şema hatası varsa düzelt.

5. Kullanıcıya dosya yolunu ve iki cümlelik gövdeyi göster.

Kurallar

• Gövde iki cümleyi aşarsa kes. Bu formatın tek kuralı bu.
• Kaynağın özetini yazma — kaynağın kendisi orada. Senin katkın yorum.
• topics enum dışında bir değer build’i patlatır.