# turkce-humanizer

Adopt this skill: https://proskills.md/skills/other/bushrabeg-turkce-humanizer

Page: https://proskills.md/skills/other/bushrabeg-turkce-humanizer
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 26991
sha: 1755286357f78547339316a2441f391c0dd94ad6
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/SKILL.md

```text
---
name: turkce-humanizer
description: Türkçe metinlerden AI-üretimi yazım imzalarını temizler ve metnin registeri uygunsa insan Türkçesinin ritim imzalarını yerleştirir. "Türkçeleştir," "AI kokusunu at," "bu Türkçe metni doğallaştır," "humanize et" gibi ifadelerle veya AI-üretimi görünen Türkçe paragraf sunulduğunda tetiklenir.
---

# Türkçe Humanizer

Bu skill iki fazlı çalışır. **Faz 1** metinden AI-üretimi yazım imzalarını çıkarır. Koşulsuzdur, her metne uygulanır. **Faz 2** metnin registeri uygunsa insan Türkçesinin ritim imzalarını yerleştirir. Koşulludur, metnin türüne göre değişir.

İki faz birlikte metni AI-steril olmaktan çıkarır ve canlı hâle getirir. Amaç sadece AI kokusunu atmak değil, insan yazısının nefesini geri vermek. Ama metnin türü izin verdiği ölçüde. Bir KVKK sözleşmesine konuşma dili girmez, bir gazete yazısına girer.

## İŞLEM BAŞLAMADAN ÖNCE — Zorunlu İlk Adımlar

**BU BÖLÜM ATLANAMAZ.** Skill herhangi bir sinyal tarama veya temizleme işlemine başlamadan önce şu iki adımı **sırayla** uygular. Skill'in ana akışına girmeden önce bu iki adım tamamlanmalı.

### Adım 1 — Register Teşhisi

Metni oku, hangi register'da olduğunu belirle (beş kategoriden biri, aşağıda tanımlı). Kullanıcı baştan register belirtmişse ("bu blog yazısı," "bu akademik metin") bu adımı atla. Belirtmemişse teşhisini kullanıcıya bildir:

> "Bu metni [register adı] olarak görüyorum. Onaylıyor musun?"

Kullanıcı düzeltirse kabul et.

### Adım 2 — Profil Sorgusu (Sohbet-İçi)

Register teşhisi netleştikten sonra, **temizleme işlemine başlamadan önce**, profil sorgusunu yap.

**Register profil-uyumsuz (hukuki-idari, akademik-kurumsal):** Bu adımı atla, Adım 3'e geç. Profil sorulmaz.

**Register profil-uyumlu (analitik-gazetecilik, deneme-blog, edebi-yaratıcı):** BU SORUYU MUTLAKA SOR, atlanamaz.

Sohbette bu soru daha önce sorulmadıysa:

> "Bu metin profil uygulamaya uygun bir register'da. Senin yazım ritmini de katmamı istersen kendi yazdığın 2-3 kısa metin paylaş, profilini bu sohbet boyunca kullanayım. İstemiyorsan devam edebilirim."

Kullanıcının cevabını bekle. Cevaba göre:

- **Kullanıcı örnek metin yapıştırırsa:** Verilen örneklerden yazarın nefes uzunluğunu, kavram üretme kalıplarını, tercih ettiği bağlaçları ve ritmi analiz et. Bu analizi kendi hafızanda tut (sohbet bağlamında). Sonra Adım 3'e geç, temizleme sırasında bu profili uygula.

- **Kullanıcı "istemiyorum" veya benzeri derse:** Profilsiz devam et, Adım 3'e geç.

**KRİTİK MİMARİ NOT:** Bu skill Claude Desktop'ın sandbox ortamında da çalışır. Dosya sistemine erişim gerekmez. Profil dosya olarak saklanmaz, sadece o sohbet boyunca hafızada tutulur. Yeni sohbette baştan sorulur — bu tasarım gereğidir, hata değildir.

### Adım 3 — İşleme Başla

Adım 1 ve 2 tamamlandıktan sonra Faz 1 ve Faz 2 uygulanır.

## Beş Mutlak Yasak (Register-Bağımsız)

Bu beş yasak her metinde, her register'da, her koşulda uygulanır. TDK'ya uygun olsa bile uygulanır. Faz 1'den önce, Faz 2'den önce, her şeyden önce.

**1. Uzun çizgi yasak.** Cümle içinde uzun çizgi (—) kullanılmaz. Ara söz için virgül kullanılır ya da cümle bölünür. Konuşma çizgisi olarak diyalog başında bile bu skill'in çıktısında yer almaz. Uzun çizgi Türkçe AI çıktısının en belirgin imzalarından biridir.

**2. Noktalı virgül yasak.** Hiçbir yerde noktalı virgül kullanılmaz. TDK'ya göre doğru bir kullanım olsa bile kullanılmaz. Noktalı virgül gördüğün her yerde cümleyi iki ayrı cümleye böl. Noktalı virgül AI'nin İngilizce "; also / ; however" mantığını Türkçe'ye zorla çevirdiği yerdir.

**3. Yarım cümle yasak.** Fragment cümle üretmez. "Bitti." "Kalakaldı." tarzı tek kelimelik veya yarım hissi veren cümleler yazmaz. Cümle her zaman özne ve yüklem yapısını taşır. Kısa cümle üretebilir, ama tam cümle olarak.

Tam cümle örneği (izinli): "İtibarı da bu tutumdan geldi."
Yarım cümle örneği (yasak): "Bu tutumdan."

**4. Bağlaçla açılan izole cümle yasak.** "Ama şu oldu." "Ancak durum farklıdır." gibi bağlaçla açılıp tek başına duran cümleler üretmez. Bağlaç ya cümlenin içinde kalır ya da iki cümle birleştirilir.

Yasak örneği: "Türkiye savaşa girmedi. Ama savaşın ekonomisini yaşadı."
İzinli hâli: "Türkiye savaşa girmedi ama savaşın ekonomisini yaşadı."

**5. Karşıtlık bağlaçlarından önce virgül yasak.** "Ama," "ancak," "fakat," "lakin," "yalnız" (bağlaç anlamında) gibi karşıtlık bağlaçlarından *önce* virgül konulmaz. Bu İngilizce'nin "but" ve "however" öncesi zorunlu virgül kuralının Türkçe'ye zorla çevirisidir. TDK'ya göre de yanlıştır. AI çıktısının en belirgin sözdizim imzalarından biridir.

Yasak örneği: "Plan hazırdı, ancak uygulamada aksadı."
İzinli hâli: "Plan hazırdı ancak uygulamada aksadı."

Yasak örneği: "Türkiye reform yaptı, ama sonuç sınırlı kaldı."
İzinli hâli: "Türkiye reform yaptı ama sonuç sınırlı kaldı."

Bu beş yasağın hiçbiri register'a bağlı değildir. Her metne uygulanır. Detaylı TDK gerekçeleri için `docs/tdk-referanslari.md` dosyasına bakılır (ama skill bu dosyaya bakmadan da yasakları uygular).

## Pozitif Yön — Güçlü Cümle Hedefi

Skill kısaltıcı değil, güçlendiricidir. Hedef Türk edebiyatının ve akademisinin yerleşik cümle mimarisidir. Örnek referanslar `examples/guclu-cumleler.md` dosyasında tutulur.

Güçlü cümlenin üç niteliği:

- **Bir şey iddia eder.** Cümle bittiğinde okur bir şey biliyor olmalı. AI cümleleri kaçamaklı biter, güçlü cümle durur. "İnsan ruhunun yarası dikiş tutmaz." (Ahmet Ümit) — cümle bittiğinde bir iddia elimizde.
- **Tam bir yapıdadır.** Özne ve yüklem yerindedir. Uzunluk önemli değil, tamlık önemli. Kısa da olabilir uzun da.
- **Ritmi vardır.** Cümlenin içinde bir nefes akışı vardır. Bu ritim virgül sayısıyla ölçülmez, cümlenin okuma sesiyle ölçülür.

Referans yazarlar: Ahmet Hamdi Tanpınar, Ayfer Tunç, Barış Bıçakçı, Ahmet Ümit, İlber Ortaylı, Kemal Karpat, Çağlar Keyder. Akademik ritim için ek referans: Marcus, Aksoy. Skill bir cümle üretirken bu yazarların cümle mimarisine bakar. Zorlama taklit değil, kalıp öğrenimi.

## Yapı Koruma

Metnin yapısını değiştirme. Bu beş yasaktan sonra, her şeyden önce uygulanır.

- Madde listeleri liste olarak kalır. Paragrafa çevirme.
- Başlık hiyerarşisi korunur.
- Tablolar tablo olarak kalır.
- Blok alıntılar blok olarak kalır.
- Kod blokları kod olarak kalır.
- Belge şablonuna ait yapısal alanlar yerinde bırakılır.

Skill'in işi cümle içi ve paragraf içi dil düzeltmesi. Belge iskeletine dokunma. Kullanıcı açıkça "yapıyı da değiştir" veya "paragrafa çevir" demedikçe.

## Register Teşhisi

Metni işlemeden önce hangi ailede olduğunu belirle. Beş register kategorisi:

| Register | Örnek metin türleri | Faz 2 uygulaması | Profil sorgusu |
|----------|--------------------|--------------------|-----------------|
| **Hukuki-idari** | Sözleşme, KVKK, tebliğ, kanun taslağı | Yok | Yok |
| **Akademik-kurumsal** | Tez, akademik makale, resmi rapor | Kısıtlı: sadece cümle varyansı ve öz-düzeltme | Yok |
| **Analitik-gazetecilik** | Haber, analiz, brifing, düşünce kuruluşu raporu | Tam, konuşma bağlaçları hariç | Var |
| **Deneme-blog** | Deneme, köşe yazısı, blog, sosyal medya uzun formatı | Tam | Var |
| **Edebi-yaratıcı** | Roman, öykü, denemeye yakın anlatı | Tam artı duyusal detay ve zaman kipi | Var |

Metni okuduğunda ilk seçim skill'e ait değil, kullanıcıya doğrulatılır (İşlem Başlamadan Önce, Adım 1'e bakılır). Sınır durumlarda (analitik-gazetecilik ile deneme-blog arasında sıkışan metinler gibi) detaylı ayrım için `docs/register-detayli.md` dosyasına bakılabilir.

## Yazar Profili Sistemi

Register profil-uyumluysa (analitik-gazetecilik, deneme-blog, edebi-yaratıcı), skill yazarın kendi imzasını da hesaba katar. Profil sorgusu işlem başında yapılır (İşlem Başlamadan Önce, Adım 2'ye bakılır).

### Sohbet-içi profil (v3.2 mimarisi)

Profil bir dosyada saklanmaz. Kullanıcı sohbetin başında (skill sorunca) kendi yazdığı 2-3 kısa metni yapıştırır. Skill bu örneklerden şunları analiz eder:

- **Nefes uzunluğu:** yazarın tipik cümle uzunluğu, kısa-uzun varyansı.
- **Bağlaç tercihleri:** "ama" mı "ancak" mı, "yani" mı "diğer bir ifadeyle" mi.
- **Kavram üretme kalıpları:** yazar kendi kavramları üretiyor mu (mesela "masada kazanılan egemenlik" gibi), yoksa yerleşik terimler mi kullanıyor.
- **Ritim imzaları:** cümle sonu kararlılığı, öznenin cümle içi konumu, devrik cümle sıklığı.
- **Karakteristik kelime seçimleri:** yazarın sık kullandığı bağlaçlar, geçişler, yer tutucular.

Bu analiz o sohbetin hafızasında kalır. Skill sonraki metinleri temizlerken bu profili göz önünde tutar.

### Sohbet-içi profilin kapsamı

Profil oluşturulduktan sonra o sohbetteki **tüm profil-uyumlu metinlerde** kullanılır. Kullanıcı yeni metin attığında tekrar profil sorulmaz — mevcut profil kullanılır.

Yeni sohbette (yeni bir Claude penceresi/konuşması) profil sıfırlanır. Baştan sorulur. Bu tasarım gereğidir çünkü Claude Desktop sohbetler arası kalıcı hafıza tutmaz.

### Yazar imzası koruma

Profil aktifse, skill AI-sinyali ile yazar-imzası ayrımını profil örneklerine bakarak yapar. Örnek: yazar profil örneklerinde sık kavram üretimi gösteriyorsa, skill bu tür ifadeleri AI-sinyali sanıp temizlemez. Yazar "ancak" tercih ediyorsa skill "yalnızca" yerine "ancak" kullanır.

### Profil yoksa ne olur

Kullanıcı "istemiyorum" derse skill profilsiz devam eder. Bu durumda skill genel Türkçe akademik-analitik ritim referanslarını (Tanpınar, Ortaylı, Karpat gibi) kullanır. Sonuç yine iyi olur, sadece kullanıcının kendi imzası korunmaz — genel iyi Türkçe hedefine göre çalışır.

## Kullanıcıya Danışma Protokolü

Skill kendi kararının sınırında olduğu her yerde kullanıcıya açık soru sorar. Üç durumda:

- Bir sinyalin AI-imzası mı yoksa yazar tercihi mi olduğu belirsiz.
- Bir bağlaç veya kalıp register'da sınırda. Örnek: "Ne var ki" analitik-gazetecilik register'ının sınırında bir bağlaçtır. Skill "bu register'da 'Ne var ki' mi 'Ama' mı tercih edersin?" diye sorar.
- Metonim ile eş anlamlı rotasyonu ayrımı belirsiz. Örnek: "Türkiye / Ankara / cumhuriyet" aynı özne için farklı adlar değildir, metonimdir (Türkiye = ülke, Ankara = hükümet merkezi, cumhuriyet = rejim). Skill emin değilse sorar.

Sorular kısa ve tek seçim olur. Kullanıcı "hepsini sen bilirsin" derse skill kendi varsayılan kararını uygular.

## Faz 1 — AI Dokunuşlarını Çıkarma (Koşulsuz)

Faz 1 üç katmandan oluşur: **mutlak yasaklar** (yukarıda tanımlı), **baskın sinyaller** ve **ikincil sinyaller**. Baskın sinyaller Türkçe AI metninin en belirgin fenotipleridir. Üçü veya daha fazlası bir metinde varsa metin ağır AI-imzalıdır. İkincil sinyaller destekleyici işaretlerdir.

### Baskın Sinyaller

#### Sinyal 1 — Noktalama Enflasyonu

Türkçe noktalama TDK'ya göre kısıtlıdır. AI, İngilizce noktalama mantığını Türkçe'ye zorla çevirir.

**1a. Uzun tire.** Mutlak yasak (yukarıda tanımlı). Cümle içi uzun tire virgüle çevrilir veya cümle bölünür.

**1b. Noktalı virgül.** Mutlak yasak. TDK-uygun olsa bile kaldırılır. Cümle ikiye bölünür (bağlaçla açılan izole cümle üretmeden).

**1c. İki nokta üst üste açıklama modu.** Cümle içi mini açıklama için iki nokta kullanma. AI "X: Y" yapıları üretir. Türkçe'de iki nokta örnek/açıklama gerektiren cümle sonuna veya konuşma öncesine gelir.

- Alarm eşiği: bir paragrafta iki veya daha fazla cümle-içi iki nokta.
- Onarım: iki nokta üst üsteyi kaldır, iki cümle yap veya virgülle bağla.

**1d. Bağlaç "ki" bitişik yazma.** "bu ki," "şu ki," "durum şu ki" yapıları ayrı yazılır. Sadece kalıplaşmış "belki, çünkü, mademki, meğerki, oysaki, sanki, hâlbuki" bitişiktir.

- Onarım: bitişik "ki"leri ayır.

**1e. Slash-ayırıcı.** "kullanıcı/müşteri/istemci" yapısı Türkçe değildir. Virgül ve "veya" ile değiştirilir.

- Alarm eşiği: metinde iki veya daha fazla slash-ayırıcı.
- Onarım: "A, B veya C" yapısına çevir.

**1f. Karşıtlık bağlacı öncesi virgül.** Mutlak yasak 5 (yukarıda tanımlı). "Ama," "ancak," "fakat," "lakin," "yalnız" bağlaçlarından önce virgül gördüğün her yerde kaldır. İngilizce "but/however" öncesi zorunlu virgül kuralının Türkçe'ye zorla çevirisidir.

- Alarm eşiği: metinde bir örnek yeter.
- Onarım: bağlaç öncesindeki virgülü sil, cümle bütün olarak akmaya bıraksın.

#### Sinyal 2 — Cümle Monotonluğu

İnsan yazısı burstiness taşır. Kısa, orta ve uzun cümleler karışıktır, ritim nefes alır. AI Türkçesi ise orta uzunlukta cümlelerde takılır — hepsi 18-25 kelime arası, arada kısa tam cümle yok, arada uzun analitik yok.

- Alarm eşiği: paragrafta cümle uzunluğu standart sapması düşük (%30 altı) ve ortalama 22+ kelime.
- Diğer sinyal: hiç 8 kelimeden kısa tam cümle yok.

**Onarım:** En uzun cümleyi böl, ortasına kısa bir tam cümle yerleştir. Yarım cümle üretme (mutlak yasak 3). Kısa cümle özne ve yüklem taşır.

#### Sinyal 3 — Kalıp Tekrarı

AI belirli yapıları tekrar tekrar kullanır. Üç alt kalıp:

**3a. "-mektedir/-maktadır" salgını.** Bir paragrafta dört veya daha fazla "-mektedir/-maktadır" yüklem varsa alarm. Doğal Türkçe akademik yazı bu eki %20-25 oranında kullanır, diğer zaman kipleriyle karışık.

- Onarım: yüklem çeşitliliği ekle — geçmiş zaman ("oldu, çıktı"), geniş zaman ("olur, çıkar"), aktif ses.

**3b. Bürokratik bağlaç yığını.** "Bu bağlamda," "söz konusu," "öte yandan," "bunun yanı sıra," "bu doğrultuda," "bu çerçevede" — bir metinde toplam üç veya daha fazla kullanım alarm.

- Onarım: bürokratik bağlaçları gerçek mantıksal bağlarla değiştir ("Çünkü," "Nitekim," "Oysa"). Ama bağlaçlar cümle içinde kalır, izole cümle açmaz (mutlak yasak 4).

**3c. AI kapanış klişeleri.** "Kritik bir rol oynamaktadır," "hayati bir önem taşımaktadır," "önemli bir rol üstlenmektedir," "vazgeçilmez bir hale gelmiştir" — bir metinde iki veya daha fazla kullanım alarm. Özellikle paragraf sonlarında.

- Onarım: boş kapanışları sil, paragraf bir önceki cümlede bitsin.

#### Sinyal 4 — "Sadece X Değil, Aynı Zamanda Y" Ailesi

İngilizce'nin "It's not just X, it's Y" retorik hamlesi Türkçe'ye zorla çevrilmiş. AI'nin en belirgin retorik imzalarından biri.

Varyantlar:
- "Sadece X değil, aynı zamanda Y"
- "Yalnızca X söz konusu değildir; Y de..."
- "X olmakla birlikte, Y niteliğini de taşımaktadır"
- "X'in ötesinde, Y boyutu göz ardı edilmemelidir"
- "Salt X değil; bir Y meselesi"
- "değil, yalnızca Y"
- "değil, sadece Y"
- "değil, sırf Y"
- "X değil Y" (kısa form, aynı retorik)

Alarm eşiği: bir metinde bir örnek.

**Onarım:** Gerçek mantıksal bağı bul. Üç seçenek:
- "Hem X hem Y" yapısına çevir (bu daha doğal Türkçe)
- İki bağımsız cümle yap (ikinci cümle bağlaçla açılmasın, mutlak yasak 4)
- Bağı tamamen kaldır, sadece Y'yi bırak (X gereksizse)

#### Sinyal 5 — Boş Övgü ve Boş Kapanış

**5a. Boş değerlendirici sıfat kümesi:** "eşsiz," "benzersiz," "paha biçilmez," "zengin bir mozaik," "çok boyutlu," "hayati," "kritik," "adeta bir zaman kapsülü," "vazgeçilmez bir ritüel."

- Alarm eşiği: bir paragrafta iki veya daha fazla örnek.
- Onarım: sıfatı sil, isim başlı kalsın. Veya somut örnekle değiştir.

**5b. Boş değerlendirici kapanış:** Paragraf sonu bilgi taşımayan bir değerlendirmeyle biter.

- Alarm eşiği: her paragrafın bu tür klişeyle bitmesi.
- Onarım: boş kapanışları çıkar, paragraf bir önceki cümlede bitsin.

### İkincil Sinyaller

Bu sinyaller tek başına AI-imzası kanıtı değildir ama baskın sinyallerle birlikte görüldüğünde şüpheyi güçlendirir.

**Sinyal 6 — "Adeta" ve "sanki" bağımlılığı.** Somut örnek eksikliğini vague benzetmeyle örtme.
- Onarım: benzetmeyi somut örnekle değiştir. Somut örnek yoksa cümleyi sil.

**Sinyal 7 — Zorlama üçlü liste.** Üç öğe arasında gerçek fark yoksa dolgu.
- Onarım: bir öğeye indir veya üçünden en spesifik olanı seç.

**Sinyal 8 — Devrik cümle yokluğu.** Doğal Türkçe kimi zaman devrik kurar, LLM Türkçesi hiç kurmaz.
- Onarım: uygun bir cümlede yüklemi öne çek. Zorlama yapma.

**Sinyal 9 — Register kayması.** Aynı paragrafta teknik/bürokratik başlayıp aniden estetik-emotif kelimelere kayma.
- Onarım: baştaki register'ı belirle, o katmanda kal.

**Sinyal 10 — Somut anchor eksikliği.** İnsan yazarlar soyut iddiayı hemen somut örnek, tarih, isim ile takip eder.
- Onarım: soyut iddiaya somut örnek ekle (kullanıcıdan iste veya cümleyi sil). Uydurma anchor ekleme.

**Sinyal 11 — Pasif yapı bağımlılığı.** Cümlelerin çoğu pasif çatıda.
- Onarım: mümkün olan yerde aktif çatıya çevir.

**Sinyal 12 — İngilizce vurgu-doldurucuları ve Türkçe AI-vurgusu.** Türkçe cümle yapısı vurguyu dizilim ve tonlama ile yapar, kelime eklemekle değil.

Aile:
- "tam da" (İng. precisely)
- "tam anlamıyla" (İng. literally, truly)
- "gerçekten de" (İng. indeed)
- "aslında da" (İng. in fact)
- "kesinlikle" (dolgu olarak, İng. definitely)
- "esasen" (İng. essentially)
- "nihayetinde" (İng. ultimately)
- "bir bakıma" (İng. in a way)
- "gerçek anlamda" (İng. in a real sense)
- "işte" (cümle başında dolgu olarak)
- "işte tam da"
- "işte bu" (cümle başında dolgu olarak)
- "böylece" (mantık bağı taşımıyorsa)
- "sonuç olarak" (özet değil dolgu ise)

- Alarm eşiği: metinde iki veya daha fazla örnek.
- Onarım: sil. Cümlenin anlamı zaten korunuyor.

**Sinyal 13 — Eş anlamlı rotasyonu.** AI aynı özneye tek paragrafta üç ayrı ad verir.
- Alarm eşiği: bir paragrafta aynı özneye üç veya daha fazla ayrı ad.
- Onarım: bir ad seç, o adı kullan.
- Not: Metonim (Türkiye / Ankara / cumhuriyet gibi) eş anlamlı değildir. Ayrım belirsizse kullanıcıya sor.

**Sinyal 14 — Fragment cümle bağımlılığı.** Mutlak yasak 3 ile örtüşür. AI cümleyi iki noktayla açıp fragment liste veya fragment tanım bırakır.
- Onarım: fragment'ı tam cümleye tamamla.

#### Sinyal 23 — Şudur/Budur Açıklama Kalıbı

AI Türkçe çıktısı "X şudur: Y" veya "Kesin olan tek şey şudur: Y" gibi açıklama kalıpları üretir. Bu İngilizce "The thing is: X" veya "What is certain is: X" kalıplarının zorla çevirisi. Türkçe akademik ve edebi gelenek bu kalıbı yaygın kullanmaz; bunun yerine tümce-içi yeniden yapılandırma yapar.

Varyantlar:
- "X şudur: Y"
- "Kesin olan tek şey şudur: Y"
- "Anlaşılan şey şudur: Y"
- "Ortaya çıkan tablo şudur: Y"
- "Söylenmesi gereken şudur: Y"
- "Bir soru ısrarla beklemekte: [soru]" (soru varyantı)
- "Şu soru gündemde: [soru]" (soru varyantı)

- Alarm eşiği: bir metinde bir örnek yeter.
- Onarım: iki nokta üst üsteyi kaldır, cümleyi "Y olan X" yapısına çevir. Türkçe'de bu yapı klasik akademik ritmin bir hamlesidir (Ortaylı, Karpat sık yapar).

Örnek onarım:
- Yasak: "Kesin olan tek şey şudur: Üçgen, eski geometrisine bir daha dönmeyecek."
- İzinli: "Üçgenin eski geometrisine dönmeyeceği kesin olan tek şey."

Soru varyantı onarımı:
- Yasak: "Yine de bir soru ısrarla beklemekte: Tahran ile Washington'ı, birbirlerini doğrudan vurmaktan kırk beş yıl boyunca alıkoyan neydi?"
- İzinli: "Tahran ile Washington'ın, birbirlerini doğrudan vurmaktan kırk beş yıl boyunca alıkoyanın ne olduğu sorusu ısrarla beklemekte."

## Faz 2 — İnsan Ritmi Enjeksiyonu (Koşullu)

Bu faz register uygunsa çalışır. Her sinyalin yanında hangi register'da aktif olduğu belirtilmiştir.

**Faz 2'nin mantığı Faz 1'in tersidir.** Faz 1'in kuralı: "eğer varsa çıkar." Faz 2'nin kuralı: "eğer yoksa yerleştir." Steril metne insan nefesi enjekte etmek için. Ama yerleştirme mutlak yasakları ihlal edemez — özellikle yarım cümle ve izole bağlaç yasağı Faz 2 sinyallerinde de geçerlidir.

### Sinyal 15 — Cümle Uzunluğu Varyansı

**Register:** Akademik-kurumsal ve üstü.

Uzun paragrafta ritim monotonsa, orta uzunlukta bir cümle daha kısa bir cümleye dönüştürülür. Kısa cümle **tam cümle** olur. Yarım cümle üretme (mutlak yasak 3).

### Sinyal 16 — Konuşma Bağlaçları

**Register:** Analitik-gazetecilik ve üstü.

"Ama," "Zaten," "Oysa," "Ne var ki," "Meğer," "Nitekim," "Hem de" — bunlar gerçek Türkçenin nefes bağları. Bürokratik "bu bağlamda / söz konusu / dolayısıyla" yerine bunlar konur. Bağlaçlar cümle içinde kalır (mutlak yasak 4).

**Profil aktifse:** Yazarın tercih ettiği bağlaç varsa (mesela yazar "ancak" kullanıyorsa) skill "yalnızca" yerine "ancak" tercih eder. Bu sohbet-içi profilin en önemli işlerinden biridir.

### Sinyal 17 — Retorik Soru

**Register:** Deneme-blog ve üstü.

Anlatıcının okura veya kendine soru sorması. İddia etmenin alternatifi.

### Sinyal 18 — Öz-düzeltme ve Yeniden İfade

**Register:** Akademik-kurumsal ve üstü.

Yazar kendi cümlesini düzeltir, geri alır, yeniden söyler.

**Öz-düzeltme sözcüklerinin yerleşimi:**

"Daha doğrusu," "aslında," "işin doğrusu," "belki de," "hayır" gibi öz-düzeltme sözcükleri iki farklı biçimde yerleştirilebilir:

1. **Ara söz olarak virgüllerle sarma:** Konuşma diline yakındır.
2. **Yeni cümle başı olarak yerleştirme:** Akademik-analitik registerde tercih edilir.

**Akademik-kurumsal ve analitik-gazetecilik registerlerinde ikinci hamle tercih edilir** — öz-düzeltme sözcüğü yeni cümle başı olur.

### Sinyal 19 — Duyusal Somut Detay

**Register:** Edebi-yaratıcı.

İnsan yazısı koku, dokunma, ses taşır. AI yazısı sadece görsel-soyut kalır. Duyusal detay skill tarafından üretilmez, kullanıcıya sorulur.

### Sinyal 20 — Zaman Kipi Kayması

**Register:** Edebi-yaratıcı.

İnsan yazısı şimdiki, geçmiş, geniş zamanı akışkan geçer.

### Sinyal 21 — Diyalog İzi

**Register:** Edebi-yaratıcı.

Anlatı içinde karakterin sesi geçer.

### Sinyal 22 — Birinci Çoğul Kullanımı

**Register:** Akademik-kurumsal ve üstü (analitik metinlerde), edebi'de hariç.

"Sanıyoruz," "görüyoruz," "araştırdığımızda." Okuru düşünme sürecine dahil eder.

## Uzun Belge Davranışı

Çok paragraflı belge (üç veya daha fazla paragraf) geldiğinde şu maker/checker deseni uygulanır:

1. **Tara.** Belgeyi paragraf paragraf oku, her paragraf için baskın sinyal yoğunluğunu ölç.
2. **Sınıflandır.** Paragrafları yüksek, orta, temiz olarak ayır.
3. **Rapor sun.** Kullanıcıya genel tablo ver, register teşhisi ve profil durumu belirt.
4. **Seçenek sun.** Tümü / bloklar halinde / sadece yüksek AI-imzalılar.
5. **Uygula ve işaretle.** Her paragrafın hangi sinyallerine dokunduğunu kısa notlarla belirt.

## Çıktı Formatı (Atlanamaz)

Skill'in her çıktısı beş bölümden oluşur. Hiçbiri atlanamaz.

**1. Tespit Raporu.** Metinde hangi baskın ve ikincil sinyaller görüldü, konumlarıyla.

**2. Sinyal Yoğunluğu.** 100 kelimeye normalize:
> "Önce: 8.4 sinyal/100 kelime. Sonra: 1.2. İyileşme: %86."

**3. Onarılmış Versiyon.** Tam metin.

**4. Değişiklik Özeti.** Kullanıcı onayı bekler.

**5. Notlar.**
- Kasıtlı tercih olabilir, dokunmadım: [varsa]
- Register kısıtı nedeniyle muhafazakâr davrandım: [varsa]
- Faz 2 uygulandı: [liste]
- **Profil durumu:** [aktif / soruldu-reddedildi / uyumsuz-register]
- **YOK olduğu için not düştüğüm şeyler:** metinde bulunması beklenip bulunmayan sinyaller.

Bu son satır bir editör hoşnutluğu ifadesidir. Yazar temiz bir metin yazmışsa bu tanınmalı.

## Sınırlar ve Etik

- Bu skill **kelime değiştirici değil, yapı değiştiricidir**.
- AI detektör atlatmak birincil amaç değil. **Doğal Türkçe** birincil amaç.
- **Yazar-özgü stilistik tercihlere saygı göster.** Profil aktifse profile bak, profil yoksa kullanıcıya sor.
- **Ağır biçimsel metinlerde tam temizleme yerine yoğunluk düşürme uygula.**
- **Metnin bilgi içeriği korunmalı.**
- **Yapı bütünlüğüne dokunma.**
- **Mutlak yasakların hiçbirinden taviz verilmez.** Uzun çizgi, noktalı virgül, yarım cümle, bağlaçla açılan izole cümle, karşıtlık bağlacı öncesi virgül skill çıktısında yer almaz.

## Referans

Türkçe noktalama kararlarında TDK Yazım Kuralları esas alınır. Ama TDK'nın izin verdiği bazı yapılar bu skill'de yasaktır (uzun çizgi, noktalı virgül). Ayrıca skill TDK'nın yanlış saydığı yapıları da yasaklar (karşıtlık bağlaçları öncesi virgül).

İnsan ritmi sinyalleri Türk edebiyatının ve akademisinin yerleşik yazarlarından çıkarıldı. Edebi referans: Tanpınar, Ayfer Tunç, Barış Bıçakçı, Ahmet Ümit. Akademik referans: Ortaylı, Karpat, Keyder, Marcus, Aksoy.

Örnek cümleler: `examples/guclu-cumleler.md`.
Detaylı gerekçeler: `docs/tdk-referanslari.md`, `docs/register-detayli.md`, `docs/mimari-kararlar.md`.

Nicel metrik ASD-STE100 standardından esinlendi. Genel humanizer mimarisi harshaneel/humanize ve makotofalcon/humanizer-ja projelerinden ilham aldı.

---

**Sürüm:** v3.2 (Ağustos 2026)

## v3.2 Değişiklik Notları

v3.1'den v3.2'ye geçişte yapılan tek büyük mimari değişiklik:

**Profil sistemi dosya-tabanlıdan sohbet-içi hale getirildi.**

v3.1'de profil `~/.claude/skills/turkce-humanizer/profiles/ben.md` dosyasında tutuluyordu. Bu Claude Code CLI'da çalışıyor ama Claude Desktop'ın sandbox ortamında çalışmıyordu — skill dosya sistemine erişemediği için profil sorgusunu atlıyordu.

v3.2'de profil dosya olarak saklanmaz. Kullanıcı sohbetin başında (skill sorunca) 2-3 kısa örnek metin yapıştırır. Skill bu örnekleri sohbet boyunca hafızasında tutar, tüm profil-uyumlu metinlerde kullanır. Yeni sohbette baştan sorulur.

Bu değişiklik skill'i Desktop, CLI ve Claude.ai platformlarının hepsinde çalışır hale getirir.

Ek olarak Sinyal 23'e soru cümlesi varyantı eklendi ("Bir soru ısrarla beklemekte: [soru]" kalıbı).
```

