Bikin SOP Anti-Gagal: Gunakan Claude Code untuk Dokumentasi Infrastruktur Secara Otomatis

Bagi seorang Mail System Engineer atau DevOps, SOP adalah harga mati. Bayangkan saat terjadi insiden di server produksi pada jam 2 pagi, tapi teknisi yang bertugas tidak tahu cara restore database karena dokumennya sudah “basi” atau langkah-langkahnya tidak lengkap. Masalahnya, menulis SOP itu memakan waktu dan seringkali apa yang tertulis di dokumen berbeda dengan apa yang ada di terminal.

Di sinilah Claude Code berperan sebagai jembatan. Kita bisa menyuruhnya untuk mengamati apa yang kita kerjakan di terminal, lalu menyusunnya menjadi dokumen SOP yang rapi dan siap pakai.

1. Dokumentasi “Live” dari Terminal ke Markdown

Daripada kalian mengetik ulang perintah satu per satu ke dalam Word, kalian bisa menyuruh Claude untuk mendokumentasikan langkah-langkah yang baru saja kalian lakukan.

Contoh Kasus: Kalian baru saja melakukan konfigurasi SSL di server Carbonio. Prompt ke Claude:

“Claude, saya baru saja selesai setup SSL Certificate untuk Carbonio di server ini. Tolong catat langkah-langkah yang saya lakukan, mulai dari lokasi file sertifikatnya hingga perintah restart service-nya, lalu buatkan file SOP-SSL-Carbonio.md di folder /docs.”

Claude akan membaca history perintah dan perubahan file yang terjadi, lalu menyusunnya menjadi dokumen teknis yang akurat sesuai kondisi nyata di server kalian.

2. Validasi SOP: Memastikan Dokumen Bukan Sekadar Teori

Seringkali SOP dibuat tapi saat dijalankan ternyata ada langkah yang kurang. Claude Code bisa kita suruh untuk menjadi “Quality Assurance” bagi dokumen kita sendiri.

Prompt:

“Claude, tolong baca file SOP-Disaster-Recovery.md ini. Coba cek apakah semua perintah bash di dalamnya valid untuk OS Ubuntu 24.04 yang kita pakai sekarang. Jika ada perintah yang sudah deprecated, tolong berikan sarannya.”

3. Otomasi Penjelasan Parameter (The “Technical Translator”)

Kadang kita punya script automasi (misal Ansible Playbook untuk instalasi mail server) yang sangat kompleks. Menjelaskan isi script tersebut ke anggota tim baru bisa memakan waktu seharian.

Gunakan Claude Code untuk membedah script tersebut: Prompt:

“Tolong buatkan tabel penjelasan untuk setiap variabel di file group_vars/all.yml ini. Jelaskan fungsi masing-masing parameter agar mudah dipahami oleh junior admin.”

Pro-Tip: Integrasi ke SOP Hub Kalian

Jika kalian sedang membangun aplikasi SOP Hub, kalian bisa memanfaatkan Claude Code untuk menghasilkan output dalam format JSON atau Markdown yang sudah terstruktur. Jadi, kalian tinggal copy-paste atau kirim filenya ke sistem database kalian tanpa perlu formatting ulang.

Instruksi /init Tambahan:

“Setiap kali saya meminta pembuatan dokumen, gunakan format Markdown dengan header yang jelas, sertakan blok kode untuk setiap perintah terminal, dan berikan label ‘Tested’ jika perintah tersebut sudah berhasil dijalankan di sesi ini.”

Kesimpulan

Menulis dokumentasi tidak lagi harus menjadi beban di akhir proyek. Dengan bantuan Claude Code, dokumentasi lahir bersamaan dengan kodingan dan konfigurasi yang kalian buat. Hasilnya? SOP yang selalu update, akurat, dan yang paling penting: Bisa diandalkan saat kondisi darurat.

Leave a Reply

Your email address will not be published. Required fields are marked *