Her Projede Neden project-checklist.md Dosyası Olmalı?

Modern yazılım geliştirme süreçleri hızlı ilerliyor — bazen de bu hız hataları beraberinde getiriyor. Yeni özellikler, refactor’lar, deployment’lar, ekip değişiklikleri derken önemli adımlar kolayca unutulabiliyor.

İşte tam bu noktada project-checklist.md dosyası devreye giriyor.

project-checklist.md Nedir?

Projeye eklenen her özellik veya yapılan her güncellemeden sonra tamamlandığından emin olmanız gereken tüm adımları içeren basit ama kapsamlı bir Markdown dosyasıdır.

Kısacası: Takımınızın mühendislik kalite kontrol kapısı.

Tüm checklist’i buradan görebilirsiniz:
GitHub Gist: project-checklist.md

Neleri Kapsıyor?

Checklist şu alanları kapsar:

Kod Kalitesi & Standartlar

• Conventional commit mesajları
• Linter / formatter kontrolleri (pre-commit hook)
• README ve CHANGELOG güncellemeleri
• .editorconfig ve .gitignore kontrolleri

Build & Deployment

• Dockerfile ve docker-compose.yaml
• .env.example dosyası
• CI/CD yapılandırmaları
• (Opsiyonel) Kubernetes YAML dosyaları

Testler

• Unit, integration, API testleri
• Yük ve güvenlik testleri
• Code coverage eşikleri

Dokümantasyon

• API belgeleri (Swagger/OpenAPI)
• Sistem mimarisi diyagramları
• ADR (Architecture Decision Record) belgeleri

Veritabanı ve Veri

• Migration ve seed dosyaları
• Şema güncellemeleri
• Anonimleştirilmiş test verisi

Güvenlik & Uyumluluk

• Audit araçları (npm audit, pip-audit, vb.)
• GDPR / KVKK kontrolleri
• Secret yönetimi ve .env güvenliği

Diğer Gereklilikler

• Feature flag belgeleri
• Logging ve monitoring altyapısı
• Edge case / hata senaryoları

Ne Zaman Kullanılır?

Ne zaman:

• Yeni bir özellik eklerseniz
• Hata düzeltmesi yaparsanız
• Veritabanında değişiklik olursa
• Yayın (release) öncesi
• Pull Request açarken

Checklist dosyasını açın, kontrol edin, eksikleri tamamlayın.

Bu, mühendislik süreciniz için bir unit test gibidir.

Ekstra Öneri

Bu listeyi şu yerlere entegre edebilirsiniz:

• PR template dosyalarına
• CI/CD otomasyonlarına
• Notion ekip sayfalarına
• Developer onboarding rehberlerine

Bir çeşit güvenlik ağı görevi görür — bug’ları, teknik borcu ve belirsizliği azaltır.

Son Söz

“Checklist’ler, niyeti eyleme dönüştürür.”
– Atul Gawande, Checklist Manifesto

Takımınız büyük ya da küçük olsun fark etmez, hiçbir şeyi şansa bırakmayan mühendisler bu tür alışkanlıkları sistemli hale getirir.

Hazırsanız başlayalım:
📎 Checklist’i buradan alın ve projenize ekleyin.

İyi deploylar 🚀