## File: README.md
size: 5691
sha: d1329e18c11b496326308b99285e8a432113c1f0
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/README.md

````text
# turkce-humanizer

> Türkçe metinlerden yapay zekâ yazım imzalarını temizleyen Claude skill'i. A Claude skill that removes AI writing signatures from Turkish text.

**Güncel sürüm:** v3.2 · **Lisans:** MIT · **Uyumluluk:** Claude Desktop, Claude Code CLI, Claude.ai

---

## Ne Yapar

Türkçe LLM çıktılarının kendine özgü bir kokusu var: `-mektedir` salgını, "sadece X değil, aynı zamanda Y" retoriği, "bu bağlamda / söz konusu / kritik bir rol oynamaktadır" bürokratik bağlaç zinciri, boş değerlendirici sıfat kümeleri, zorlama noktalı virgül köprüleri, "işte" ve "tam da" gibi İngilizce vurgu-doldurucuları, cümle sonlarına iliştirilen boş övgü kapanışları.

Bu skill Claude'a bu imzaları tanımayı ve temizlemeyi öğretir. Türkçenin kendi ritim geleneğini referans alır — Tanpınar, Ayfer Tunç, Barış Bıçakçı, Ahmet Ümit, İlber Ortaylı, Kemal Karpat, Çağlar Keyder gibi yerleşik yazarların cümle mimarisini.

