{"slug": "efektif-agents-md-olusturma-prompt", "title": "Efektif AGENTS.md oluşturma prompt", "summary": "A developer shared a detailed prompt for creating an effective AGENTS.md file, emphasizing evidence-based documentation over generic rules. The prompt outlines a three-stage process: gathering repository evidence, asking targeted questions, and writing a concise guide with specific sections like non-negotiables, pitfalls, and verification steps.", "body_md": "Bu repo için AGENTS.md yaz. Amaç kural listesi değil: buraya yeni düşen bir kodlama ajanının (ve yeni ekip üyesinin) hangi hataları yapacağını önceden kesen bir harita.\n\nAŞAMA 1 — Kanıt topla. Önce oku, sonra yaz. Uydurma yok.\n\n- package.json / pyproject / go.mod / Gemfile: script'ler, paket yöneticisi, runtime sürümü pinlenmiş mi (.nvmrc, engines, volta gerçekten var mı?)\n- Dizin ağacı (2 seviye). Aynı işi yapan iki klasör var mı? (api/ + apis/, navigations/ + routes/ gibi) — bunlar göç halinde, not al.\n- CI dosyaları: gerçekte hangi komutlar çalışıyor, hangileri lokalde gereksiz.\n- Test kurulumu: testler nerede duruyor, ortak helper/mock nerede, hangi komut tek dosya çalıştırıyor.\n- README, varsa mevcut AGENTS.md / CLAUDE.md / .cursorrules.\n- Son 50 commit: en çok dokunulan dosyalar, revert'ler, \"fix:\" desenleri.\n- Ortam ve build: .env.*, config/, ios/, android/, patches/, Dockerfile. Yazdığın her komut, yol ve dosya adı gördüğün bir şey olsun. Doğrulayamadığını yazma; emin değilsen \"bunu doğrulayamadım\" de.\n\nAŞAMA 2 — Bana 5 soru sor, cevaplarımı bekle. Bunlar kodda yok:\n\n- Bu üründe asla bozulmaması gereken 3 şey ne?\n- Yeni gelen biri ilk haftasında neyi kırar, nerede saat kaybeder?\n- Repodaki hangi \"garip\" şey bilerek öyle? (kaldırılmasını istemediğin şey)\n- Gelen hataların en sık tipi ne — değişiklikler genelde neyi ıskalıyor?\n- Sormadan çalıştırmamam gereken komutlar? (pahalı, yıkıcı, ortama bağlı)\n\nAŞAMA 3 — Şu iskeletle yaz, 150 satırı geçme:\n\n- Bu repo tek paragrafta: ne, kim için, hangi teknoloji, prod'da ne riski var.\n- Asla taviz verilmeyenler — 3-5 madde, her biri bir başlık + 2 cümle. Bunlar yasak değil değer: neden umursadığımızı anlat.\n- Küçük sözlük — bu ekibin kendine has kelimeleri, koddaki karşılığıyla birlikte. Genel yazılım terimlerini tanımlama.\n- Kendini yaralamanın yolları — 3 madde, bu repoya özel gerçek tuzaklar. Her biri: ne yapma + neden patlıyor + onun yerine ne yap.\n- Her yüzeye dokun — buradaki en sık defect \"test ettiğin yolda doğru, geri kalan her yerde eksik\" olan değişiklik. Bir değişikliğin peşinden gitmesi gereken yerlerin kontrol listesi (platformlar, diller, katmanlar, ortamlar, ters durumlar: ileri yolu eklediysen geri yolunu da ekle).\n- Komutlar — gerçekten çalışan en küçük komutlar. İzin almadan çalıştırılmaması gerekenleri ayrı yaz, sebebiyle.\n- Doğrulama — \"değişikliğin çalıştığının en küçük kanıtı\" ne? Tüm suite'i çalıştırmak cevap değil.\n- Nasıl çalışıyor — bir istek/veri sistemin içinde baştan sona nereden geçiyor, tek paragraf.\n- Kod nerede yaşar — kısa dizin haritası + hiç açılmaması gereken klasörler.\n- Zevk — bu kod tabanında iyi kodun neye benzediği. Tercihler, dogma değil.\n- Bitirirken — bir görevin sonunda benden ne beklendiği.\n\nKALİTE TESTİ — teslim etmeden önce her satır için sor: \"Bu cümle başka bir repoya olduğu gibi kopyalanabilir mi?\" Cevap evetse sil. \"Küçük değişiklikler yap\", \"temiz kod yaz\", \"testleri geç\" gibi cümleler yer kaplamaktan başka iş yapmaz; ajan zaten bunları biliyor. Bilmediği şey senin repondaki tuzaklar.\n\nTON: kısa cümleler, düz anlatım. Yasak listesi yerine sebep. Bunlar kanun değil iyi varsayılanlar — geliştiricinin tercihi bu dosyayı ezer, bunu dosyada da yaz.", "url": "https://wpnews.pro/news/efektif-agents-md-olusturma-prompt", "canonical_source": "https://gist.github.com/zaferayan/c59921f9b890b479f7817d51319eaa6f", "published_at": "2026-08-12 15:49:24+00:00", "updated_at": "2026-08-13 18:51:13.899290+00:00", "lang": "en", "topics": ["developer-tools"], "entities": [], "alternates": {"html": "https://wpnews.pro/news/efektif-agents-md-olusturma-prompt", "markdown": "https://wpnews.pro/news/efektif-agents-md-olusturma-prompt.md", "text": "https://wpnews.pro/news/efektif-agents-md-olusturma-prompt.txt", "jsonld": "https://wpnews.pro/news/efektif-agents-md-olusturma-prompt.jsonld"}}