Playcode School / AI brifi yazın

AI'a işini kontrol edebileceği bir brif verin.

Kurucu, Play'e üzerinde bir örnek kart ve işaretli üç kutu olan klipsli bir altlık uzatıyor; takım elbiseli biri ise elinde muğlak bir notla, dev bir lastik ördeği kaldıran vince bakakalmış.

AI aklınızdakini göremez. Ürünün kimin için olduğunu, verilerin neye benzediğini ya da iyi bir sonucun ne olduğunu yazmazsanız tahmin etmek zorunda kalır.

İşe yarar bir brif (AI'a verdiğiniz prompt) işin neyle başladığını söyler, bir örnek gösterir, sınırları belirtir ve kontrollerle biter. Böylece sonucu göz kararı değerlendirmek yerine test edebilirsiniz.

İşin neyle başladığını söyleyin.

İşin başladığı malzemeyi belirtin: müşterinin yüklediği dosya, zaten kullandığınız bir şablon, okunacak veriler ya da bugün var olan uygulama.

Anthropic'in prompt yazımı üzerine kılavuzu “Prompting best practices” (2026) bir test öneriyor: İsteğinizi, iş hakkında pek bilgisi olmayan bir iş arkadaşınıza gösterin. Onun kafası karışırsa AI'ınki de karışır.

Örnek: “Bir özet aracı oluşturun” demek, iş arkadaşınızı tahmin yürütmeye zorlar. “İşe alım danışmanları başvuruyu PDF ya da Word dosyası olarak yükler; ekteki müşteri firma şablonunu kullanın” demek ise ona nereden başlayacağını söyler.

Sonuçtan bir örnek gösterin.

Girdiden bir örnek ve karşılığında almak istediğiniz sonucu ekleyin; örneğin bir başvuru ve onun için yazacağınız özet. Aynı kılavuz örnekleri, dönen sonucun biçimini, tonunu ve yapısını yönlendirmenin en güvenilir yollarından biri sayar.

Kurgusal ya da izni usulüne uygun alınmış örnek veriler kullanın. Bir örneğin içindeki gerçek müşteri dosyası, yine de gerçek bir müşterinin dosyasıdır.

Neyin değişmemesi gerektiğini belirtin.

AI'ın neye dokunmaması gerektiğini, hangi verileri kullanabileceğini ve neyin sonraki bir sürüme kalacağını listeleyin. Oluşturmadan önce konan bir sınıra uymak, sonradan fark edilen bir sınıra uymaktan daha kolaydır.

Örnek: İşe alım kararları danışmanda kalsın, yalnızca eklediğim örnek başvuruları kullanın ve aday sıralamasını sonraya bırakın.

Kontrolleri oluşturmadan önce yazın.

İşin bittiğini nasıl anlayacağınıza iş başlamadan karar verin. Dan North'un “Introducing BDD” (2006) yazısı her kontrolü üç parça hâlinde yazar. Çalışması gereken her şey için bir kontrol, olmaması gereken şey için de bir kontrol yazın.

Diyelim ki (Given)
Başlangıçtaki durum. Örnek: PDF dosyası olarak örnek bir başvuru geliyor.
Eğer (When)
Olan şey. Örnek: İşe alım danışmanı bir özet istiyor.
O zaman (Then)
Doğru olması gereken şey. Örnek: Özetteki her ifade, alındığı satıra bağlantı veriyor.

AI brifinizi yazın.

Kendi projenizi kullanın ya da aşağıdaki örneği düzenleyin. Bir proje başlatmayı seçene kadar yanıtlarınız bu tarayıcıda kalır. Brifi herhangi bir AI aracına kopyalayın, indirin ya da onunla bir Playcode projesi başlatın.

Bu, düzenlenebilir bir örnektir; bitmiş bir teknik şartname değildir. Net bir brif sonucu kontrol etmeyi kolaylaştırır; yine de kontrolü siz yaparsınız.

Sonucu brifinizle karşılaştırın.

İlk sürüm hazır olduğunda her kontrolü kendiniz yapın ve hangilerinin geçip hangilerinin kaldığını not edin. AI'dan kendi işini aynı listeye göre kontrol etmesini de isteyebilirsiniz.

Geçemeyen kontrolleri birer birer, sıradaki isteğiniz olarak AI'a iletin. Kontroller geçtiğinde şuna karar verin: İnsanlar ürünü kullanmaya başlayınca ürün neleri kaydetmeli?