Amaç sadece AI kokusunu atmak değil, insan yazısının nefesini geri vermek.

## Nasıl Çalışır

İki fazlı mimari:

- **Faz 1 (koşulsuz):** Metinden AI-üretimi yazım imzalarını çıkarır. Her metne uygulanır.
- **Faz 2 (koşullu):** Metnin registeri uygunsa insan Türkçesinin ritim imzalarını yerleştirir. Türe göre değişir.

Beş register kategorisi tanır: hukuki-idari, akademik-kurumsal, analitik-gazetecilik, deneme-blog, edebi-yaratıcı. Her registerde farklı davranır. KVKK sözleşmesine konuşma dili sokmaz, blog yazısına akademik ritim dayatmaz.

## Beş Mutlak Yasak

Bu beş yasak her metinde, her register'da, her koşulda uygulanır. TDK-uygun olsa bile skill çıktısında yer almaz:

1. Uzun çizgi (—)
2. Noktalı virgül
3. Yarım cümle
4. Bağlaçla açılan izole cümle
5. Karşıtlık bağlaçlarından önce virgül ("ama" öncesi virgül gibi)

## Yazar Profili Sistemi

Skill senin yazım imzanı öğrenebilir. Sohbet başında (register profil-uyumluysa) skill sana sorar: "Senin ritmini katmamı istersen kendi yazdığın 2-3 kısa metin paylaş."

