diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7376f05
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Code Agent MD
+
+Bu proje, Apple platformlari icin SwiftUI odakli gelistirme kurallarini derleyen iki ana dokumandan olusur. Amac, AI coding agent'lar icin macOS ve tvOS uygulamalarinda best practice'leri net ve uygulanabilir kurallar halinde sunmaktir.
+
+## Icerik
+- `macOS_Development_Rules.md`: macOS uygulamalari icin mimari yaklasim, pencere/toolbar/menuler, navigasyon (sidebar + detail), veri kaliciligi ve AppKit entegrasyonu gibi konularda kurallar ve checklist.
+- `tvOS_Development_Rules.md`: tvOS icin 10-foot UI, Focus Engine mantigi, navigation/shelf yapilari, Siri Remote girdileri, medya oynatma ve performans konularinda kurallar ve checklist.
+
+## Kapsam
+- SwiftUI merkezli yaklasim
+- Platforma ozel tasarim ve etkileşim standartlari
+- Uygulama mimarisi ve kullanici deneyimi odakli kontrol listeleri
+
+## Kullanım
+Bu dokumanlar, kod uretimi veya uygulama gelistirme sirasinda referans alinmak uzere hazirlanmistir. Ozellikle platforma ozel davranis farklari ve UI kalitesi icin temel kurallari hatirlatir.