23.7 Dokumen Pendek yang Menjaga Alignment
Anda baru saja menyelesaikan sesi diskusi yang panjang. Diagram sudah digambar, opsi sudah dijelaskan, dan keputusan sudah diambil. Semua orang mengangguk setuju di ruangan itu. Anda pulang dengan perasaan lega.
Tiga minggu kemudian, Anda melihat tim engineer mengerjakan sesuatu yang berbeda dari yang Anda ingat. Anda bertanya, "Kenapa pakai pendekatan ini?" Mereka menjawab, "Kami pikir itu yang diputuskan." Product manager di sisi lain punya ingatan yang lain lagi. Tiba-tiba, alignment yang terasa solid di ruang rapat mulai retak.
Inilah masalah yang tidak pernah diatasi oleh diagram dan komunikasi lisan saja. Ingatan manusia tidak sempurna. Orang yang tidak hadir di rapat tidak mendapat konteks yang sama. Dan yang paling berbahaya, ketika keputusan diambil tetapi tidak dicatat, setiap orang bisa merasa versinya kesepakatan yang berbeda.
Kebutuhan di sini bukanlah dokumentasi tebal yang menjelaskan setiap detail teknis. Kebutuhan yang sebenarnya adalah catatan keputusan yang ringkas, sehingga siapa pun yang membacanya bisa langsung paham apa yang diputuskan, kenapa, dan apa konsekuensinya. Inilah yang disebut sebagai lightweight alignment document, atau dalam praktik arsitektur sering disebut Architecture Decision Record.
Dokumen ini tidak perlu panjang. Cukup beberapa bagian inti. Pertama, konteks singkat tentang masalah yang dihadapi dan opsi yang dipertimbangkan. Kedua, keputusan yang diambil secara eksplisit, bukan tersirat. Ketiga, alasan di balik keputusan itu, termasuk trade-off yang dikorbankan. Keempat, konsekuensi yang perlu diantisipasi, baik teknis maupun organisasi.
Berikut adalah diagram alur yang merangkum empat bagian inti dari Architecture Decision Record:
Bayangkan Anda menulis: "Kami memilih opsi B untuk fitur dashboard sales karena waktu implementasi lebih cepat dua minggu, meskipun biaya infrastruktur naik dua puluh persen. Konsekuensinya, tim infrastruktur perlu menyiapkan tambahan kapasitas server sebelum bulan depan." Kalimat ini sudah cukup untuk menjaga alignment. Tidak perlu dua puluh halaman.
Berikut adalah template ADR yang bisa Anda salin dan isi setelah setiap keputusan arsitektural:
# ADR-001: Pilihan Opsi B untuk Dashboard Sales
## Konteks
Kami perlu membangun dashboard sales yang bisa diakses real-time. Dua opsi dipertimbangkan:
- Opsi A: gunakan database relasional yang sudah ada
- Opsi B: gunakan layanan streaming terpisah
## Keputusan
Kami memilih Opsi B.
## Alasan
Waktu implementasi lebih cepat dua minggu, meskipun biaya infrastruktur naik 20%.
## Konsekuensi
- Tim infrastruktur perlu menyiapkan tambahan kapasitas server sebelum bulan depan.
- Perlu pelatihan singkat untuk tim backend tentang pipeline streaming.
Yang membuat dokumen pendek ini efektif bukan karena formatnya, tetapi karena dokumen ini menjadi sumber kebenaran bersama. Ketika ada perbedaan interpretasi, tim bisa kembali ke catatan ini. Ketika anggota baru bergabung, mereka bisa membaca konteks keputusan tanpa harus mengulang diskusi panjang. Ketika audit atau review dilakukan, ada jejak yang jelas.
Dokumen ini juga membantu arsitek membangun kepercayaan. Ketika Anda secara konsisten mencatat keputusan dengan alasan yang jelas, orang mulai melihat bahwa Anda tidak asal memilih. Anda mempertimbangkan trade-off. Anda memikirkan konsekuensi. Ini adalah bukti nyata dari cara berpikir strategis, bukan sekadar pernyataan.
Tantangan terbesar bukanlah menulis dokumen ini, tetapi menjadikannya kebiasaan. Banyak tim tergoda untuk langsung ke implementasi setelah rapat selesai. Mereka merasa menulis dokumentasi hanya membuang waktu. Padahal, waktu yang dihabiskan untuk menulis sepuluh menit sekarang bisa menghemat berjam-jam kebingungan di kemudian hari.
Mulailah dengan sederhana. Setelah setiap keputusan arsitektural, buka dokumen kosong, tulis konteks, keputusan, alasan, dan konsekuensi. Simpan di tempat yang mudah diakses semua orang. Jangan menunggu sampai sempurna. Dokumen yang ditulis sekarang, meskipun masih kasar, lebih berharga daripada dokumen sempurna yang tidak pernah selesai.
Ketika tim sudah terbiasa melihat catatan keputusan yang ringkas dan jelas, mereka tidak akan lagi bertanya, "Kita sepakat apa kemarin?" Mereka akan langsung membuka dokumen dan berkata, "Ini yang kita putuskan, ini alasannya." Alignment tidak lagi bergantung pada ingatan siapa pun. Alignment ada di dokumen yang bisa diakses kapan saja.
Dari sini, kita bisa melihat bahwa kepercayaan tidak dibangun dari jabatan atau gelar. Kepercayaan lahir dari kejelasan berpikir, bukti yang bisa diperiksa, dan konsistensi dalam membantu keputusan. Itu menjadi arah pembahasan berikutnya: bagaimana kepercayaan itu dibangun dan dijaga dalam peran arsitek.