Örnek verdiğinde skill senin nefes uzunluğunu, bağlaç tercihini, kavramlaştırma kalıplarını ve ritim imzalarını çıkarır. O sohbet boyunca kullanır. Yeni sohbette baştan sorulur.

Kişisel dosya sistemine erişim gerekmez. Her platformda çalışır.

## Kurulum

### Claude Desktop (en yaygın)

1. Bu repo'yu ZIP olarak indir (yeşil **Code → Download ZIP** butonu).
2. Claude Desktop → **Settings → Capabilities → Skills**.
3. **Add Skill** ile ZIP klasörünü yükle.
4. Skill aktif hale gelir.

### Claude Code CLI

```bash
cd ~/.claude/skills/
git clone https://github.com/bushrabeg/turkce-humanizer.git
```

### Kullanım

Claude'a bir Türkçe metin at ve şunu de:

> "Bu metni humanize et."

Ya da:

> "AI kokusunu at."

Skill devreye girer. Önce register'ı doğrular, register profil-uyumluysa profil sorar, sonra iki fazlı işleme başlar. Sonda beş bölümlü rapor sunar: tespit raporu, sinyal yoğunluğu, onarılmış metin, değişiklik özeti, notlar.

## Repo Yapısı

```
turkce-humanizer/
├── SKILL.md              # Ana skill dosyası
├── README.md             # Bu dosya
├── ROADMAP.md            # v3.0+ yol haritası
├── LICENSE               # MIT
├── docs/
│   ├── tdk-referanslari.md      # TDK'nın noktalama kurallarıyla ilişki
│   ├── register-detayli.md      # Beş register kategorisi detayı
│   └── mimari-kararlar.md       # Tasarım kararlarının gerekçesi
└── examples/
    └── guclu-cumleler.md        # Türkçe güçlü cümle referans korpusu
```

## Sürüm Geçmişi

- **v3.2** (Ağustos 2026): Sohbet-içi profil sistemi (Desktop uyumluluğu), Sinyal 23 soru varyantı.
- **v3.1** (Ağustos 2026): "İşlem başlamadan önce" bölümü, Sinyal 23 (şudur/budur), Sinyal 4/12/18 zenginleşmesi.
- **v3.0** (Ağustos 2026): Beş mutlak yasak, yazar profili sistemi, kullanıcıya danışma protokolü, değişiklik özeti, kabul oranı log'u.
- **v2.1** (Ağustos 2026): 22 sinyal, yapı koruma prensibi, nicel metrik.
- **v2.0** (Ağustos 2026): İki fazlı mimari, 5 register kategorisi, 19 sinyal.
- **v0.1** (Ağustos 2026): İlk sürüm, 10 sinyal.

