15.6 Dokumentasi sebagai Jembatan antara Manusia dan AI

Seorang arsitek yang saya kenal pernah mendapatkan tugas mengevaluasi ulang arsitektur sistem yang sudah berjalan tiga tahun. Ia datang dengan semangat. Ia punya akses ke kode, dokumen teknis, dan tim engineer. Tapi begitu ia mulai membaca dokumentasi yang ada, ia menemukan masalah besar. Dokumentasi arsitektur hanya berisi diagram yang sudah kedaluwarsa. Keputusan desain tidak tercatat. Alasan mengapa tim memilih PostgreSQL bukan MongoDB tidak ada di mana pun. Yang ada hanya hasil akhir: “Kami pakai PostgreSQL.” Tidak ada konteks mengapa, apa trade-off yang dipertimbangkan, dan constraint apa yang mendorong keputusan itu.

Ia akhirnya harus mewawancarai satu per satu engineer yang tersisa. Dua orang sudah pindah proyek. Satu orang tidak ingat detailnya. Butuh waktu berminggu-minggu untuk merekonstruksi alasan di balik setiap keputusan. Padahal, jika dokumentasi ditulis dengan baik sejak awal, pekerjaan itu bisa selesai dalam hitungan jam.

Dokumentasi sering dianggap sebagai arsip. Sesuatu yang ditulis setelah pekerjaan selesai, lalu disimpan dan tidak pernah dibaca lagi. Tapi di era AI, dokumentasi memiliki fungsi yang jauh lebih penting. Dokumentasi adalah jembatan antara manusia dan AI. Dengan dokumentasi yang baik, AI bisa memahami konteks, constraint, dan evidence yang sudah dikumpulkan manusia. AI tidak perlu menebak-nebab atau membuat asumsi sendiri. Ia bisa bekerja berdasarkan pengetahuan yang sudah terekam.

Bayangkan Anda memiliki basis pengetahuan yang berisi semua keputusan arsitektur yang pernah diambil: mengapa tim memilih pendekatan A, constraint apa yang membatasi, evidence apa yang mendukung, dan apa hasilnya setelah berjalan setahun. Ketika Anda meminta AI mengevaluasi opsi baru, Anda cukup memberikan akses ke basis pengetahuan itu. AI akan membaca riwayat keputusan, memahami pola, dan memberikan rekomendasi yang konsisten dengan pengalaman organisasi Anda. Tanpa basis pengetahuan, AI hanya punya pengetahuan umum dari internet. Ia tidak tahu bahwa organisasi Anda pernah gagal dengan microservices, atau bahwa tim Anda memiliki keterbatasan skill di bahasa pemrograman tertentu.

Diagram berikut memperjelas perbedaan dampak dokumentasi buruk dan dokumentasi baik terhadap kemampuan AI dan manusia dalam mengevaluasi keputusan arsitektur.

flowchart TD A[Keputusan Arsitektur] --> B{Dokumentasi?} B -->|Buruk| C[Konteks hilang] C --> D[Rekonstruksi manual] D --> E[Waktu lama / tidak akurat] B -->|Baik| F[ADR sebagai pusat jembatan] F --> G[Konteks, constraint, evidence terekam] G --> H[AI bisa akses] G --> I[Manusia bisa review cepat] H --> J[Evaluasi cepat & konsisten] I --> J J --> K[Keputusan baru lebih baik]

Dokumentasi yang baik juga mempercepat review manusia. Ketika seorang arsitek senior diminta mengevaluasi usulan solusi, ia tidak perlu membaca ulang seluruh konteks dari awal. Ia cukup melihat dokumentasi yang terstruktur: apa masalahnya, constraint apa yang diberikan, opsi apa yang dibandingkan, evidence apa yang dikumpulkan, dan keputusan apa yang diambil. Semua informasi tersaji dalam format yang bisa dibaca manusia dan AI secara bersamaan.

Inilah yang disebut single source of truth. Satu tempat yang menjadi rujukan utama untuk setiap keputusan arsitektur. Bukan dokumen yang tersebar di email, chat, slide presentasi, dan catatan pribadi. Tetapi satu basis pengetahuan yang selalu diperbarui setiap kali keputusan diambil.

Tentu, dokumentasi membutuhkan investasi waktu. Tapi investasi itu terbayar berkali-kali lipat ketika AI bisa bekerja lebih konsisten, review lebih cepat, dan keputusan tidak perlu direkonstruksi dari nol setiap kali ada anggota tim baru atau AI yang perlu dilibatkan.

Setelah dokumentasi tersedia, langkah selanjutnya adalah memastikan bahwa keputusan akhir tetap berada di tangan manusia. AI bisa memberikan rekomendasi berdasarkan konteks, constraint, dan evidence yang terdokumentasi. Tapi keputusan yang menyentuh manusia, organisasi, uang, data, compliance, dan reputasi tetap perlu dipimpin oleh manusia.