yazılım-mimari-rehberleri

SKILL.md

---
name: yazılım-mimari-rehberleri
description: Sistem sınırları, kalite gereksinimleri, iletişim, stiller, kararlar, riskler veya evrim analiz edilirken bağlamsal yazılım mimarisi rehberliği uygulayın.
---

# Yazılım Mimari Rehberi

Bu taşınabilir taslağı, yazılım alanları genelinde mimari çalışmaları desteklemek için kullanın. Küresel olarak kurulmaz. Kitap kavramlar ve ödünleşmeler sunar; bu rehber bunları koşullu kontroller olarak işler. Bunlar proje komutları veya kullanıcı niyeti, yerel yönetişim ya da bilinen sistem kanıtlarının yerine geçmez.

## İş Akışı

1. **Bağlamı ve yetkiyi belirleyin.** Alanı, sistem sınırını, iş sonuçlarını, dağıtım ve veri kısıtlamalarını, ekip yeteneklerini, bilinen kanıtları, bilinmeyenleri ve karar yetkisini tanımlayın. Zaten devredilmiş yetkiye saygı gösterin. Sonucu değiştirebilecek eksik gerçekleri sorun; aksi takdirde koşullu bir öneri verin.
2. **Sürücüleri sıralayın.** Paydaş sonuçlarını mimari özelliklere çevirin. Her adayı üç parçalı tanıma karşı test edin, bileşik nitelikleri ayrıştırın ve küçük bir seti önceliklendirin.
3. **Sınırları ve veriyi haritalayın.** Her ilgili sınırda işlevsel sorumlulukları, bağımlılıkları, işlemleri, veri sahipliğini, statik bağlamayı, çalışma zamanı çağrılarını ve özellikleri belirleyin.
4. **Orantılı karşılaştırma yapın.** Önemli bir seçim için, en az iki uygulanabilir seçeneği belirtilen önceliklere, maliyetlere, risklere ve kanıtlara karşı karşılaştırın. Küçük, geri alınabilir bir değişiklik için resmi karşılaştırma zorlamayın.
5. **Gerekçeyle karar verin.** Öneriyi veya durumu, neden uyduğunu, kabul edilen maliyetleri, varsayımları ve hangi kanıtın yeniden değerlendirmeye yol açacağını belirtin. Devredilmiş yetkiye uyun; onay kapıları icat etmeyin.
6. **Kontrolleri belirtin.** Riski orantılı ölçümler veya uygunluk fonksiyonları seçin. Kapsamlarını, sinyallerini, sınırlamalarını ve yanıtlarını adlandırın.

## Temel kurallar

- Önerileri bağlamda temellendirin ([bağlam ve öncelik kuralları](references/rulebook.md#context-priorities): F01) ve devredilmiş yetkiye saygı gösterin ([karar, risk ve evrim kuralları](references/rulebook.md#decisions-risk-evolution): D03).
- Ölçülebilir paydaş sonuçlarından özellikler türetin ve sıralayın ([bağlam ve öncelik kuralları](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Sorumlulukları uyumlu tutun ve sınırları bağımlılıklar ve bağlama konusunda dürüst tutun ([sınır kuralları](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [sözlük](references/glossary.md)).
- İletişimi işe göre seçin; istek, komut ve olayı ayırt edin ve hata için tasarlayın ([iletişim kuralları](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Mimari stilleri koşullu seçenekler olarak ele alın ve maliyetlerini karşılaştırın ([stil kuralları](references/rulebook.md#style-choice): S01, S16, D06; [stil rehberi](references/style-selection.md)).
- Önemli kararların neden var olduğunu ve neyin değiştireceğini kaydedin ([ödünleşmeler](references/rulebook.md#context-priorities): F02; [karar kayıtları](references/rulebook.md#decisions-risk-evolution): F03).
- Risk, belirsizlik ve uygulama uyumunu görünür kılın ([risk ve evrim kuralları](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- İnsanların anlayacağı kontrollerle önemli kısıtlamaları yönetin ([yönetişim kuralları](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Gerçek yetki ve kısıtlamalar içinde ekip seçimini koruyun ([ekip ve iletişim kuralları](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Proje bir model sağlayıcı içeriyorsa sağlayıcıya özgü rehberliği uygulayın ([D15 in rules.json](references/rules.json)).

## Çıktı sözleşmesi

Dönüş: bağlam ve bilinmeyenler; öneri ve durum; alternatifler ve maliyetler; sınır, veri ve iletişim etkileri; kanıtlar ve kontroller; ve yeniden değerlendirme tetikleyicisi. Ayrıntıyı seçimin sonucuna göre ölçeklendirin.

## Referanslar

Bir görev için, yalnızca ilgili kategoriyi [rules.json](references/rules.json) içinde yükleyin veya tamamını ya da tüm paketi değil, [rulebook.md](references/rulebook.md) içindeki bölümünü okuyun. Dokuz stil için [style-selection.md](references/style-selection.md), kaynak bazlı terimler için [glossary.md](references/glossary.md) ve atıf yapılan bölümleri bulmak için [source-map.json](references/source-map.json) yükleyin. Sentetik değerlendirme istemleri [evaluation-cases.json](references/evaluation-cases.json) içindedir; henüz çalıştırılmamıştır. Yöntem ve sınırlamalar [method-and-validation.md](references/method-and-validation.md) içindedir.