panduan-arsitektur-perangkat-lunak

SKILL.md

---
name: panduan-arsitektur-perangkat-lunak
description: Terapkan panduan arsitektur perangkat lunak kontekstual saat menganalisis batas sistem, persyaratan kualitas, komunikasi, gaya, keputusan, risiko, atau evolusi.
---

# Pedoman Arsitektur Perangkat Lunak

Gunakan draf portabel ini untuk mendukung pekerjaan arsitektur di berbagai domain perangkat lunak. Ini tidak diinstal secara global. Buku ini menyediakan konsep dan pertukaran; panduan ini mengoperasionalkan mereka sebagai pemeriksaan bersyarat. Mereka bukan perintah proyek atau pengganti niat pengguna, tata kelola lokal, atau bukti sistem yang diketahui.

## Alur Kerja

1. **Tetapkan konteks dan otoritas.** Identifikasi domain, batas sistem, hasil bisnis, kendala penyebaran dan data, kemampuan tim, bukti yang diketahui, hal yang tidak diketahui, dan otoritas pengambilan keputusan. Hormati otoritas yang sudah didelegasikan. Tanyakan hanya fakta yang hilang yang dapat mengubah hasil; jika tidak, berikan rekomendasi bersyarat.
2. **Peringkat penggerak.** Terjemahkan hasil pemangku kepentingan menjadi karakteristik arsitektural. Uji setiap kandidat terhadap definisi tiga bagian, uraikan kualitas komposit, dan prioritaskan sejumlah kecil.
3. **Peta batas dan data.** Identifikasi tanggung jawab fungsional, ketergantungan, transaksi, kepemilikan data, kopling statis, panggilan runtime, dan karakteristik di setiap batas yang relevan.
4. **Bandingkan secara proporsional.** Untuk pilihan yang berdampak, bandingkan setidaknya dua opsi yang layak terhadap prioritas, biaya, risiko, dan bukti yang dinyatakan. Jangan memaksa perbandingan formal untuk perubahan kecil yang dapat dibalik.
5. **Putuskan dengan alasan.** Nyatakan rekomendasi atau status, mengapa itu cocok, biaya yang diterima, asumsi, dan bukti apa yang akan menyebabkan pertimbangan ulang. Ikuti otoritas yang didelegasikan; jangan membuat gerbang persetujuan.
6. **Spesifikasikan pemeriksaan.** Pilih ukuran atau fungsi kecocokan yang proporsional dengan risiko. Sebutkan ruang lingkup, sinyal, keterbatasan, dan responsnya.

## Aturan inti

- Dasarkan rekomendasi pada konteks ([aturan konteks dan prioritas](references/rulebook.md#context-priorities): F01) dan hormati otoritas yang didelegasikan ([aturan keputusan, risiko, dan evolusi](references/rulebook.md#decisions-risk-evolution): D03).
- Turunkan dan peringkat karakteristik dari hasil pemangku kepentingan yang dapat diukur ([aturan konteks dan prioritas](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Jaga tanggung jawab tetap kohesif dan batas jujur tentang ketergantungan dan kopling ([aturan batas](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [glosarium](references/glossary.md)).
- Pilih komunikasi untuk pekerjaan; bedakan permintaan, perintah, dan peristiwa, serta rancang untuk kegagalan ([aturan komunikasi](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Perlakukan gaya arsitektur sebagai opsi bersyarat dan bandingkan biayanya ([aturan gaya](references/rulebook.md#style-choice): S01, S16, D06; [panduan gaya](references/style-selection.md)).
- Catat mengapa keputusan berdampak ada dan apa yang akan mengubahnya ([pertukaran](references/rulebook.md#context-priorities): F02; [catatan keputusan](references/rulebook.md#decisions-risk-evolution): F03).
- Buat risiko, ketidakpastian, dan keselarasan implementasi terlihat ([aturan risiko dan evolusi](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- Kelola kendala penting dengan pemeriksaan yang dipahami orang ([aturan tata kelola](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Pertahankan pilihan tim dalam otoritas dan kendala yang sebenarnya ([aturan tim dan komunikasi](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Terapkan panduan khusus penyedia hanya ketika proyek mencakup penyedia model ([D15 dalam rules.json](references/rules.json)).

## Kontrak keluaran

Kembalikan: konteks dan hal yang tidak diketahui; rekomendasi dan status; alternatif dan biaya; implikasi batas, data, dan komunikasi; bukti dan pemeriksaan; serta pemicu pertimbangan ulang. Sesuaikan detail dengan konsekuensi pilihan.

## Referensi

Untuk sebuah tugas, muat hanya kategori yang relevan dalam [rules.json](references/rules.json) atau baca bagiannya di [rulebook.md](references/rulebook.md), bukan keduanya atau seluruh paket. Muat [style-selection.md](references/style-selection.md) untuk sembilan gaya, [glossary.md](references/glossary.md) untuk istilah berbasis sumber, dan [source-map.json](references/source-map.json) untuk menemukan bab yang dikutip. Prompt evaluasi sintetis ada di [evaluation-cases.json](references/evaluation-cases.json); mereka belum dijalankan. Metode dan keterbatasan ada di [method-and-validation.md](references/method-and-validation.md).