---
title: Architecture Decision Records
category: product
entity_type: skill
price: ₺369
canonical: https://forgehouse.ai/tr/skiller/architecture-decision-records/
lang: tr
hreflang_alt: https://forgehouse.ai/skills/architecture-decision-records/
last_updated: 2026-06-20
---

# Architecture Decision Records

> Write and maintain Architecture Decision Records (ADRs) following best practices for technical…

Önemli teknik seçimlerin alındıkları anda: bağlam, alternatifler ve sonuçlarla, kaydedilmesi için Mimari Karar Kayıtları yazma ve sürdürme konusunda eksiksiz bir sistem. Beş savaşta test edilmiş ADR şablonu, yaşam döngüsü yönetimi, geçersiz kılma zincirleri ve bir inceleme süreci sunar; böylece dağınık kabilesel bilgiyi aranabilir bir karar geçmişine dönüştürür.

## Ne için kullanılır
- Önemli bir mimari veya teknoloji seçimini belgelemek
- Değerlendirilen alternatifleri ve neden reddedildiklerini kaydetmek
- Geçmiş bir kararı yeni, düzgün bağlantılı bir ADR ile geçersiz kılmak
- Yeni mühendisleri karar geçmişini vererek ekibe uyumlamak
- Bir ekip için hafif, tekrarlanabilir bir karar süreci kurmak
- Geçmiş bir mimari seçimin hâlâ geçerli olup olmadığını denetlemek

## Faydalar
- Gelecekteki mühendisler bir kararın neden alındığını tahmin etmeden cevaplayabilir
- Geri alınabilirlik analizi, geri döndürülemez seçimleri doğru inceleme seviyesine yönlendirir
- İnsanların gerçekten sürdürdüğü tutarlı, düşük sürtünmeli belgeleme
- Politikaların birbiriyle sessizce çelişmemesi için temiz bir geçersiz kılma zinciri

## Ne içerir
- Beş ADR şablonu: standart MADR, hafif, Y-ifadesi, kullanımdan kaldırma ve RFC
- ADR yaşam döngüsü ve durum modeli (önerilen, kabul edilen, kullanımdan kaldırılan, geçersiz kılınan)
- Bir dizin yapısı, index README ve adr-tools otomasyon rehberi
- Geri alınabilirlik değerlendirmesi dahil gönderim öncesi ve inceleme kontrol listesi
- Kararları izlenebilir tutan geçersiz kılma zinciri kuralları
- Kayıtları dürüst ve kısa tutan yapılması ve yapılmaması gerekenler

## Kimler için
Teknik kararlarının ardındaki mantığı kaydetmek ve korumak isteyen mimarlar ve mühendislik ekipleri.

## Nasıl çalışır
Skill, teknik bir kararın nedenini karar verildiği anda kayda alır. Kara kutu yok, yaptığı iş tam olarak şu:
1. Önce filtreler: önemli kararlar (framework benimseme, veritabanı seçimi, API deseni, güvenlik mimarisi) ADR alır; bug fix, küçük sürüm yükseltme ve config değişikliği atlanır, kayıt gürültü değil sinyal kalır.
2. Kaydı karar anında yazar, asla sonradan değil: Context, Decision Drivers (3-5 madde), reddedilenler dahil dürüst artı ve eksileriyle değerlendirilen seçenekler, kararın kendisi ve hem olumlu hem olumsuz sonuçlar.
3. Her kararın geri alınabilirliğini sınıflar: Type 1 geri dönüşsüz kararlar (DB engine değişimi, public API yayını) RFC süreci ve birden çok paydaş onayı ister; Type 2 geri alınabilir kararları (kütüphane seçimi, cache stratejisi) tek mühendis verebilir.
4. Kararın kapsamını açıkça çizer: başlık nerede geçerli olduğunu söyler, uygulanmadığı alanlar bölümü kararın sınırlı bağlamı dışında yanlış kullanılmasını engeller.
5. Supersede zincirini yönetir: yeni ADR eskisine Supersedes ile referans verir, eskisine Superseded-by notu düşülür, index README güncellenir ve hiç bağlantısı olmayan yetim ADR'lar denetimde işaretlenir.
6. Yönetişimi bilinçli olarak hafif tutar: MADR formatı, en fazla bir sayfa, oluşturma, supersede ve içindekiler üretimi için adr-tools. Kayıt başına on beş dakikayı aşan süreci hiçbir ekip benimsemez.

## Sık sorulanlar
### Zaten bir yıllık belgelenmemiş kararımız var, hepsini geriye dönük yazmadan şimdi başlayabilir miyiz?
Evet, ADR'ler uygulamayı benimsediğin andan itibaren ileriye dönük seçimleri kaydeder, geçmişten yalnızca hâlâ tartışma yaratan birkaç kararı yazıya dökersin. Eski bir karara dönmek istersen, yeni ADR geçersiz kılma zinciri üzerinden ona geriye doğru bağlanır.

### Yazdıktan bir hafta sonra eskiyen dokümanlardan ne farkı var?
Her ADR kabul edildikten sonra değişmezdir; onu düzenlemezsin, bağlı bir yenisiyle geçersiz kılarsın, böylece 'neden' tarihçesi bozulmadan kalır. Yaşam döngüsü durumları ve bir inceleme adımı, sahipsiz sayfalar bırakmak yerine zinciri dürüst tutar.

### Bu mimariye karar vermeme mi yardım eder, yoksa sadece yazıya mı döker?
Kararı, alternatiflerini ve sonuçlarını kaydetmek içindir; karar verme başka yerde olur. Asıl değeri, altı ay sonra herkesin neden o seçimi yaptığını körlemesine sorgulamak yerine okuyabilmesidir.

## Fiyat
₺369, tek seferlik, abonelik yok. KDV dahil.

İlgili rehber: [Yapay zekâ ile kod inceleme](https://forgehouse.ai/tr/rehberler/yapay-zeka-kod-inceleme/)