LaunchRepoBrief’i doldur
Doğrudan alanlara yaz. Aşağıdaki Markdown ve JSON sen yazdıkça güncellenir; kopyalamaya ya da indirmeye hazırdır.
Örnek, uydurma bir kafe vardiya planlama uygulamasıdır. Her alanı kendi ürününle değiştir.
Taslağın bu tarayıcının yerel depolamasında tutulur, böylece sayfa yenilense de kaybolmaz. Asla yüklenmez. Temizle onu siler.
Markdown önizlemesi
# [Ürün adı] > [Ne yaptığı ve kimin için olduğu, tek satırda] Son güncelleme: [tarih] ## Sorun [Bugün kim neyle uğraşıyor] ## Kimin için [Asıl kullanıcılar ve alıcılar] ## Ne yapar [Ürün sorunu nasıl çözer] ## Temel yetenekler - [Bugün yaptığı en fazla üç şey] ## Bunun yerine [İnsanlar bugün ne kullanıyor ve bu neden daha iyi] ## Kapsam dışı [Bilerek yapmadığı şeyler] ## İşe yaradığını nereden anlarız [Kontrol edebileceğin tek bir sinyal] ## Bağlantı [Web sitesi ya da depo URL’si]
JSON önizlemesi
{
"format": "product-brief",
"version": 1,
"language": "tr",
"updated": "",
"name": "",
"oneLiner": "",
"problem": "",
"audience": "",
"solution": "",
"features": [
"",
"",
""
],
"alternative": "",
"nonGoals": "",
"success": "",
"url": ""
}
Boş dosyalar
Kendi düzenleyicini mi tercih edersin? Boş şablonu iki biçimden birinde al.
Her alan ne işe yarar
On alan, insanları ve ajanları ne inşa ettiğin konusunda aynı noktada buluşturmaya yeter. Her biri, aksi hâlde birinin sana soracağı bir soruyu yanıtlar.
- Ürün adı
- Ajan dahil herkes adı aynı şekilde yazmalı. Burada bir kez yaz.
- Tek cümle
- Listelemelerde, biyografilerde ve ana sayfanda yeniden kullanacağın cümle. Onu yazamıyorsan ürün henüz net değildir.
- Sorun
- İş özellikten değil sorundan başlar. Net bir sorun, başkalarının seninkinden daha iyi çözümler önermesine olanak tanır.
- Kimin için
- Dar bir kitle sonraki her kararı kolaylaştırır: ifadeler, özellikler, nerede lansman yapılacağı.
- Ne yapar
- Ürünün sorunu nasıl çözdüğü, sade kelimelerle. Yeni gelen birinin ilk ihtiyaç duyduğu şey budur.
- Temel yetenekler
- Bugün var olan üç yetenek. Metin yazan bir ajan asla dördüncüsünü uydurmamalı.
- Bunun yerine
- İnsanlar şu an yaptıklarıyla karşılaştırır. Geçici çözümün adını koymak, değerini bir özellik tablosundan daha iyi anlatır.
- Kapsam dışı
- Çoğu brief’in atladığı alan. Kapsamın kaymasını durdurur ve ajanın istemediğin özellikleri eklemesini engeller.
- İşe yaradığını nereden anlarız
- Gözlemlenebilir tek bir sinyal ürünün işe yarayıp yaramadığını söyler ve ajana kontrol edebileceği bir hedef verir.
- Bağlantı
- Bağlantı, okurun ya da ajanın ayrıntıları tahmin etmek yerine doğrulamasını sağlar.
Sloganını her platformun karakter sınırına göre kontrol et →
Brief’i ajanına ver
Kodlama ajanları deponundaki Markdown dosyalarını okur. Kodunun yanında duran kısa bir brief, onlara kodun tek başına içermediği ürün bağlamını verir.
- Markdown dosyasını indir ve deponda, örneğin docs/product-brief.md olarak kaydet.
- Ajanını ona yönlendir: AGENTS.md dosyasına bir satır ekle ya da CLAUDE.md içinde @docs/product-brief.md ile içe aktar.
- GitHub Copilot için özü .github/copilot-instructions.md dosyasına bağla ya da kopyala.
- Bir betik ya da başka bir araç aynı bilgileri okuyacaksa JSON dosyasını da yanında tut.
- Bir şey değiştiğinde tarih satırını güncelle ve artık doğru olmayan cümleleri sil.
| Konu | Resmî ifade | Brief’in için anlamı |
|---|---|---|
| Biçim | AGENTS.md is just standard Markdown. | Düz bir Markdown brief’i, özel bir söz dizimi gerekmeden ajan bağlamı olarak çalışır. |
| Başlıklar | Use any headings you like; the agent simply parses the text you provide. | Bu şablondaki bölüm adları bir öneridir. Ekibin başka kelimeler kullanıyorsa yeniden adlandır. |
| Ne zaman okunur | You write these files in plain text; Claude reads them at the start of every session. | Claude Code, CLAUDE.md dosyasını her oturumun başında yükler; böylece içe aktarılan brief her zaman bağlamdadır. |
| İçe aktarma | CLAUDE.md files can import additional files using @path/to/import syntax. | CLAUDE.md içinde @docs/product-brief.md gibi tek bir satır, brief’i dahil etmeye yeter. |
| Uzunluk | target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence. | Kısa bağlama daha iyi uyulur. Tek sayfalık bir brief bu boyutun çok altında kalır. |
| Copilot | Add natural language instructions to the file, in Markdown format. | Copilot talimatları da Markdown’dır, yani aynı metin oraya da uyar. |
| JSON kodlaması | JSON text exchanged between systems that are not part of a closed ecosystem MUST be encoded using UTF-8 | İndirilen JSON UTF-8’dir; aksanlar, CJK karakterleri ve emoji her araçta bozulmadan kalır. |
Brief, PRD ya da bağlam dosyası
Sık karıştırılan üç belge. Farklı sorulara yanıt verirler ve birçok ürünün birden fazlasına ihtiyacı vardır.
| Belge | Yanıtladığı soru | Uzunluk | Yazan |
|---|---|---|---|
| Ürün brief’i (bu şablon) | Ne inşa ediyoruz, kimin için ve nerede duruyoruz | Tek sayfa, on alan | Kurucu ya da ürün lideri |
| Ürün gereksinimleri belgesi (PRD) | Tek bir özelliğin ya da sürümün tam olarak nasıl davranması gerektiği | Özellik başına birkaç sayfa | Mühendislikle birlikte ürün yöneticisi |
| Ürün bağlamı dosyası | Bir ajanın hangi onaylı bilgileri ve metinleri yayımlayabileceği | Her kanalla büyür | Lansmanı kim yürütüyorsa |
Bu şablonun kapsamadıkları
- Bir başlangıç noktasıdır, eksiksiz bir şartname değil. Ayrıntılı gereksinimler, tasarımlar ve araştırmalar kendi belgelerinde yer alır.
- Fiyatlandırma, lansman tarihleri ve pazarlama metni varyantları bilerek dahil edilmemiştir.
- Sayfa, ifadelerinin doğru olup olmadığını kontrol etmez. Yalnızca ürünün bugün yaptıklarını yaz.
- Hiçbir şey bir yere gönderilmez: taslak, Temizle’ye basana kadar bu tarayıcıda kalır.
Kaynaklar
Bu sayfaları 30 Eylül 2026 tarihinde okuduk ve yukarıda kelimesi kelimesine alıntıladık.
| Sayfa | Sayfadaki tarih | Bizim kontrolümüz |
|---|---|---|
| AGENTS.md | tarih belirtilmemiş | |
| Claude Code Docs: How Claude remembers your project | tarih belirtilmemiş | |
| GitHub Docs: Adding repository custom instructions for GitHub Copilot | tarih belirtilmemiş | |
| RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format (December 2017) | tarih belirtilmemiş | |
| CommonMark Spec, version 0.31.2 | tarih belirtilmemiş |
SSS
- Ürün brief’i nedir?
- Bir ürünün ne olduğunu, hangi sorunu kimin için çözdüğünü ve neyi bilerek dışarıda bıraktığını anlatan kısa bir belgedir. Ürün üzerinde çalışan herkese, insanlara ve ajanlara, aynı başlangıç noktasını verir.
- Ürün brief’i PRD’den nasıl farklıdır?
- Brief tüm ürünü tek sayfada ele alır. Ürün gereksinimleri belgesi (PRD) tek bir özelliğe ya da sürüme derinlemesine iner ve tam olarak nasıl davranması gerektiğini anlatır. Brief ile başla; bir özellik bu ayrıntıyı gerektirdiğinde PRD yaz.
- Bir yapay zekâ kodlama ajanı bu brief’i kullanabilir mi?
- Evet. Markdown dosyasını depona kaydet ve AGENTS.md dosyasından ona bağlantı ver ya da CLAUDE.md içinde içe aktar. AGENTS.md düz Markdown’dır ve Claude Code, CLAUDE.md dosyasını her oturumun başında okur.
- Neden Markdown ve JSON?
- Markdown insanlar ve ajanlar için kolay okunur ve her kod barındırma hizmetinde düzgün görüntülenir. JSON aynı içeriği sabit İngilizce anahtarlarla taşır; böylece betikler ve formlar düz yazıyı ayrıştırmadan okuyabilir.
- Brief’im bir yerde saklanıyor ya da gönderiliyor mu?
- Yalnızca tarayıcının yerel depolamasında saklanır, böylece sayfayı yenilediğinde kaybolmaz. Hiçbir şey yüklenmez ya da analitiğe gönderilmez; Temizle taslağı siler.
Brief hazır mı? Ürününü insanların önüne çıkar.
LaunchRepo, kodlama ajanına her lansman platformu ve dizin için bir rehber verir; böylece az önce anlattığın ürün, kitlenin baktığı yerlerde listelenir ve hangi listelemelerin yayına girdiği takip edilir.
Fiyatları gör