Listelemeler yayına girmeden nasıl tanıtılacağını onayla

Dizin formlarının çoğu iki bölümden oluşur. Biri ürünü, diğeri seni anlatır: bir maker biyografisi, adın ve bağlı olduğun kurum, bazen de bir lansman panosunda “bunu neden yaptım” yorumu. Araç seti bu iki bölümü bilerek birbirinden ayrı tutar. Ürünle ilgili iddialar metin atölyesinden gelir ve copy.md dosyasında durur; kişisel iddialar ise identity.json dosyasından ve araç setinin tanıtım brifingi (representation briefing) dediği, PR-BRIEFING.md içinde anlatılan kısa bir oturumdan gelir. Bu rehber, bu oturumun ne olduğunu, neden var olduğunu ve sonunda representation.md dosyasına neyin yazıldığını açıklıyor.

Neden ayrı bir oturum

product.json dosyasını az önce doldurmuş bir ajan ürünün hakkında çok şey bilir, ama nasıl tanıtılmak istediğin hakkında çok az şey. Kendi haline bırakılırsa bulabildiği her şeyden (eski bir işverenden, önceki bir projeden, GitHub profilindeki şehirden) doğaçlama bir biyografi çıkarır ve bunu, geri almanın zor olduğu herkese açık bir maker profiline yapıştırır. Brifing, kullanılacak cümlelerin tam halini görmeden hiçbir kişisel bilginin bir listelemeye ulaşmaması için vardır. Ürün başına bir kez, ilk kişisel bilgi herkese açık hale gelmeden önce yapılır; bu bilgiler değiştiğinde de tekrarlanır.

Üç soru

Ajan bunları sana doğrudan ve sade bir dille sorar:

1. Kendini birey olarak mı, şirket olarak mı, yoksa ikisi birden mi tanıtıyorsun? Bu, bir formdaki “maker” alanına takma adının mı, yasal adının mı, yoksa bir kuruluş adının mı yazılacağını belirler.
2. Hangi takma ad, ad ve kurum bağlantısı görünebilir? identity.json içindeki her bilgi her listeleme için değildir.
3. Hakkında asla ne söylenmemeli? Geçmiş ürünler, alakasız bir işveren, gerçek konumun: bir lansman gönderisinde adınla birlikte görmek istemediğin her şey.

Neyin sorulmadığına dikkat et: ajan seçenek uydurup senden birini seçmeni istemez. Kısıtları toplar, ardından yalnızca onaylanmış bilgilerden yazar.

Birebir gösterilen üç örnek

Ajan yalnızca senin onayladığın bilgileri kullanarak üç kısa metin taslağı hazırlar ve bunları sana kelimesi kelimesine gösterir:

• bir dizin profili için tek satırlık bir maker biyografisi;
• tek cümlelik bir lansman ya da forum girişi, yani Show HN tarzı bir gönderinin veya lansman panosundaki bir yorumun ihtiyaç duyduğu türden bir açılış;
• tek cümlelik bir “bunu neden yaptım” yorumu.

Sonra önemli olan tek soruyu sorar: burada yanlış, abartılı ya da eksik bir şey var mı? Her düzeltme yalnızca identity.json içine sessizce not edilmez, doğrudan örneklerin kendisine uygulanır. Bu ayrım bilinçlidir: veri dosyasını düzeltip eski ifadeyi taşıyan bir taslağı elinde tutan ajan, eski ifadeyi yeniden kullanır. Görmediğin hiçbir şey yayımlanmaz.

Ne, nereye kaydedilir

Onaylanan örnekler, düzeltmelerin ve onay tarihi, özel çalışma alanındaki ürün klasöründe representation.md dosyasına yazılır. Bundan sonra biyografi ya da giriş metni gerektiren her playbook adımı, yeni bir şey yazmak yerine buradan okur. Dosyanın güvenilir kalmasını iki sınır sağlar:

• Kişisel iddialar asla copy.md içindeki ürün iddialarıyla karıştırılmaz; tersi de geçerlidir. Ürün bağlam dosyası ürünü anlatır, representation.md ise seni.
• Dosya ortak teslimat deposunun değil, her zaman özel çalışma alanının parçasıdır ve yalnızca yayımlanmasını onayladığın bilgileri içerir. Özel hesap e-postan ya da identity.json içinde gizli olarak işaretlediğin başka hiçbir şey bu dosyada yer almaz.

İlk oturumdaki yeri

Brifing, ajanın yönettiği onboarding sürecinin üçüncü aşamasında, identity.json doldurulduktan hemen sonra ve herhangi bir dizinde tarayıcı çalışması başlamadan önce yer alır. Birkaç dakika sürer. Atlayıp biyografileri o anda ajanın yazmasına bırakırsan, nasıl tanıtıldığını kendi ürününü Product Hunt maker sayfasında aradığında öğrenirsin. Maker profilini neden lansman gününden sonra değil de önce hazırlamaya değdiğini tek başına çalışan geliştiriciler için lansman kontrol listesi daha ayrıntılı anlatıyor.