Teknik borcu yöneticinin diline çevir: iş etkisi + risk gerekçesi
Elindeki teknik borç maddesini, yöneticinin masada karar verebileceği 5 başlıklı bir gerekçeye çevirir: özet, iş etkisi, risk, maliyet karşılaştırması, net öneri.
Bir kod parçasının elden geçmesi gerektiğini biliyorsun. Yöneticine "bunu refactor etmeliyiz" diyorsun, karşındaki boş bakıyor. Teknik olarak haklısın ama karar veren masada cümlen hiçbir karşılık bulmuyor.
Rol: Mühendislik ile yönetim arasında köprü kuran deneyimli bir yazılım yöneticisisin. Görevin, sana vereceğim teknik borç maddesini, teknik terim bilmeyen bir yöneticinin 30 saniyede okuyup karar verebileceği bir gerekçeye çevirmek.
Verdiğim açıklamayı al ve şu 5 başlıkta yeniden yaz:
1. Tek cümlelik özet: Teknik terim kullanmadan sorunun ne olduğu.
2. İş etkisi: Bu borç bugün hangi somut iş sonucuna mal oluyor? (örn. yeni özelliğin gecikmesi, artan hata sayısı, tekrar eden manuel iş, ekip zamanının nereye aktığı). Yalnızca benim verdiğim bilgiden çıkar; bilgi yoksa "EKSİK: [hangi bilgi lazım]" yaz.
3. Risk: Bu borç çözülmezse önümüzdeki dönemde ne kötüleşir? Olasılık ve etki olarak yaz (örn. "büyüdükçe şu arıza ihtimali artar"). Abartma, elindeki bilgiyle sınırlı kal.
4. Maliyet karşılaştırması: Şimdi çözmenin kabaca eforu ile ertelemenin getireceği ek yük. Sana sayısal veri vermediysem sayı uydurma; "şu bilgi verilirse netleşir" de.
5. Öneri: Tek bir net karar önerisi (şimdi çöz / plana al / şimdilik dokunma) ve tek satır gerekçe.
Kurallar:
- Tahmin yürütme. Sana verilmeyen sayıyı, tarihi, müşteri adını uydurma.
- Eksik bilgi varsa ilgili başlıkta "EKSİK: ..." yazarak neyin gerektiğini söyle.
- Teknik jargonu (bağımlılık, test kapsamı, eski sistem, yeniden yazım vb.) sade Türkçeye çevir.
- Kısa yaz. Süsleme yok, karar cümlesi var.
Teknik borç açıklaması:
"""
[Buraya borcu teknik diliyle yapıştır: hangi kod/sistem, neden sorun, ne zamandır böyle, seni ve ekibi nasıl yavaşlatıyor]
"""Elindeki teknik borç maddesini, yöneticinin masada karar verebileceği 5 başlıklı bir gerekçeye çevirir: özet, iş etkisi, risk, maliyet karşılaştırması, net öneri. Vermediğin veriyi uydurmaz, "EKSİK" diye işaretler; böylece toplantıya girmeden önce hangi rakamı toparlaman gerektiğini de görürsün.
Teknik borcu iş ve risk diline çeviren mühendis, "sadece kod yazan" değil, kararı yönlendiren kişi olarak görünür.
Prompt gerekçeyi düzenler ama veriyi üretmez; iş etkisi ve maliyeti sen sayısallaştırmazsan çıktı "EKSİK" kalır, ayrıca sisteme veya müşteriye dair hassas detayı araca yapıştırma.
Ödeme servisindeki entegrasyon katmanı hâlâ 3 yıl önce yazılmış senkron REST çağrılarıyla çalışıyor. A sağlayıcısının API'si değişti ama biz hâlâ artık desteklenmeyen eski (v1) endpoint'ini çağırıyoruz; retry mekanizması yok, timeout'lar elle set edilmiş. Bütün mantık tek bir 1200 satırlık dosyada, unit test neredeyse sıfır. Her yeni ödeme yöntemi eklerken bu dosyaya dokunmak zorundayız ve genelde başka bir yeri kırıyoruz. Geçen sprintte iki kere prod'a hotfix attık. Bağımlılıklar da eski; güncelleyince kırılıyor diye kimse dokunmuyor. İdeali bunu modüllere bölüp event-driven yapıya taşımak ama kimsenin vakti yok.
1. Tek cümlelik özet
Ödeme sistemimizin bir parçası eski ve kırılgan yazılmış; ekip her dokunduğunda başka bir yerin bozulma riski var.
2. İş etkisi
- Her yeni ödeme yöntemi eklemek, aynı kırılgan alana dokunmayı gerektiriyor ve sık sık başka bir yeri bozuyor — yeni işler yavaşlıyor.
- Geçen dönemde iki kez acil düzeltme (hotfix) gerekti; bu planlanmamış işti ve ekip zamanı oraya aktı.
- EKSİK: Bu bozulmaların müşteriye yansıyıp yansımadığı (başarısız/geciken ödeme, etkilenen kullanıcı sayısı) verilmedi. Varsa iş etkisi bundan daha ağır.
3. Risk
- Yüksek etki / şimdilik düşük olasılık: Sağlayıcının artık desteklemediği eski bağlantıyı kullanıyoruz. Sağlayıcı bunu kapatırsa ödeme alma tamamen durabilir.
- Orta etki / orta olasılık: Yeniden deneme mekanizması olmadığı için kısa bir kesinti anında işlemler doğrudan başarısız oluyor, kendiliğinden toparlamıyor.
4. Maliyet karşılaştırması
- Şimdi çözmek: Riskli bağlantıyı güncel sürüme taşımak ve kodu güvenli parçalara bölmek ayrı bir çalışma gerektirir.
- Ertelemek: Her yeni ödeme yöntemi işi yavaş kalmaya, tekrarlayan acil düzeltmeler devam etmeye devam eder.
- EKSİK: Şimdi çözmenin tahmini eforu (kaç kişi-gün) ve son dönemde hotfix + yeni yöntem eklemeye harcanan süre verilmedi. Bu iki sayı olmadan "şimdi mi, sonra mı ucuz" net karşılaştırılamaz.
5. Öneri
Plana al — ama tamamını yeniden yazmadan. Önce yalnızca sağlayıcının kapatabileceği eski bağlantıyı güncel sürüme taşımak öncelikli parça olmalı; en büyük riski en az işle düşürür.
ÜRETİM: TEM 2026 · CLAUDE Bu kayıt eşlenmiş örnek girdi ve çıktı içerir. Model koşumu kanıtı yoktur — kendi verinle doğrulamadan karar girdisi yapma.
Rol: Mühendislik ile yönetim arasında köprü kuran deneyimli bir yazılım yöneticisisin. Görevin, sana vereceğim teknik borç maddesini, teknik terim bilmeyen bir yöneticinin 30 saniyede okuyup karar verebileceği bir gerekçeye çevirmek.
Verdiğim açıklamayı al ve şu 5 başlıkta yeniden yaz:
1. Tek cümlelik özet: Teknik terim kullanmadan sorunun ne olduğu.
2. İş etkisi: Bu borç bugün hangi somut iş sonucuna mal oluyor? (örn. yeni özelliğin gecikmesi, artan hata sayısı, tekrar eden manuel iş, ekip zamanının nereye aktığı). Yalnızca benim verdiğim bilgiden çıkar; bilgi yoksa "EKSİK: [hangi bilgi lazım]" yaz.
3. Risk: Bu borç çözülmezse önümüzdeki dönemde ne kötüleşir? Olasılık ve etki olarak yaz (örn. "büyüdükçe şu arıza ihtimali artar"). Abartma, elindeki bilgiyle sınırlı kal.
4. Maliyet karşılaştırması: Şimdi çözmenin kabaca eforu ile ertelemenin getireceği ek yük. Sana sayısal veri vermediysem sayı uydurma; "şu bilgi verilirse netleşir" de.
5. Öneri: Tek bir net karar önerisi (şimdi çöz / plana al / şimdilik dokunma) ve tek satır gerekçe.
Kurallar:
- Tahmin yürütme. Sana verilmeyen sayıyı, tarihi, müşteri adını uydurma.
- Eksik bilgi varsa ilgili başlıkta "EKSİK: ..." yazarak neyin gerektiğini söyle.
- Teknik jargonu (bağımlılık, test kapsamı, eski sistem, yeniden yazım vb.) sade Türkçeye çevir.
- Kısa yaz. Süsleme yok, karar cümlesi var.
Teknik borç açıklaması:
"""
[Buraya borcu teknik diliyle yapıştır: hangi kod/sistem, neden sorun, ne zamandır böyle, seni ve ekibi nasıl yavaşlatıyor]
"""Yapıştırdığın veri tarayıcından çıkmaz — WhiteYaka'ya gönderilmez. Prompt panoya kopyalanır; açılan sohbete Ctrl/⌘ + V ile yapıştırırsın.
Bülten kaydı kapalı.
Bu sayfa e-posta adresi toplamaz ve liste kaydı başlatmaz. 160 hamlenin tamamı giriş yapmadan açık.