Architecture Decision Records

Ö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.

₺369 tek seferlik
Bir kit içine ekle →

Fiyatlara KDV (%20) dahildir. · Gerçek ajans işinden çıkarıldı · tek seferlik, kilit yok

  • Tür Skill
  • Kategori Geliştirme
  • Teslimat E-posta · anında
  • Lisans Tek seferlik
Çalışma önizlemesi
forgehouse, architecture-decision-records

Çalışmanın içinden · kara kutu yok

Satın almadan önce işin kendisini gö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.
Kullanım senaryoları · taktığında neler oluyor

Tek güç kaynağı. 6 hat dışarı.

architecture-decision-records · çekirdek

çekirdek aktif · 6 hat

  1. Önemli bir mimari veya teknoloji seçimini belgelemek

    ✓ önemli bir mimari veya t…
  2. Değerlendirilen alternatifleri ve neden reddedildiklerini kaydetmek

    ✓ değerlendirilen alternat…
  3. Geçmiş bir kararı yeni, düzgün bağlantılı bir ADR ile geçersiz kılmak

    ✓ geçmiş bir kararı yeni
  4. Yeni mühendisleri karar geçmişini vererek ekibe uyumlamak

    ✓ yeni mühendisleri karar
  5. Bir ekip için hafif, tekrarlanabilir bir karar süreci kurmak

    ✓ bir ekip için hafif, tek…
  6. Geçmiş bir mimari seçimin hâlâ geçerli olup olmadığını denetlemek

    ✓ geçmiş bir mimari seçimin
Kazanımlar · elinde kalanlar

Aldıkların sende kalır.

Zamanı ileri sar. Ne kaldığını izle.

Sonsuza dek

Sahip olmak tam olarak bu.

Kiralık yığın

yapay zekâ yazım aracı: abonelik

süresi doldu · erişim gitti

analiz paketi: abonelik

süresi doldu · erişim gitti

tasarım platformu: abonelik

süresi doldu · erişim gitti

(geriye bir şey kalmadı)

Senin ocağın

  1. Gelecekteki mühendisler bir kararın neden alındığını tahmin etmeden cevaplayabilir

    lisans: kalıcı
  2. Geri alınabilirlik analizi, geri döndürülemez seçimleri doğru inceleme seviyesine yönlendirir

    lisans: kalıcı
  3. İnsanların gerçekten sürdürdüğü tutarlı, düşük sürtünmeli belgeleme

    lisans: kalıcı
  4. Politikaların birbiriyle sessizce çelişmemesi için temiz bir geçersiz kılma zinciri

    lisans: kalıcı

abonelikler biter · tapular bitmez

Ne içerir · eksiksiz manifest

Kutudaki her şey.

Bir parçayı eline al. Çalışırken izle.

Beş ADR şablonu: standart MADR, hafif, Y-ifadesi, kullanımdan kaldırma ve RFC

parça 01 / 06 · kutuda

6 parça · tek çalışan sistem · e-postayla anında teslim

Kimler için

Bu herkes için dövülmedi.

  • Araç kiralamayı sahip olmaya tercih ediyorsan, sana göre değil.
  • Yığınını senin yerine başkası yönetsin istiyorsan, sana göre değil.
  • Tahmin etmekten memnunsan, sana göre değil.
Hâlâ burada mısın? Güzel.

Teknik kararlarının ardındaki mantığı kaydetmek ve korumak isteyen mimarlar ve mühendislik ekipleri.

o zaman bu senin için dövüldü.

Hangi AI ile çalışır

Tasarımı gereği evrensel: her yapay zekada çalışır. Açık Agent Skills + MCP biçiminde gelir (Claude’da yerleşik); ChatGPT, Gemini, Cursor ve Copilot aynı dosyaları kendine uyarlar.

  • Claude Yerleşik biçim
  • ChatGPT Açık standartla uyarlanır
  • Gemini Açık standartla uyarlanır
  • Cursor Açık standartla uyarlanır
  • Copilot Açık standartla uyarlanır
Sorular · hâlâ havada

Aklındakini yakala.

hava temizlendi. seninle ocak arasında hiçbir şey kalmadı.
bir kıvılcım yakala: ocak cevaplar

  1. 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.

  2. 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.

  3. 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.

  4. Nasıl teslim edilir?

    Satın alımdan hemen sonra e-posta ile iletilir, kuruluma hazır, anında indirilir; bekleme yok.

  5. Tek seferlik mi, abonelik mi?

    Tek seferlik alımdır; abonelik veya gizli ücret yoktur. Fiyata KDV (%20) dahildir.

  6. İade alabilir miyim?

    Dijital ürün olduğu için indirildikten sonra iade yapılmaz. Bu yüzden ne içerdiğini ve kime uygun olduğunu burada açıkça paylaşıyoruz.