Blog'a Dön
Karar Odaklı Geliştirme Dokümantasyon Değildir
decision-centric-developmentproduct-strategyorganizational-memorydocumentation

Karar Odaklı Geliştirme Dokümantasyon Değildir

Afterchange Team
23 Aralık 2025
12 dk okuma

Dokümantasyon bildiklerimizi açıklar. Karar Odaklı Geliştirme neden harekete geçtiğimizi korur.

Ekipler Karar Odaklı Geliştirme kavramını duyduğunda, genellikle tanıdık bir yere oturtur.

Dokümantasyon.

ADR dosyaları.

Confluence sayfaları.

Kararların yazıldığı bir yer.

Bu varsayım anlaşılırdır.

Ama temelden yanlıştır.


Dokümantasyon Bilgiyi Açıklar

Dokümantasyon, bilinenleri açıklamak için vardır.

Bir sistem nasıl çalışır. Bir özellik ne yapar. Hangi yaklaşım seçilmiştir.

Anlayış netleştikten sonra yazılır.

Açıklık için optimize edilmiştir.

Şu soruya cevap verir:

“Bu nasıl çalışıyor?”

Değerlidir.

Ama kararları yakalamaz.


Kararlar Bilgiden Önce Verilir

Kararlar belirsizlik varken alınır.

Eksik bilgi altında yapılan muhakemelerdir.

Şu soruya cevap verirler:

“Şu an bildiklerimizle ne yapmalıyız?”

O anda:

  • bedeller kabul edilir
  • varsayımlar net değildir
  • beklentiler kırılgandır

Sonuç ortaya çıktığında bilgi gelir.

Karar kaybolur.


Dokümantasyon Neden Hafıza Olamaz

Dokümantasyon kararların yerine konduğunda, kritik bağlam kaybolur.

Ekipler neyin yapıldığını hatırlar.

Ama şunları unutur:

  • neden bu yol seçildi
  • hangi alternatiflerden vazgeçildi
  • neyin değişmesi bekleniyordu

Sonra geçmiş, bugünün bilgisiyle yeniden anlatılır.

Bu öğrenme değildir.

Bu, hikâye onarımıdır.


Karar Odaklı Geliştirme Daha Erken Başlar

Karar Odaklı Geliştirme sonuçları dokümante etmez.

Bağlanma anındaki niyeti kaydeder.

Parlatılmış açıklamalar değil.

Savunmalar değil.

Sonradan uydurulan gerekçeler değil.

Sadece:

  • ne karar verildi
  • o anda neden mantıklıydı
  • neyin değişmesi bekleniyordu

Bu bağlam kısa ömürlüdür.

Kaydedilmezse yok olur.


ADR’ler Yaklaşır — Ama Aynı Şey Değildir

Mimari Karar Kayıtları doğru yönde bir adımdır.

Kararların önemli olduğunu kabul ederler.

Ama hâlâ dokümantasyon gibi davranırlar:

  • genelde uygulamadan sonra yazılır
  • tamlık için optimize edilir
  • gerçek sonuçlardan kopuktur

Karar Odaklı Geliştirme kararları canlı referanslar olarak ele alır.

Olan bitenle bağını koparmaz.


Bu Ayrım Neden Önemli

Karar bağlamı olmadan:

  • metrikler anlamsızlaşır
  • retrospektifler tahmine döner
  • ekipler aynı tartışmaları tekrarlar

Karar bağlamı olduğunda:

  • sonuçlar adil değerlendirilir
  • başarısızlık öğretici olur
  • başarı açıklanabilir hale gelir

Öğrenme kalıcı olur.


Dokümantasyon Değil. Hafıza.

Karar Odaklı Geliştirme dokümantasyonla rekabet etmez.

Onu tamamlar.

Dokümantasyon sistemi açıklar.

Karar Odaklı Geliştirme oraya nasıl gelindiğini açıklar.

Biri bilgiyi korur.

Diğeri muhakemeyi.

İkisi de gereklidir.

Ama aynı şey değildir.

A

Afterchange Team

Ekiplerin kararları takip etmesine ve etkiyi ölçmesine yardımcı oluyoruz.