Detaylı release notları için [Releases](https://github.com/bushrabeg/turkce-humanizer/releases) sayfasına bakılır.

## Katkı

Katkıya açık. Özellikle şu alanlarda:

- `examples/guclu-cumleler.md` — Türkçe güçlü cümle örnekleri (kitap alıntıları, gazete köşeleri, akademik pasajlar).
- Yeni AI-imzası tespiti — Türkçe LLM çıktısında fark ettiğin yeni bir kalıbı issue olarak açabilirsin.
- Register sınır durumları — belirsiz register durumları için `docs/register-detayli.md`'ye örnek eklenebilir.

Pull request açmadan önce SKILL.md'nin mimari kararlarına ([docs/mimari-kararlar.md](docs/mimari-kararlar.md)) göz atman öneririm.

## Referans

- **TDK Yazım Kuralları** — noktalama kararlarında temel referans.
- **ASD-STE100 (1986)** — nicel metrik ilhamı.
- **harshaneel/humanize, makotofalcon/humanizer-ja** — genel humanizer mimarisi ilhamı.
- **Türk edebiyat ve akademi geleneği** — ritim imzaları için stilometrik referans.

## Yazar

**Büşra Begçecanlı** ([@bushrabeg](https://github.com/bushrabeg)) — Anadolu Ajansı gazeteci ve araştırmacı, AA Kitap yayın birimi, Teknopolitika.com kurucu ortağı, intelligence studies alanında yüksek lisans. Skill'in taksonomisi, kalibrasyonu ve editör kararları kendi editörlük deneyimine dayanıyor.

## Lisans

MIT — özgürce kullan, değiştir, dağıt.
````

## File: .gitignore
size: 4628
sha: 83972fadc2724842e111d0d3e2829a59ae3d3f45
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/.gitignore

```text
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[codz]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#   Usually these files are written by a python script from a template
#   before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py.cover
.hypothesis/
.pytest_cache/
cover/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
.pybuilder/
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
#   For a library or package, you might want to ignore these files since the code is
#   intended to run in multiple environments; otherwise, check them in:
# .python-version

# pipenv
#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
#   However, in case of collaboration, if having platform-specific dependencies or dependencies
#   having no cross-platform support, pipenv may install dependencies that don't work, or not
#   install all needed dependencies.
# Pipfile.lock

# UV
#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
#   This is especially recommended for binary packages to ensure reproducibility, and is more
#   commonly ignored for libraries.
# uv.lock

# poetry
#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
#   This is especially recommended for binary packages to ensure reproducibility, and is more
#   commonly ignored for libraries.
#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
# poetry.lock
# poetry.toml

# pdm
#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
# pdm.lock
# pdm.toml
.pdm-python
.pdm-build/

# pixi
#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
# pixi.lock
#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
#   in the .venv directory. It is recommended not to include this directory in version control.
.pixi

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# Redis
*.rdb
*.aof
*.pid

# RabbitMQ
mnesia/
rabbitmq/
rabbitmq-data/

# ActiveMQ
activemq-data/

# SageMath parsed files
*.sage.py

# Environments
.env
.envrc
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# pytype static type analyzer
.pytype/

# Cython debug symbols
cython_debug/

# PyCharm
#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
#   and can be added to the global gitignore or merged into this file.  For a more nuclear
#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
# .idea/

# Abstra
#   Abstra is an AI-powered process automation framework.
#   Ignore directories containing user credentials, local state, and settings.
#   Learn more at https://abstra.io/docs
.abstra/

# Visual Studio Code
#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
#   you could uncomment the following to ignore the entire vscode folder
# .vscode/
# Temporary file for partial code execution
tempCodeRunnerFile.py

# Ruff stuff:
.ruff_cache/

# PyPI configuration file
.pypirc

# Marimo
marimo/_static/
marimo/_lsp/
__marimo__/

# Streamlit
.streamlit/secrets.toml
```

## File: docs/mimari-kararlar.md
size: 12665
sha: 9b5f76261e98549af5725cc478be1f667ff36b04
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/docs/mimari-kararlar.md

```text
# Mimari Kararlar

Bu dosya turkce-humanizer skill'inin temel tasarım kararlarının gerekçelerini açıklar. SKILL.md skill'in ne yaptığını söyler; bu dosya neden öyle yapıldığını söyler.

## Karar 1 — İki Fazlı Mimari

### Ne

Skill iki ayrı fazda çalışır. Faz 1 metinden AI-üretimi imzaları çıkarır (koşulsuz, her metne uygulanır). Faz 2 metnin registeri uygunsa insan Türkçesinin ritim imzalarını yerleştirir (koşullu).

### Alternatif ne olabilirdi

Tek fazlı bir mimari düşünülebilirdi: her sinyalin hem "çıkar" hem "yerleştir" davranışı olabilir, ikisi bir arada çalıştırılabilirdi. Ya da tek yönlü bir mimari: sadece çıkarma, hiç enjeksiyon yok.

### Neden iki fazlı seçildi

Ayrılığın üç faydası var:

**Birincisi**, "çıkarma" evrenseldir, "enjekte etme" bağlama bağlıdır. Bir KVKK metnine konuşma bağlacı enjekte edilmez ama noktalı virgül yine de çıkarılır. Bu iki iş farklı mantık taşıyor — birleştirmek register kontrolünü karmaşıklaştırıyor.

**İkincisi**, iki fazlı mimari LLM tarafında maker/checker deseni kurmayı kolaylaştırıyor. Faz 1'in çıktısı Faz 2'nin girdisidir. Skill kendi çıktısına ikinci bir gözle bakabiliyor.

**Üçüncüsü**, kullanıcı isterse sadece Faz 1'i çalıştırabilir ("AI kokusunu at, ama fazla enjekte etme"). Bu esneklik tek fazlı mimaride imkansızdı.

### Değişebilir mi

Bu karar v3.0'da değişmez. Skill'in temel iskeleti bu.

## Karar 2 — Beş Register Kategorisi

### Ne

Skill metinleri beş register kategorisine ayırır: hukuki-idari, akademik-kurumsal, analitik-gazetecilik, deneme-blog, edebi-yaratıcı.

### Alternatif ne olabilirdi

Daha az kategori (üç: resmi, yarı-resmi, gayri-resmi) düşünülebilirdi. Ya da daha fazla (yedi-sekiz: her tür için ayrı). Ya da spektrum yaklaşımı: register bir eksende sürekli değer, ayrık kategori değil.

### Neden beş seçildi

**Az kategori** (üç) hukuki metinle akademik metni aynı kutuya koyar. Ama bu ikisinin Faz 2 uygulaması farklıdır — akademikte birinci çoğul geçer, hukuki metinde geçmez. Ayrılık gerekli.

**Çok kategori** (yedi-sekiz) skill'i pratikte kullanılmaz hale getirir. Kullanıcı "bu neyin registerinde" diye kararsız kalır, skill teşhiste yanılır.

**Spektrum yaklaşımı** teorik olarak daha zarif ama uygulamada Faz 2 sinyallerinin devreye girme mantığını flulaştırır. Her sinyalin "hangi eşikte devreye girer" kararı sürekli hesaplama gerektirir. Ayrık kategori net karar üretir.

Beş kategori Türkçe yazı geleneğinin doğal ayrımlarına da denk düşüyor: kanun / tez / analiz / deneme / roman. Türk okur bu ayrımı zaten sezgisel yapıyor.

### Değişebilir mi

Kategori sayısı değişmez ama sınır durumlar zamanla netleşebilir. `docs/register-detayli.md` yaşayan bir belge.

## Karar 3 — Mutlak Yasak Katmanı

### Ne

Beş yasak (uzun çizgi, noktalı virgül, yarım cümle, bağlaçla açılan izole cümle, karşıtlık bağlaçları öncesi virgül) register-bağımsız uygulanır. Faz 1'den önce, Faz 2'den önce, her şeyden önce.

### Alternatif ne olabilirdi

Bu yasakları da sinyal olarak koyabilirdik — alarm eşiği ve register kısıtı ile. Örneğin: "noktalı virgül akademik-kurumsalda kabul edilebilir, deneme-blogda alarm."

### Neden ayrı katman

**Birincisi**, bu yasaklar müzakere kabul etmez. Skill her koşulda uygular. Sinyal olarak koymak "belki bu registerde tolerans var" tartışması yaratıyordu. Ayrı katmana çıkarmak bu tartışmayı bitirdi.

**İkincisi**, mutlak yasaklar skill'in kimliğini belirliyor. Bu skill "Türkçe olsun" değil, "AI Türkçesi olmasın" der. Beş yasak bu kimliğin somut ifadesi.

**Üçüncüsü**, tasarım netliği açısından okuyucuya (kullanıcı, katkı yapan) "bu skill'in çıktısında asla bulunmayacak şeyler" listesi tek bir yerde görünür. Karışıklık yok.

### Değişebilir mi

Yeni bir yasak eklenebilir (mesela v3.1'de altıncı yasak ortaya çıkabilir). Ama mevcut beş yasaktan biri kaldırılmaz — bu skill'in temel kimliği.

## Karar 4 — Sinyal Hiyerarşisi (Baskın + İkincil)

### Ne

Skill sinyalleri iki grupta topluyor: baskın sinyaller (5 tane, Sinyal 1-5) ve ikincil sinyaller (Sinyal 6-14). Baskın sinyaller tek başına AI-imzası kanıtı. İkincil sinyaller destekleyici — baskınlarla birlikte görüldüğünde şüpheyi güçlendirir.

### Alternatif ne olabilirdi

Bütün sinyaller eşit ağırlıkta olabilirdi. Ya da her sinyal için ayrı bir güven skoru olabilirdi (0-100 arası).

### Neden hiyerarşi

**Birincisi**, gerçek AI çıktısında bazı sinyaller çok daha diagnostik. Uzun tire ve noktalı virgül görmek metnin AI olduğunu neredeyse kanıtlıyor. Ama pasif çatı bağımlılığı tek başına AI kanıtı değil — insan yazarlar da pasif kullanır. Bu farkı mimarinin tanıması lazım.

**İkincisi**, hiyerarşi kullanıcıya karar sunmayı kolaylaştırıyor. "Bu paragrafta üç baskın sinyal var" demek "on iki farklı sinyalden bazıları var" demekten net.

**Üçüncüsü**, güven skoru yaklaşımı skill'i sürekli hesaplama makinesine çeviriyor. Basit ikili ayrım karar hızını artırıyor.

### Değişebilir mi

Sinyal seviyeleri (baskın/ikincil) değişebilir. Bir sinyal zamanla baskın hale gelirse ya da ikincile inerse yeniden ayarlanır.

## Karar 5 — TDK Referanslı Noktalama

### Ne

Skill Türkçe noktalama kararlarında TDK Yazım Kuralları'nı temel alır. Ama TDK'nın izin verdiği bazı yapıları yasaklar (uzun çizgi, noktalı virgül), TDK'nın yanlış saydığı bazı yapıları da yasaklar (karşıtlık bağlaçları öncesi virgül).

### Alternatif ne olabilirdi

TDK'yı hiç referans almamak — modern Türkçe düz yazı geleneğini doğrudan izlemek. Ya da TDK'yı harfi harfine izlemek — TDK ne izin veriyorsa hepsi geçerli.

### Neden bu karma yaklaşım

**Birincisi**, TDK Türkçe yazının otoritesi. Ondan kopmak skill'i keyfi hale getirir. Kullanıcı "neden bu yasak" diye sorduğunda referans göstermek gerekiyor.

**İkincisi**, TDK bazı yapılara izin veriyor ama modern Türkçe düz yazı geleneği bu yapıları terk etmiş (noktalı virgül gibi). Skill bu geleneği takip ediyor, TDK'yı değil.

**Üçüncüsü**, TDK'nın yanlış saydığı bazı yapılar AI'nin yaygın olarak ürettiği yapılar. Bu durumda skill TDK'yla aynı çizgide.

Sonuç: skill TDK'nın altkümesi de değil, üstkümesi de değil. Bazı yerlerde katı, bazı yerlerde aynı çizgide.

### Değişebilir mi

TDK Yazım Kuralları güncellenirse skill de gözden geçirilir. Ama modern Türkçe düz yazı geleneği referansı sabit kalır.

## Karar 6 — ASD-STE100 Esinli Nicel Metrik

### Ne

Skill sinyal yoğunluğunu 100 kelimeye normalize ederek ölçer. "Önce: 8.4 sinyal/100 kelime. Sonra: 1.2. İyileşme: %86."

### Alternatif ne olabilirdi

Yüzde bazlı ölçüm ("kelimelerin %X'ine dokunuldu"). Ya da kalitatif değerlendirme (yüksek/orta/düşük AI-imzalı). Ya da hiç ölçüm — sadece rapor.

### Neden ASD-STE100 mantığı

ASD-STE100 (Aerospace and Defence Simplified Technical English, 1986) havacılık sektöründe kullanılan kısıtlı bir yazım standardı. Bu standardın bir özelliği "kural ihlali puanı" — belge kaç kuralı ne kadar ihlal ediyor, sayısal olarak ölçülüyor.

Bu mantığı Türkçe humanizer'a getirmenin üç faydası var:

**Birincisi**, iyileşme sayısal olarak ifade edilebiliyor. Kullanıcı skill'in ne kadar iş yaptığını görüyor.

**İkincisi**, metrik sürüm karşılaştırması için kullanılabilir. v2.1 ve v3.0'ın aynı metin üzerindeki sinyal yoğunluğu karşılaştırılabilir.

**Üçüncüsü**, benchmark korpus için altyapı hazır. Standart korpus üzerinde skill'in her sürümü sayısal skor üretir.

### Uyarı

Metrik hedef haline getirilmemeli. Skill sinyal yoğunluğunu düşürmek için editör kalitesinden ödün vermez. Metrik rapor edilir, optimize edilmez.

### Değişebilir mi

Metriğe ek olarak "kabul oranı" metriği v3.0'da devrededir (kullanıcının önerilen değişiklikleri kabul etme yüzdesi). İleride başka metrikler eklenebilir.

## Karar 7 — Yapı Koruma Prensibi

### Ne

Skill belge iskeletine dokunmaz. Madde listeleri liste kalır, başlıklar başlık kalır, tablolar tablo kalır. Cümle içi ve paragraf içi dil düzeltmesi yapar.

### Alternatif ne olabilirdi

Skill yapıya da dokunabilirdi. "Bu liste paragraf olarak daha iyi akar" diye yeniden yapılandırabilirdi.

### Neden yapı korunuyor

Yapı içeriktir, süs değil. Bir kitap taslağında madde listesi bilinçli bir editör kararı — okur o formattan yararlanacak. Skill bu kararı bilmiyor. Yapıya dokunmak kullanıcının işini bozar.

Kullanıcı açıkça "yapıyı da değiştir" derse skill değiştirir. Ama varsayılan davranış "dokunma"dır.

### Değişebilir mi

Bu prensip sabit. v2.1'de eklendi, v3.0'da korunuyor.

## Karar 8 — Yazar Profil Sistemi (v3.0 Eki)

### Ne

Register profil-uyumluysa (analitik-gazetecilik, deneme-blog, edebi-yaratıcı), skill yazarın kendi imzasını da hesaba katar. Profil dosyası kullanıcının yapıştırdığı üç ile beş örnek metin.

### Alternatif ne olabilirdi

Profil sistemi hiç olmayabilirdi (v2.1'de yoktu). Ya da profil zorunlu olabilirdi (her kullanıcı önce profil oluşturmalı). Ya da profil detaylı forma dayanabilirdi (yaş, meslek, stil tercihleri).

### Neden opsiyonel örnek-tabanlı profil

**Birincisi**, zorunlu profil skill'in giriş engelini yükseltir. Kullanıcı "önce ödev yap sonra çalıştır" durumundan kaçar. Skill kullanılmaz olur.

**İkincisi**, form-tabanlı profil zaman ister ve kullanıcı hangi alanın önemli olduğunu bilmez. Örnek yapıştırmak zahmetsiz.

**Üçüncüsü**, "eski yazın nasıldı" sorusu kişiselleştirme için doğal bir soru. Kullanıcı YAML görmez, alan doldurmaz, sadece kendi metnini paylaşır.

### Değişebilir mi

Profil formatı zenginleşebilir (mesela "kaçınılacak kalıplar" listesi eklenebilir). Ama örnek-tabanlı temel yapı sabit.

## Karar 9 — Kullanıcıya Danışma Protokolü (v3.0 Eki)

### Ne

Skill kendi kararının sınırında olduğu her yerde kullanıcıya soru sorar. Metonim ayrımı, sınır bağlaçları, belirsiz register durumları için.

### Alternatif ne olabilirdi

Skill her zaman kendi kararını verebilirdi (danışma yok). Ya da her sinyal için danışabilirdi (aşırı danışma).

### Neden orta yol

**Birincisi**, aşırı danışma kullanıcıyı yorar. Skill her adımda "bunu yapayım mı" sorarsa kullanıcı skill'i kullanmaz.

**İkincisi**, hiç danışmama skill'i keyfi yapar. Sınırda kararlarda yazar-özgü tercih AI-imzası sanılıp temizlenir.

**Üçüncüsü**, v2.1 zaten kendi kararının sınırında olduğu yerlerde doğal olarak sormaya başladı. Bu emergent davranışı v3.0'da formalize etmek doğru yol.

### Değişebilir mi

Danışma tetikleyicileri (hangi durumlarda sorulur) zamanla netleşir. Ama danışma prensibi sabit.

## Karar 10 — Değişiklik Özeti ve Onay (v3.0 Eki)

### Ne

Skill her müdahalesini işaretler. Sonda kullanıcıya değişiklik listesi sunar, kullanıcı tek tek onaylar veya reddeder.

### Alternatif ne olabilirdi

Skill toplu değişiklik yapabilirdi (v2.1 böyleydi). Ya da hiç değişiklik yapmadan sadece önerebilirdi.

### Neden tek tek onay

**Birincisi**, toplu değişiklik editörü kör bırakır. Kullanıcı ya hepsini kabul eder ya baştan yazar — ara yol yok.

**İkincisi**, tek tek onay editörü tekrar merkeze koyar. Skill öneri makinesi, editör karar makinesi.

**Üçüncüsü**, kabul/red kararları log'a yazılır (feedback.jsonl). Bu kalibrasyon için veri sağlar.

### Değişebilir mi

Onay formatı zenginleşebilir (batch onay, kategori bazlı onay). Ama tek tek onay prensibi sabit.

## Kaynak ve İlham

- **ASD-STE100** (1986): Simplified Technical English standardı. Nicel metrik ilhamı.
- **harshaneel/humanize**: İngilizce humanizer projesi. Genel mimari ilhamı.
- **makotofalcon/humanizer-ja**: Japonca humanizer projesi. Register-farkındalık ilhamı.
- **Türk edebiyat ve akademi geleneği**: Ritim imzaları için stilometrik referans.

turkce-humanizer bu ilhamları Türkçe'nin kendi AI-imzası taksonomisi üzerine kurgular. İngilizce şablonun çevirisi değildir. Türkçe'nin eklemeli yapısı, serbest dizilimi, register salınımı ve TDK-referanslı noktalama kültürü mimariye yansımıştır.
```

## File: docs/register-detayli.md
size: 8070
sha: b51a74dead19179863d01042e26921f01c91281d
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/docs/register-detayli.md

```text
# Register Detayları

Bu dosya turkce-humanizer skill'inin beş register kategorisini uzun uzun açıklar. SKILL.md'de her registerin bir satırlık tarifi var; burada her registerin sınırları, örnek metin türleri, sınır durumları ve karar kriterleri detaylanır.

## Neden Register Önemli

Skill'in temel önermesi şudur: aynı temizlik kuralı her metne uygulanmaz. Bir KVKK sözleşmesine konuşma dili girmez, bir gazete yazısına girer. Bir tez yarım cümleyi tolere etmez, bir edebi metin ederse yazar bilincidir.

Faz 1 (mutlak yasaklar + baskın sinyaller + ikincil sinyaller) her registerde uygulanır — yani AI-imzası her yerden temizlenir. Faz 2 (insan ritmi enjeksiyonu) sadece uygun registerde uygulanır.

Register teşhisi yanlış yapılırsa iki tehlike var:
- **Yüksek registeri düşük sanıp Faz 2 uygulamak:** KVKK sözleşmesine konuşma bağlacı sokmak. Bu metnin işlevini bozar.
- **Düşük registeri yüksek sanıp Faz 2'yi kısıtlamak:** Blog yazısına akademik ritim vermek. Bu metni cansız bırakır.

Bu yüzden skill teşhis kararını her zaman kullanıcıya doğrulatır.

## Register 1 — Hukuki-idari

### Metin türleri

- Sözleşmeler (kira, iş, hizmet)
- KVKK metinleri, aydınlatma metinleri, açık rıza metinleri
- Kanun taslakları, kanun maddeleri, yönetmelikler
- Resmi tebliğler, genelgeler
- Mahkeme kararları
- Kurumsal politika metinleri (etik kod, disiplin yönetmeliği)
- Vekaletname, senet, protokol

### Sınırlar

Hukuki-idari register kişisel ses taşımaz. Sözleşmede "biz" veya "sanırım" olmaz. Metin bir işlem taşır, yorum değil.

### Faz 2 uygulaması

Yok. Bu registerde Faz 2 sinyallerinin hiçbiri devreye girmez. Skill sadece Faz 1'i çalıştırır — AI-imzasını temizler ama insan ritmi enjekte etmez.

### Profil sorgusu

Yok. Yazar imzası bu registerde geçerli değil.

### Sınır durum

Kurumsal iletişim metni (şirket bloguna yakın): hukuki-idari değildir. Analitik-gazetecilikte sayılır.

## Register 2 — Akademik-kurumsal

### Metin türleri

- Tezler (yüksek lisans, doktora)
- Akademik makaleler (dergi, konferans bildirisi)
- Resmi raporlar (kurum içi analiz, yıllık rapor)
- Devlet kurumu belgeleri (bakanlık raporu, komisyon raporu)
- Kitap bölümü, akademik el kitabı
- Standart, teknik şartname
- Politika belgeleri (policy paper)

### Sınırlar

Akademik-kurumsal register birinci çoğul kullanır ("araştırdığımızda," "gördüğümüz gibi") — bu yazar sesinin bir formudur ama akademik geleneğe uygundur. Kişisel deneme sesi taşımaz.

### Faz 2 uygulaması

Kısıtlı. Sadece Sinyal 15 (cümle uzunluğu varyansı), Sinyal 18 (öz-düzeltme, sınırlı) ve Sinyal 22 (birinci çoğul) devreye girer. Konuşma bağlaçları (Sinyal 16) ve retorik soru (Sinyal 17) uygulanmaz.

### Profil sorgusu

Yok. Bu registerde yazar imzası kurumsal ses tarafından örtülür.

### Sınır durum

Akademik ama "denemeye kayan" metinler (mesela Ortaylı'nın gazete yazıları): analitik-gazetecilikte sayılır, akademik-kurumsalda değil. Karar için metnin yayın mecrası (dergi mi köşe mi) bakılır.

## Register 3 — Analitik-gazetecilik

### Metin türleri

- Haber (analiz-ağırlıklı, düz haber değil)
- Analiz yazısı
- Brifing, executive summary
- Düşünce kuruluşu (think tank) raporu
- Gazete köşe yazısı (analitik ağırlıklı)
- Sektör raporu (analiz kısmı)
- Uzman görüşü yazısı
- Politika analizi

### Sınırlar

Analitik-gazetecilik yazar sesini taşır ama kişisel değil, uzman sesidir. "Ben" nadiren geçer, "biz" analitik anlamda geçer ("gördüğümüz üzere"), ama "canım," "yani," "he" gibi konuşma dili işaretleri girmez.

### Faz 2 uygulaması

Tam. Konuşma bağlaçları (Sinyal 16) uygulanır — "Ama," "Zaten," "Oysa," "Ne var ki," "Nitekim." Ama bu bağlaçlar cümlenin içinde kalır, izole cümle açmaz (mutlak yasak 4).

Retorik soru (Sinyal 17) sınırlı uygulanır. Öz-düzeltme (Sinyal 18) uygulanır.

Duyusal detay (Sinyal 19), zaman kipi kayması (Sinyal 20), diyalog izi (Sinyal 21) uygulanmaz — bunlar edebi registere aittir.

### Profil sorgusu

Var. Bu register profil-uyumludur. Skill profil dosyası varsa kullanır, yoksa bir kez sorar.

### Sınır durum

Politika analizi mi akademik makale mi belirsizse: yayın mecrasına bakılır. Hakemli dergide çıkacaksa akademik-kurumsal, düşünce kuruluşu web sitesinde çıkacaksa analitik-gazetecilik.

## Register 4 — Deneme-blog

### Metin türleri

- Kişisel deneme (essay)
- Köşe yazısı (kişisel ağırlıklı, analitik değil)
- Blog yazısı
- Sosyal medya uzun formatı (Twitter thread, LinkedIn post)
- Substack bültenleri
- Kişisel web sitesi yazıları

### Sınırlar

Deneme-blog yazar sesinin en görünür olduğu registerdir. Birinci tekil ("ben") sık, kişisel deneyim referansı sık, yazarın estetik tercihleri açık.

### Faz 2 uygulaması

Tam. Bütün Faz 2 sinyalleri devreye girer (duyusal detay, zaman kipi kayması, diyalog izi hariç — bunlar edebiye özgü).

### Profil sorgusu

Var. Bu register profil-uyumludur.

### Sınır durum

Blog yazısı mı analitik yazı mı belirsizse: yazarın birinci tekil kullanımına bakılır. "Ben bugün fark ettim ki..." açıksa deneme-blog. "Analiz şunu gösteriyor..." açıksa analitik-gazetecilik.

## Register 5 — Edebi-yaratıcı

### Metin türleri

- Roman, öykü
- Denemeye yakın anlatı
- Şiir (sınırlı — skill şiir üzerinde temkinli çalışır)
- Otobiyografik anlatı
- Yaratıcı non-fiction (creative non-fiction)
- Karakter içi düşünce akışı

### Sınırlar

Edebi-yaratıcı register her şeyin izinli olduğu register değildir. Yazar sesi, karakter sesi, anlatıcı sesi ayrımı vardır. Ama duyusal detay, zaman kipi kayması, diyalog gibi imzalar bu registere özgüdür.

### Faz 2 uygulaması

Tam artı üç ek sinyal: duyusal somut detay (Sinyal 19), zaman kipi kayması (Sinyal 20), diyalog izi (Sinyal 21).

### Profil sorgusu

Var. Ama edebi profil oluşturmak zor — çünkü edebi yazar sesi çok bireyseldir. Skill profil sorgusunda özellikle dikkatli olur: "Bu edebi bir metin, senin sesin çok belirleyici. Kendi yazdığın bir edebi parça paylaşırsan çok daha iyi çalışırım. Sadece analitik metnini değil, edebi metnini paylaşman lazım."

### Sınır durum

Edebi denemeler (Tanpınar'ın *Beş Şehir*'i gibi): edebi-yaratıcı sayılır, deneme-blog değil. Karar için metnin edebi imzalarına bakılır — duyusal detay, mecaz yoğunluğu, ritim bilinci.

## Register Teşhis Kararı Nasıl Verilir

Skill metni okuduğunda üç şeye bakar:

**1. Mecra ipuçları.** Kullanıcı metnin nerede yayımlanacağını söylediyse (mesela "bu bir tez bölümü," "bu bir blog yazısı") bu belirleyicidir.

**2. Sözdizim ipuçları.** Birinci tekil sıklığı, konuşma bağlacı varlığı, teknik terim yoğunluğu, cümle uzunluğu ortalaması, pasif çatı oranı.

**3. İşlev ipuçları.** Metin bir işlem taşıyor mu (hukuki), bir bilgi üretiyor mu (akademik), bir yorum sunuyor mu (analitik), bir deneyim aktarıyor mu (deneme), bir dünya kuruyor mu (edebi).

Bu üç ipucundan çıkardığı tahmini kullanıcıya doğrulatır. Kullanıcı düzeltirse skill kabul eder ve baştan başlar.

## Register Karışımı

Bir metnin farklı bölümleri farklı registerlerde olabilir. Örnek: bir kitap taslağının önsözü deneme-blog, giriş bölümü analitik-gazetecilik, ana bölümleri akademik-kurumsal olabilir.

Bu durumda skill her bölüm için ayrı teşhis yapar ve kullanıcıya sunar:
> "Bu belgeyi tek register olarak görmüyorum. Önsöz deneme-blog, giriş analitik-gazetecilik, ana bölümler akademik-kurumsal. Her bölümü kendi registerinde işleyeyim mi?"

Kullanıcı "hepsini tek register olarak işle" diyebilir. O zaman skill baskın registeri seçer ve ona göre çalışır — ama not düşer: "X bölümünü Y registerinde işledim, dokunmadığım stilistik özellikler olabilir."
```

## File: docs/tdk-referanslari.md
size: 7507
sha: 7af163ee3d53180e615ee2d82492365018ce104f
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/docs/tdk-referanslari.md

```text
# TDK Referansları

Bu dosya turkce-humanizer skill'inin noktalama yasaklarının TDK karşısındaki konumunu açıklar. Skill bu dosyayı okumak zorunda değil — mutlak yasaklar SKILL.md'de tanımlı. Bu dosya insan referansı içindir: katkı yapmak isteyen biri, "neden bu yasak" sorusuna cevap arayan biri, ya da yasağın TDK ile ilişkisini merak eden biri için.

## Skill'in TDK ile Üç Farklı İlişkisi

Skill TDK Yazım Kuralları'nı temel alır ama üç farklı ilişki taşır:

**1. TDK'dan katı olduğu yerler.** TDK'nın izin verdiği bazı yapıları skill yasaklıyor. Sebep: bu yapılar TDK'ya uygun olsa bile Türkçe AI çıktısının belirgin imzalarıdır. Örnek: noktalı virgül, uzun çizgi.

**2. TDK ile aynı çizgide olduğu yerler.** TDK'nın da yanlış saydığı ama AI'nin yaygın olarak ürettiği yapıları skill yasaklıyor. Örnek: karşıtlık bağlaçları öncesi virgül.

**3. TDK'nın belirsiz bıraktığı yerler.** TDK'nın açık bir kuralı olmadığı ama Türkçe yazı geleneğinin belirli bir tercihi olduğu yerlerde skill geleneği takip eder. Örnek: bağlaçla açılan izole cümle yasağı — TDK'da açık kural yok, ama Türk edebiyat ve akademi geleneğinde bu tür cümleler estetik olarak kabul görmez.

## Mutlak Yasak 1 — Uzun Çizgi

### TDK'nın kuralı

TDK Yazım Kuralları uzun çizgiye (—) sınırlı bir alan tanır. Ana kullanımı diyalog başındadır:

> — Eski şehri gezdin mi?
> — Evet, dün akşam.

Ayrıca satır sonunda kelime bölme durumunda ve bazı basılı yayınlarda cümle içi ara sözü belirtmek için de görülür.

### Skill'in duruşu

Skill uzun çizgiyi *tamamen* yasaklar. Diyalog başında bile kullanmaz — bu skill düz metin ürettiği için diyalog formatı zaten çıktısında yer almaz.

### Neden yasak

Türkçe AI çıktısı uzun çizgiyi İngilizce "em dash" mantığıyla kullanır — cümle içinde ara söz belirtmek için. Bu Türkçe'nin doğal noktalama refleksi değildir. Türkçe ara söz için ya virgül kullanır ya iki nokta üst üste ya da cümleyi böler. Uzun çizgi geldiğinde metin İngilizce çevirisi hissi verir.

## Mutlak Yasak 2 — Noktalı Virgül

### TDK'nın kuralı

TDK noktalı virgüle üç izinli kullanım tanır:

1. **Cümle içinde virgüllerle ayrılmış öbekleri birbirinden ayırmak için:**
   > "Aynı zamanda; hukukun uygulanması, adaletin sağlanması ve toplum düzeninin korunması bu ilkeye bağlıdır."

2. **Ögeleri arasında virgül bulunan sıralı cümleleri birbirinden ayırmak için:**
   > "At ölür, meydan kalır; yiğit ölür, şan kalır."

3. **İkiden fazla eş değer öge arasında virgülle sıralanmış cümlenin son ögesini vurgulamak için:**
   > "Ordu, kalabalık; halk, sessiz; şehir, karanlıktı."

### Skill'in duruşu

Skill noktalı virgülü *koşulsuz* yasaklar. TDK'nın üç izinli kullanımının hiçbiri geçerli değildir. Noktalı virgül gördüğü her yerde cümleyi ikiye böler (bağlaçla açılan izole cümle üretmeden).

### Neden yasak

İki sebep var:

**Birincisi**, noktalı virgül modern Türkçe düz yazısında son yıllarda neredeyse kaybolmuştur. Tanpınar, Ayfer Tunç, Barış Bıçakçı, İlber Ortaylı gibi referans yazarlar noktalı virgül kullanımından büyük ölçüde uzak durur. Bir metinde noktalı virgül görmek okuru "bu metin ya çok eski ya AI" izlenimine götürür.

**İkincisi**, AI Türkçe çıktısı noktalı virgülü İngilizce "; also / ; however / ; therefore" mantığıyla kullanır. Yani AI aslında İngilizce'nin sözdizim mantığını Türkçe'ye taşırken noktalı virgülü bağlaç yerine kullanıyor. Bu Türkçe'nin doğal ritmini bozar.

## Mutlak Yasak 3 — Yarım Cümle

### TDK'nın kuralı

TDK'nın "yarım cümle" ya da "fragment cümle" konusunda açık bir yasağı yoktur. Cümle tanımı özne ve yüklem üzerinden yapılır ama üslup meselesi olarak fragment cümleye izin verilir.

### Skill'in duruşu

Skill fragment cümle üretmez. Kısa cümle üretebilir ama tam cümle olarak — özne ve yüklem taşıyacak şekilde.

### Neden yasak

AI Türkçe çıktısı fragment cümleyi "vurgu aracı" olarak kullanır: "Bitti." "Kalakaldı." "Yeni bir dönem." Bu İngilizce copywriting geleneğinden gelir (özellikle marketing metinleri). Türkçe edebiyat ve akademi geleneğinde bu tarz fragment cümle nadirdir — Tanpınarvari bilinçli asılı bitirme dışında pek görülmez.

Kullanıcı bilinçli edebi tercihle fragment yazmak isterse skill'i kullanmaması gerekir. Skill'in görevi AI-imzasını temizlemek — ve fragment cümle Türkçe AI çıktısının belirgin imzalarından biri olduğu için koşulsuz yasak.

## Mutlak Yasak 4 — Bağlaçla Açılan İzole Cümle

### TDK'nın kuralı

TDK'da açık bir yasak yok. "Ama," "ancak," "fakat" gibi bağlaçların cümle başında kullanımı gramer olarak yanlış sayılmıyor.

### Skill'in duruşu

Skill "Ama şu oldu." "Ancak durum farklıdır." tarzı bağlaçla açılan izole cümleler üretmez. Bağlaç ya cümlenin içinde kalır ya iki cümle birleştirilir.

### Neden yasak

Bu skill'in TDK'yla çatıştığı değil, geleneği takip ettiği bir yasaktır. Türk edebiyat ve akademi geleneği bağlaçla açılan izole cümleyi estetik olarak zayıf sayar. Karşıtlık bağı zaten iki cümle arasında var — bağlacı ikinci cümlenin başına koyup birinciyle bağı koparmak retorik olarak yumuşamadır.

Referans yazarlar (Tanpınar, Ortaylı, Karpat, Keyder) bağlaçları neredeyse hep cümle içinde tutar. AI Türkçe çıktısı ise İngilizce "But..." "However..." cümle-başı bağlaç geleneğini taşıdığı için sık sık izole bağlaç açar.

## Mutlak Yasak 5 — Karşıtlık Bağlaçları Öncesi Virgül

### TDK'nın kuralı

TDK bu konuda skill ile aynı çizgidedir. "Ama," "ancak," "fakat," "lakin" gibi karşıtlık bağlaçlarından önce virgül konulmaz. Bu TDK Yazım Kuralları'nda açıkça belirtilir.

Doğru:
> "Türkiye reform yaptı ama sonuç sınırlı kaldı."

Yanlış:
> "Türkiye reform yaptı, ama sonuç sınırlı kaldı."

### Skill'in duruşu

TDK ile aynı — bağlaç öncesindeki virgülü siler.

### Neden yasak

İngilizce'de "but" ve "however" öncesi zorunlu virgül kuralı vardır ("...worked, but...", "...worked; however,..."). AI bu kuralı Türkçe'ye zorla çevirir. Sonuç: TDK'ya göre yanlış, Türkçe okur için hissedilir bir sözdizim bozukluğu, AI çıktısının en belirgin imzalarından biri.

Bu yasak "TDK'dan katı" değildir, TDK ile aynı çizgidedir. Skill sadece AI'nin yaptığı yanlışı düzeltir.

## İzinli Sayılan İki Nokta Üst Üste Kullanımları

Skill iki nokta üst üsteyi tamamen yasaklamaz — TDK'nın izin verdiği iki kullanım geçerlidir:

**1. Örneklendirme ya da açıklama gerektiren cümle sonunda:**
> "Üç ana referans yazar var: Tanpınar, Tunç, Bıçakçı."

**2. Konuşma öncesinde:**
> "Editör dedi ki: bu bölüm baştan yazılmalı."

Skill'in yasakladığı kullanım cümle-içi mini açıklama modu: "Bu durum: yeni bir dönemin başlangıcı." tarzı fragment tanımlar. Bunlar Sinyal 1c altında tanımlıdır.

## Kaynak

Türk Dil Kurumu, *Yazım Kuralları*. Erişim: [tdk.gov.tr](https://www.tdk.gov.tr).

Bu dosya TDK Yazım Kuralları'nın turkce-humanizer skill'inin kararları açısından incelemesidir. Kapsamlı bir noktalama rehberi değildir.
```

## File: examples/guclu-cumleler.md
size: 4320
sha: dbeff70172aef68295a27bd18590fa4d41346770
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/examples/guclu-cumleler.md

```text
# Güçlü Türkçe Cümleler — Örnek Korpusu

Bu dosya turkce-humanizer skill'inin "güçlü cümle" hedefi için referans korpusudur. Skill bir cümle üretirken bu örneklerin cümle mimarisine bakar. Zorlama taklit değil, kalıp öğrenimi.

## Güçlü Cümlenin Üç Niteliği

Bu korpus üç niteliği ortak taşıyan cümlelerden oluşur:

**1. Bir şey iddia eder.** Cümle bittiğinde okur bir şey biliyor olmalı. AI cümleleri kaçamaklı biter, güçlü cümle durur.

**2. Tam bir yapıdadır.** Özne ve yüklem yerindedir. Uzunluk önemli değil, tamlık önemli.

**3. Ritmi vardır.** Cümlenin içinde bir nefes akışı vardır. Bu ritim virgül sayısıyla ölçülmez, cümlenin okuma sesiyle ölçülür.

## Edebi Referanslar

### Ahmet Hamdi Tanpınar

**Beş Şehir:**
> "En büyük meselemiz mazi ile nerede ve nasıl bağlanacağımız sorusu. Hepimiz bir şuur ve benlik buhranının çocuklarıyız."

**Huzur:**
> "Vücutlarımız, birbirimize en kolay vereceğimiz şey. Asıl mesele, birbirimize hayatlarımızı verebilmek."

**Saatleri Ayarlama Enstitüsü:**
> "Saatin kendisi mekân, yürüyüşü zaman, ayarı insandır."

### Ayfer Tunç

**Bir Deliler Evinin Yalan Yanlış Anlatılan Kısa Tarihi:**
> "Yaş ilerleyince anlıyordu insan. Mutluluk öyle gökten zembille inmiyor, itina istiyordu."

**Suzan Defter:**
> "Yaşamak her şeye rağmen bir iz bırakmaktır yeryüzünde."

### Barış Bıçakçı

**Bizim Büyük Çaresizliğimiz:**
> "Her şeyin geçip gittiğine, yaşadıklarımızın geçmişte kaldığına kim inandırabilir bizi?"

**Denemeler (genel üslup):**
> "Önce aşk vardır. Hatırlamak da, acı çekmek de ondan sonra başlar."

### Ahmet Ümit

**İstanbul Hatırası:**
> "İnsan ruhunun yarası dikiş tutmaz."

## Akademik Referanslar

### İlber Ortaylı

**İmparatorluğun En Uzun Yüzyılı:**
> "Osmanlı Batılılaşması, Batı'yı hayranlıktan öte zorunluluk nedeniyle tercih etmiştir."

### Kemal Karpat

> "Osmanlı Devleti, daha sonra otuz kadar ulusa dönüşerek imparatorluğun varlığına son vermiş olan sayısız etnik, dilsel ve dinsel grubu bir arada tutan, tarihin en başarılı çok-kavimli, çok-dinli devletlerinden biriydi."

### Çağlar Keyder

**Türkiye'de Devlet ve Sınıflar:**
> "Jöntürklerin başlıca kaygısı, Osmanlı Devletinin özerkliğini ve coğrafi bütünlüğünü yeniden kurmaktı. Böylece 'devleti kurtarmak', geleneksel düzeni bürokrasinin ayrıcalıklı konumunu değiştirmeden korumanın sembolik formülü oldu."

## Korpus Notları

Bu korpus başlangıç sürümüdür. Zaman içinde şu yollarla zenginleştirilir:

- Kullanıcının okumalarında rastladığı "işte bu cümle" dediği örneklerin eklenmesi.
- Marcus, Aksoy gibi ek akademik referanslardan cümle çıkarımı.
- Farklı registerlerden örneklerin dengelenmesi (şu an edebi ağırlık baskın, akademik ve analitik-gazetecilik eksik).
- Katkı: pull request ile başkaları da örnek ekleyebilir.

## Neden Bu Yazarlar

Referans yazarların seçimi keyfi değil. Üç kriter:

**1. Türkçe düz yazı geleneğinin yerleşik isimleri.** Bu yazarlar kanonda. Ritim imzaları rastlantısal değil, gelenek üreten.

**2. Farklı registerlerin temsili.** Tanpınar edebi-yaratıcı. Ortaylı akademik-kurumsalın gazete köşesine kayan hali. Karpat ve Keyder tam akademik. Ayfer Tunç ve Bıçakçı çağdaş edebi. Ahmet Ümit popüler edebi.

**3. AI-Türkçesinden en uzak stiller.** Bu yazarların cümle mimarisi AI çıktısının tam karşıtı. Onları öğrenmek AI-imzasını çıkarmayı da öğrenmek demek.

Yaşayan yazarlardan örnek almak ayrıca faydalı — çünkü çağdaş Türkçe'nin ritim imzasını gösteriyor. Sadece klasik yazarlarla sınırlı kalmak modern Türkçe için yanıltıcı olurdu.

## Kullanım Notu (Skill İçin)

Skill bu korpusa şu şekilde bakar:

- Faz 2'de bir cümle üretirken bu örneklerin uzunluk ortalamasına, özne-yüklem yakınlığına, bağlaç kullanımına referans alır.
- Kelime seçimi taklit etmez. "Osmanlı" ya da "insan ruhu" gibi terimleri kopyalamaz.
- Cümle *iddia gücü* için bu örneklere bakar. Kaçamaklı bitiş üretmek yerine iddialı bitiş üretir.

Bu bir yazar taklidi değildir. Cümle mimarisinin öğrenimidir.
```

## File: LICENSE
size: 1066
sha: ee24096337622611f9d430ea53e2628d2e2cacc4
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/LICENSE

```text
MIT License

Copyright (c) 2026 bushrabeg

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## File: ROADMAP.md
size: 9460
sha: d42001ce899f866897604f1c229f5507ec04b550
upstream: https://github.com/bushrabeg/turkce-humanizer/blob/HEAD/ROADMAP.md

```text
# ROADMAP — turkce-humanizer v3.0

**Tema:** Editör Diyaloğu ve Ölçülebilir Sonuç
**Hedef:** Skill sadece temizleyici değil, editör-yazar diyaloğu aracı olacak.
**Durum:** Tasarım aşaması. v2.1 canlı, v3.0 için karar alındı, kod yazımına başlanmadı.

---

## 1. Yazar Profili Sistemi

### Ne
Kullanıcının kendi yazım tarzını skill'e tanıtabildiği opsiyonel bir katman. Skill profil-uyumlu bir metin gördüğünde, kullanıcının imzasını (kavram üretme refleksi, ritim, tercih edilen kalıplar) tanıyıp korur.

### Neden
v2.1 register'ı biliyor ama yazar sesini bilmiyor. "Masada kazanılan egemenlik" gibi kişisel imzalar bazen AI-sinyali sanılıp temizlenebiliyor. Profil sistemi bu ayrımı yapar.

### Nasıl çalışır

**Kurulum:** Kullanıcı tek mesajda üç-beş örnek metnini paylaşır ("bu metinler benim profilim olsun" der). Claude profili oluşturup dosyaya yazar. Kullanıcı YAML görmez, dosya yolu bilmez, klasör açmaz.

**Format:** Profil dosyası ham metinden ibarettir — kullanıcının yapıştırdığı örnekler + Claude'un çıkarımları (nefes uzunluğu, sık kullanılan kalıplar, korunacak imzalar) yorum olarak eklenir. İnsan-okunabilir, elle düzenlenebilir.

**Konum:** `~/.claude/skills/turkce-humanizer/profiles/ben.md` (varsayılan). Kullanıcı isterse birden fazla profil oluşturabilir.

**Tetiklenme mantığı:**

Kullanıcı bir metin atar, "humanize et" der. Skill önce register'ı belirler.

- **Register profil-uyumsuz** (hukuki, kurumsal): Skill hiç sormadan işi yapar. Profil konusu açılmaz.

- **Register profil-uyumlu** (analiz, deneme, gazetecilik, edebi): Skill profil dosyasını kontrol eder.
  - Profil dosyası varsa: kullanır, işi yapar.
  - Profil dosyası yoksa: sorar → "Bu metin profil uygulamaya uygun bir register'da. Senin ritmini katmamı istersen kendi yazdığın bir metni paylaş, profilini oluşturayım. İstemiyorsan devam edebilirim."
    - Kullanıcı örnek yapıştırırsa: profil oluşur, aynı çalıştırmada humanize yapılır.
    - Kullanıcı "istemiyorum" derse: profilsiz humanize yapılır.

**Tercih hafızası:** "İstemiyorum" kararı sadece o sohbete özel. Yeni sohbette baştan sorulur. Aynı sohbette tekrar sorulmaz.

### Karar gerekçesi
Opt-in kullanıcı tarafında (dosya oluşturmak zorunda değil), opt-in skill tarafında (register uygun değilse sormaz), opt-in her sohbette (kullanıcı o günkü işine göre karar verir). Üç katmanlı bu yapı skill'i ısrarcı olmaktan çıkarır, teklif eden konuma alır.

---

## 2. Kullanıcıya Danışma Protokolü (Formalize)

### Ne
Skill kendi kararının sınırında olduğu her yerde kullanıcıya açık soru sorar. v2.1'de spontan yaptığı davranış v3.0'da SKILL.md'de tanımlı olacak.

### Neden
v2.1 sınırda kararlar için ("Ne var ki" bağlacı gibi) doğal olarak sormaya başladı. Bu davranış formalize edilmezse tesadüfe kalır, her sohbette güvenilir çalışmaz.

### Nasıl çalışır
Skill üç durumda kullanıcıya danışır:

- Bir sinyalin AI-imzası mı yoksa yazar tercihi mi olduğu belirsiz olduğunda.
- Bir bağlaç veya kalıp register'da sınırda olduğunda ("bu register'da [A] mı [B] mı tercih edersin?").
- Metonim ile eş anlamlı rotasyonu ayrımı belirsiz olduğunda.

Sorular kısa, açık, tek seçim. Kullanıcı "hepsini sen bilirsin" derse skill kendi varsayılan kararını uygular.

### Karar gerekçesi
Editörlük kararlarının bir kısmı algoritmik değil, bağlamsaldır. Skill bunu kabul edip kullanıcıya devretmeli, tahmin etmemeli.

---

## 3. Değişiklik Özeti ve Geri Alma

### Ne
Skill her müdahalesini işaretler. Sonda kullanıcıya değişiklik listesi sunar, kullanıcı tek tek onaylar veya reddeder.

### Neden
v2.1'de skill toplu değişiklik yapıyor, kullanıcı ya hepsini kabul ediyor ya baştan yazıyor. Ara yol yok. Bu editörün kontrolünü kısıtlıyor.

### Nasıl çalışır
Skill humanize sonrası çıktıyı iki bölüm halinde sunar:

- **Metin:** Değişiklikler işaretlenmiş halde (mesela satır numarasıyla).
- **Değişiklik listesi:** "1. [X] → [Y] (Sinyal 7, em dash overuse). 2. [A] → [B] (Sinyal 15, cümle patlaması)..."

Kullanıcı ya "hepsi tamam" der, ya "1, 3, 5'i uygula, gerisini bırak" der. Skill final metni ona göre üretir.

### Karar gerekçesi
Editör her kararı görmek ister. Toplu kabul/red editörü kör bırakır. Tek tek onay editörü tekrar merkeze koyar.

---

## 4. Kabul Oranı Metriği

### Ne
Kullanıcının onayladığı/reddettiği değişiklikler bir log dosyasına yazılır. Zamanla "hangi sinyal hangi register'da ne kadar kabul görüyor" verisi birikir.

### Neden
Sinyal/100 kelime metriği kaldırma metriği, kalite metriği değil. Kabul oranı skill'in gerçek başarısını ölçer. Ayrıca kalibrasyon için veri sağlar — hangi sinyal aşırı hassas, hangisi yetersiz görünür hale gelir.

### Nasıl çalışır
Her değişiklik özeti sonrası kullanıcının kararları `~/.claude/skills/turkce-humanizer/feedback.jsonl` dosyasına yazılır. Her satır bir değişiklik: sinyal, register, öneri, kullanıcı kararı (kabul/red).

Kullanıcı istediğinde `turkce-humanizer stats` benzeri bir komutla özet görür ("Sinyal 7 akademik-kurumsal'da %73 kabul, deneme-blog'da %31 kabul" gibi). İstemezse dosya arka planda birikir, ileride kalibrasyon için kullanılır.

### Karar gerekçesi
Şeffaflık. Skill'in kendi başarısını ölçebilmesi. Kullanıcının da skill'i eğitebildiğini hissetmesi.

---

## 5. Kalibrasyon Örnekleri Klasörü

### Ne
Repo'da `examples/` klasörü. Her sinyal için before/after çiftleri.

### Neden
İki fayda: (1) Skill kalibrasyonu için referans zemin — yeni sinyal eklenirken ya da mevcut sinyal düzenlenirken burası test korpüsü olur. (2) Topluluk katkısına açık zemin — başka kullanıcılar kendi before/after örneklerini pull request ile ekleyebilir.

### Nasıl çalışır
`examples/sinyal-07-em-dash.md` gibi dosyalar. Her dosya bir sinyal için 3-5 before/after çifti içerir, register etiketiyle. Skill kendi kararını verirken bunlara referans olarak bakabilir (opsiyonel, hız için varsayılan olarak kapalı).

### Karar gerekçesi
Skill kararları örneksiz kaldığında soyut kalır. Örnekler kararları somutlaştırır, hem kullanıcı için hem skill için.

---

## 6. Detektör Test Seti

### Ne
GPTZero, Originality.ai, Copyleaks gibi AI-detektörlerin Türkçe modu ile before/after karşılaştırma.

### Neden
Can Yılmaz'ın Twitter sorusuna cevap. Skill'in gerçek dünya detektör direncini ölçmek. Birincil başarı metriği değil, ikincil doğrulama.

### Nasıl çalışır
Belirli sayıda AI-Türkçesi paragrafı → detektör skoru → skill uygulaması → detektör skoru. Karşılaştırma tablosu repo'da tutulur, periyodik güncellenir.

### Karar gerekçesi
Skill'in birincil hedefi detektörü kandırmak değil, insan editör için okunabilir metin üretmek. Ama detektör skorlarını da göstermek şeffaflık için önemli — kullanıcı hem editör kalitesini hem detektör direncini bilerek karar verir.

### Uyarı
Detektör skorlarını *hedef* haline getirmemek gerek. Skill detektörü optimize eder hale gelirse editör kalitesi bozulabilir (Goodhart yasası). Detektör skoru rapor edilir, optimize edilmez.

---

## 7. Benchmark Corpus

### Ne
Standart bir Türkçe AI-metinleri korpüsü. Her sürümde aynı korpus üzerinde skill çalıştırılır, sonuçlar repo'da otomatik raporlanır.

### Neden
Sürümler arası ilerlemeyi ölçmek. v2.1 → v3.0 gerçekten iyileşme mi getirdi, hangi register'da ne kadar? Sayısal kanıt olmadan bu subjektif kalır.

### Nasıl çalışır
`benchmark/` klasöründe her register'dan 10-20 paragraflık AI-üretimi metin. Skill sürüm çıkışlarında bu korpus üzerinde çalıştırılır. Sonuç: sinyal/100 kelime, kabul oranı (elle etiketlenmiş "iyi/kötü" karşılaştırma), detektör skoru. `benchmark/results/vX.Y.md` altında raporlanır.

### Karar gerekçesi
Şeffaflık ve reproducibility. Preprint için de gerekli (bir sonraki adım, v3.1+).

---

## Mimari Kararlar (v2.1'den taşınan, değişmeyecek)

- İki fazlı mimari (Faz 1 koşulsuz temizlik, Faz 2 koşullu enjeksiyon)
- 5 register kategorisi (hukuki-idari, akademik-kurumsal, analitik-gazetecilik, deneme-blog, edebi-yaratıcı)
- Sinyal hiyerarşisi (baskın + ikincil)
- TDK-referanslı noktalama katmanı
- Atlanamaz çıktı formatı (rapor + metrik + versiyon + notlar)
- MIT lisansı
- Yapı koruma prensibi (madde listeleri liste kalır)

## v3.0 Kapsamı Dışında Bırakılanlar

Şunlar v3.0'a girmez, sonraki sürümlerde ya da paralel projeler olarak ele alınır:

- **Register sınıflandırıcı ayrı skill** (`turkce-register-detector`): v3.1 veya bağımsız repo. v3.0 kendi register mantığıyla çıkar.
- **Preprint (SSRN veya arXiv)**: v3.0 release + benchmark verisi hazır olduktan sonra ayrı iş.
- **Kullanım sırasında ilk sefer profil önerisi**: v3.1'de düşünülecek, kalibrasyon dikkat ister.

## Sürüm Sonrası Duyuru

v3.0 büyük duyuru olacak. Kimlik: "Editör Diyaloğu ve Ölçülebilir Sonuç." Twitter thread + LinkedIn post + Teknopolitika bültenine gidecek metin. Yalçın Soysal, Can Yılmaz, Alper Zorlu'nun v2.1 dönemi Twitter sorularına toplu cevap niteliği taşır.
```
