---
title: DESIGN.md nedir ve nasıl kurulur?
category: guide
canonical: https://forgehouse.ai/tr/rehberler/design-md-nedir/
lang: tr
hreflang_alt: https://forgehouse.ai/guides/design-md-claude-setup/
last_updated: 2026-06-20
---

# DESIGN.md nedir ve nasıl kurulur?

> DESIGN.md; bir AI'ya marka kurallarını: palet, tipografi, boşluk ve ton, veren bir proje dosyasıdır, böylece her üretilen ekran jenerik bir varsayılana gerilemek yerine marka-uyumlu kalır.

## DESIGN.md dosyası nedir?

Projenin köküne konan bir marka anayasasıdır: palet hex kodları, font aileleri ve ağırlıkları, spacing ölçeği, ton ve asla yapılmayacaklar. Tasarım dilini kafanda tutmak yerine, ajanın her görevde okuyabileceği tek bir yere yazarsın. İşe yeni başlayan bir tasarımcıya ilk gün uzatılacak referans gibi düşün.

Mekanik olarak sadece bir Markdown dosyasıdır; düz metin, özel bir format yok, deponun içinde Claude Code gibi bir kodlama ajanının kaynakla birlikte okuyabileceği yerde durur. Bütün hile bu: model proje dosyalarını bağlam olarak ele alır, dolayısıyla ajanın zaten okuduğu bir dosyaya yazılmış tasarım dili, sürekli yeniden anlattığın bir şey değil, çalışma biçiminin parçası olur. Ekiplerin bir ajana kod tabanının kurallarını uzatmak için kullandığı README ya da CLAUDE.md dosyasının görsel kardeşidir, yalnızca bu, build komutları yerine görünüşü taşır.

## Bir AI'ya neden açık tasarım kuralları verirsin?

Kural olmadan model her üretimde görünüşünü baştan tahmin eder ve çıktı sürüklenir; her seferinde biraz farklı bir mavi, rastgele boşluklar, kayık bir buton köşesi. Açık kurallar tasarım dilini, tekrar etmek zorunda olduğun bir istek olmaktan çıkarıp sabit hale getirir. Kararlar yeniden alınmayı bırakıp izlenmeye başlar.

Asıl bedel bu sürüklenmedir ve birikerek büyür. Model doğası gereği belirlenimsizdir, yani "marka uyumlu" diyen iki prompt birbirinden ince farklarla ayrılan iki marka üretir ve bir düzine ekran boyunca o küçük farklar, derme çatma birleştirilmiş, profesyonellikten uzak bir ürün gibi okunur. Kuralları sabitlemek, sürekli yaptığın bir isteği ajanın devraldığı bir karara çevirir; tek kişilik bir ekibin, normalde her ekranı denetleyen bir tasarım liderini gerektiren tutarlılığı böyle yakalamasının da yoludur. Modeli daha zeki yapmıyorsun; tahmin etmesine kalan boşluğu kaldırıyorsun.

## DESIGN.md'de ne yer alır?

Somut ve tekrarlanabilir olanlar: tam renkler, tipografi kuralları, spacing ölçeği, buton ve kart gibi komponent desenleri ve kaçınılacakların anti-pattern listesi. Net ol; "metin için #141413, asla saf siyah değil" ifadesi "koyu metin kullan"dan iyidir. Ne kadar çok kararı sabitlersen model o kadar az doğaçlama yapar.

Belirlilik, çalışan bir dosyayla depoyu süsleyen bir dosya arasındaki farktır. Tam hex değerlerini rolleriyle ver (ana, vurgu, metin, yüzey, anlamsal), font ailelerini ağırlıklarıyla ve tipografi ölçeğini, spacing adımlarını gerçek sayılarla, ajanın yeniden icat etmek yerine kullanacağı adlandırılmış komponent desenlerini. Anti-pattern listesi, olumlu olarak sayamayacağın boşlukları kapatarak yerini hak eder; "saf siyah yok, gölge yok, ikiden fazla font yok, metinde asla gradyan yok", çünkü modele neden kaçınacağını söylemek, yapabileceği her şeyi tarif etmekten çoğu zaman daha nettir. Doğru kalacak kadar kısa tut; kimse güncellemediği için yalan söyleyen bir DESIGN.md, hiç olmamasından kötüdür.

## Çıktıyı marka-uyumlu nasıl tutar?

Model her tasarım görevinin başında dosyayı okur, böylece kurallar prompt'a yazdığın şeye değil projeye bağlı yaşar. Bir kişi paleti dosyada günceller ve sonraki tüm üretimler bunu otomatik devralır. Marka tutarlı kalır çünkü birinin hafızasında değil kod tabanında durur.

Bu, bir tasarım token sistemini çalıştıran ilkenin aynısıdır; kuralları tek kaynak olarak tutmak, yalnızca burada bir build hattı yerine ajanın okuduğu dille ifade edilir. Dosya kodun yanında yaşadığı için projeyle birlikte gezer: bir ekip arkadaşı, gelecekteki sen ya da yepyeni bir ajan oturumu, markayı yarı hatırlanan bir prompt'tan yeniden türetmek yerine hepsi aynı anayasadan başlar. Marka değiştiğinde dosyayı güncellersin ve değişiklik kendiliğinden her yere yayılır; tam istediğin ve tam da bir prompt'un veremeyeceği şey budur.

DESIGN.md en çok, içine ne koyacağını bildiğinde işe yarar; bu da savunulabilir bir [yapay zekâ renk paleti](/tr/rehberler/yapay-zeka-renk-paleti-secimi/) seçmenin ve [tasarımcı olmadan yapay zekâ tasarımının](/tr/rehberler/tasarimci-olmadan-yapay-zeka-tasarim/) disiplinini gerektiren bir ön iştir. Kodladığı kurallar, çıktının [jenerik yapay zekâ tasarımına](/tr/rehberler/yapay-zeka-tasarim-slop-onleme/) çökmesini engelleyen kurallarla aynıdır. Bunların tamamı, sektör mantığı, paletler ve bir DESIGN.md'ye yapıştırılmaya hazır kurallar, [Design Intelligence kiti](/tr/ai-kitler/design-intelligence-kit/) olarak gelir; daha geniş [yapay zekâ ile tasarım sistemi rehberinin](/tr/rehberler/yapay-zeka-ile-tasarim-sistemi/) içinde durur.

---
Üretici: Can Davarcı, https://candavarci.com.tr