ADR Writer ajanı
ADR Writer ajanı bir tehdit modelini bağlam, karar, sonuçlar ve alternatifler içeren bir Mimari Karar Kaydına dönüştürür; kayıt, önerilen bir ADR olarak saklanır.
ADR Writer ajanı kararları kayda geçirir. Dört bölümden oluşan yapılandırılmış bir Mimari Karar Kaydı (ADR) yazar: Context, Decision, Consequences ve Alternatives.
Nerede çalışır
| İş akışı | Adım |
|---|---|
| Threat Model | Record ADR |
Threat Model üç adımdan oluşur. Architect kapsamı ve verinin sistem içinde nasıl aktığını tarif eder. Security Auditor bunun üzerinde bir STRIDE analizi yapar: kimlik sahteciliği (spoofing), kurcalama (tampering), inkâr (repudiation), bilgi ifşası (information disclosure), hizmet engelleme (denial of service) ve yetki yükseltme (elevation of privilege). Ardından ADR Writer sonucu bir karar olarak kaydeder.
Girdiler
- Oturumun görevi; örneğin "yeni herkese açık webhook API'sinin tehdit modelini çıkar".
- Projenin reposundaki ilgili dosyaların salt okunur bir anlık görüntüsü.
- Önceki iki adımdan gelen kapsam ve STRIDE analizi.
Çıktılar
Context, Decision, Consequences ve Alternatives bölümlerini içeren, metin hâlinde bir ADR.
Platform onu çalışma alanının ADR günlüğüne proposed (önerilen) bir karar olarak kaydeder; oturuma ve ajanın adımına, oturumun bir projesi varsa projeye de bağlar. Başlığı, kaydın anlamlı ilk satırından alınır. Çok kısa bir yanıt kaydedilmez, çünkü hiçbir şeyi karara bağlamaz.
Önerilen olarak kaydetmek bilinçli bir tercihtir. Yapay zekânın yazdığı bir karar, bir kişinin yazdığıyla aynı inceleme akışına girer; böylece günlük, kimsenin bakmadığı bir kararı asla onaylamış olmaz.
Örnek çalıştırma
Gösterim amaçlı bir örnektir, kaydedilmiş bir oturum değildir. Matt, yeni bir webhook özelliği üzerinde Threat Model'i çalıştırır. Architect akışı çıkarır: müşteri bir URL yapılandırır, platform etkinlikleri imzalayıp gönderir, müşterinin sunucusu onları doğrular. Security Auditor; iç adreslere yönelik istek sahteciliğini, yeniden oynatılan etkinlikleri ve günlüklere sızan secret'ları işaretler. ADR Writer kararı kaydeder: webhook hedefleri için özel adres aralıklarını engelle, her etkinliği bir zaman damgasıyla imzala ve eskilerini reddet, signing secret'ı asla günlüğe yazma. Özel ağlardaki müşterilerin bir aktarıcıya ihtiyaç duyması gibi sonuçları ve reddedilen alternatif olan IP izin listesini sıralar. ADR, günlükte proposed olarak görünür.
Sınırlar
- Kararı ancak kendisinden önceki analiz kadar iyidir. Kendi başına güvenlik araştırması eklemez.
- Yalnızca Threat Model iş akışında çalışır. Architecture Debate ve Discovery & Spec de önerilen ADR'ler kaydeder; ancak bunlar bu ajandan değil, Architect'in nihai sentezinden ve Product Analyst'in gereksinimlerinden gelir.
- Kararın uygulanıp uygulanmadığını kontrol etmez.
Sık sorulan sorular
Ajanın yazdığı bir ADR otomatik olarak kabul edilir mi?
Hayır. proposed durumuyla kaydedilir. Elle yazılmış bir ADR'de olduğu gibi, çalışma alanındaki bir kişi onu kabul eder veya reddeder.
Aynı Threat Model oturumunu yeniden çalıştırırsam ne olur?
ADR'nin kimliği oturumdan gelir; bu yüzden o oturumun yeniden çalıştırılması, bir kopya eklemek yerine oturumun ADR'sini günceller.