DERS 2.3 Kalite kapıları: build ve test

KAZANIM Bu dersin sonunda: commit ve yayın öncesi mekanik kalite kapılarını kurup işletirsin.

1TanımKapı = işin bir sonraki aşamaya geçmeden önce geçmek ZORUNDA olduğu mekanik kontrol: build (proje tutarlı mı derleniyor) ve testler (kurallar hâlâ sağlanıyor mu).

2İşlev ve amaçKapılar, denetimi kişisel gayretten çıkarıp mekanik zorunluluğa çevirir. Sizin gözünüz yorulur, kapı yorulmaz. "Geçti/geçmedi" cevabı tartışmasızdır — AI ile aranızdaki en objektif hakem.

3Nasıl yapılırSıralı kapı zinciri: değişiklik → build → (varsa) testler → kendi denemeniz → commit → yayın. Kural: commit'ten önce build; yayından önce hepsi. Kapıyı CLAUDE.md'ye yazın ("commit önerisinden önce build çalıştır ve sonucu göster"). Testleriniz yoksa: kritik akışlar için AI'a yazdırın — "bu projenin en kritik 3 davranışı için test yaz" iyi bir başlangıçtır.

4Ne ters gider + gerçek vaka

Gerçek vaka: Bir üründe hızlı kontrol aracı (tip denetimi) "her şey yolunda" dedi; ama tam build ancak yayın sırasında patladı — sorun, hızlı kontrolün hiç bakmadığı bir katmandaydı. Saatler kaybedildi. Ders: hızlı kontrol, tam build'in yerine geçmez. Yayına neyle çıkıyorsanız kapınız o olmalı.

Gerçek vaka (yayın doğrulaması): Bir yayında komut doğru çalıştı ama farkında olmadan YANLIŞ projeye yayın yapıldı — komut çıktısındaki "hangi projeye yayınlanıyor" satırı okunmamıştı. Ders: kapı sadece build değildir; yayın komutunun çıktısındaki hedef bilgisini okumak da bir kapıdır.

Çözüm kalıbı: kapılar atlanınca değil, atlanamaz yapılınca çalışır — kural dosyaya, alışkanlık zincire.

5AlternatiflerHer kaydetmede otomatik kapı koşturmak (hook — Seviye 3.2) manuel disiplinin gelişmişidir; oraya Seviye 3'te geleceksiniz.

6Denetim penceresiKırmızı bayraklar: "build'e gerek yok, küçük değişiklik" cümlesi (küçük değişiklikler de kırar) · test sayısının büyüyen projede hiç artmaması · "testleri geçti" beyanının çıktısız gelmesi. Kontrol istemi: "build ve test komutlarını çalıştır; çıktıları KISALTMADAN göster; geçmeyenleri tablo yap."

7Mini egzersiz (SANDBOX)Üret: sandbox'ta bir dosyayı bilerek bozdurun ("build'i kıracak küçük bir hata ekle"). Denetle: build'i çalıştırıp hatanın nasıl göründüğünü okuyun; sonra düzelttirin ve kapının yeşile dönüşünü izleyin. Kırmızı-ekranla ilk tanışma güvenli ortamda olsun.

8Kontrol soruları(1) Kapı zinciri hangi sırayla dizilir? (2) Hızlı kontrol neden tam build'in yerini tutmaz? (3) Yayın komutunda okunması şart olan satır hangisidir?

9Mentor istemi

AI Maestro Seviye 2 Ders 2.3'ün (build/test kapıları) hocası ol. Kapı kavramını havaalanı
güvenlik kontrolü metaforuyla anlat. Bana örnek bir build hata çıktısı göster ve
panik yapmadan nasıl okuyacağımı öğret. Sonunda 3 kontrol sorusu.