Persona'dan yazarlar için karakter incili (character bible) çıkar

Moonborn içindeki persona yapılandırılmış veridir — arayüzde kart kart düzenlenir. Ama yazarların iş akışı farklıdır: bir Markdown dosyası, sahne notlarıyla yan yana, kendi editörlerinde. Karakter incili (character bible) bu iki dünyayı bağlar.

İncil aslında Git senkronizasyonunun ürünüdür: kanonik persona Git deposunda YAML başlığı + Markdown gövde olarak yaşar, yazar editöründe düzenler, PR incelemesinden geçer, birleştirme (merge) sonrası değişiklikler Moonborn'a geri akar. Denetim hattı çalışır, gerekirse voice fingerprint yeniden hesaplanır.

Bu rehber bir persona'nın incile nasıl indiğini, neyi güvenle düzenleyebileceğini, neyi düzenlememen gerektiğini ve Git'ten yapamadığın eylemlerin nereye ait olduğunu anlatır.

Bu rehberi bitirdiğinde

• Bir persona'nın incil dosya yapısını (başlık + gövde) okuyabileceksin.
• Hangi alanları güvenle düzenleyebileceğini ve hangilerini bırakman gerektiğini ayırt edebileceksin.
• Ses örnekleri, sahne referansları ve hikâye notlarını incile ekleyebileceksin.
• Mask refine veya voice fingerprint yeniden hesaplama gibi sunucu tarafı eylemlerin Git'ten yapılamayacağını bilip nereye yönleneceğini bileceksin.
• Yazarlık akışını PR-inceleme tabanlı bir sürece bağlayabileceksin.

Ön koşul: bir Moonborn persona'sı, Team veya üzeri plan (Git senkronizasyonu plan kapısıyla kontrollü). Git senkronizasyonu henüz bağlı değilse önce Persona'ları Git ile senkronize et rehberine bak.

İncil dosya anatomisi

Her persona, yapılandırdığın integrations.git.base_path altında tek bir .md dosyası olur. Dosya iki bölümden oluşur:

---
id: per_01H...
name: Mert Aksoy
version: 4
created_at: 2026-05-17T10:00:00Z
soul:
  desire: dünyanın görmezden gelemeyeceği bir şey inşa etmek
  fear: sıradan görünmek
  wound: sevgiyi başarıyla ölçen bir ebeveyn
  growth_arc: onay arayan → kendine güven
self:
  traits: [tetikte, disiplinli, merhametli]
  values: [hız, dürüstlük, güven]
mask:
  voice: kısa, doğrudan, az duygu
  signature_phrases:
    - "Hızlıca toparlayalım"
    - "Şu an için yeter"
surface:
  age: 34
  location: İstanbul, TR
  occupation: startup founder
voice_fingerprint_id: vfp_01H...
audit:
  score: 4.3
  passed: true
---
 
Mert yirmili yaşlarını İstanbul tech sahnesinde geçirdi. İlk şirketi
bir Türk telekoma satıldı — hâlâ "fena değil" diye anlattığı sessiz
bir çıkış (exit). İkinci girişimde her yatırımcı toplantısında kahve
içtiğini saymaya başladı; sayı altıyı aşınca beni terapiye yollayan
o oldu.
 
## Ses örnekleri
 
> "Bak, momentum hakkındaki şey kimsenin seni nereye götürdüğünü
> sormaması. Sadece hareket etmeye devam ediyorsun."
 
> "İyiyim. (Duraklama.) Hep iyiyim."
 
## Yazar odası notları
 
S2E04'te Mert'in kız kardeşiyle yaşadığı yüzleşme, growth_arc'ın
"kendine güven"e geçişini tetikleyen sahne. Ses burada yumuşar.

Başlık (frontmatter) yapılı katmanları (Soul, Self, Mask, Surface) ve çalışma zamanı üstverisini taşır. Gövde yazı alanıdır — hikâye notları, ses örnekleri, sahne referansları.

Güvenle düzenleyebileceklerin

desire, fear, wound, growth_arc
→ Karakterin iç motoru. Düzenlersen çalışma zamanı
   davranışı değişir; denetim yeniden koşar.

Daha fazla özen gerektirenler

Asla değiştirme

id: per_01H...           # ← soy anahtarı; fork ağacını kırar
version: 4               # ← Moonborn yönetir; sürüm artırımını sunucu yapar
voice_fingerprint_id: vfp_01H...  # ← Moonborn yönetir; Mask düzenlersen düşer
created_at: ...          # ← değiştirilemez

id değiştirilirse ebeveyn-çocuk soy kenarları kopar, aşağı akıştaki fork'lar ebeveyni bulamaz olur. version ve voice_fingerprint_id Moonborn tarafından kontrol edilir — arayüz veya API'den değişir.

Git'ten yapamadıkların

Bazı eylemler sunucu tarafında koşmak zorundadır — Git'ten dosyayı düzenlemek bunları tetiklemez:

PR-inceleme tabanlı yazarlık akışı

Pratik yazarlık döngüsü:

1. Yazar dal (branch) açar, incili editöründe günceller (Soul / Self / Surface + gövde).
2. PR açılır; mühendislik ve hikâye lideri inceler.
3. Denetim PR kontrolü olarak koşmaz — birleştirme sonrası Moonborn senkronizasyon turunda koşar.
4. Birleştirme sonrası Moonborn senkronizasyonu çalışma alanını günceller, denetim yeniden koşar.
5. Denetim başarısız olursa persona.audit_failed webhook'u tetiklenir → inceleme kuyruğu (Marka için denetim izi).
6. Mask değiştiyse parmak izi yeniden hesaplanır; çalışma zamanı yeni referans hatta göre drift'i ölçer.

Plan gereksinimi

Team ve üzeri (Git senkronizasyonu plan kapısıyla kontrollü).

İlgili