Conventional Commits: Tips Commit Message Rapi

Diperbaharui 15 November 2026 2:49 PM

Conventional Commits adalah konvensi penulisan commit message yang membagi pesan jadi tiga bagian: tipe, deskripsi singkat, dan body opsional. Bagi yang sehari-hari ngoding sendiri, aturan ini kelihatan seperti formalitas. Tapi begitu repo dipakai bareng, atau kamu balik lagi ke proyek enam bulan lalu, riwayat Git yang rapi itu beda banget rasanya dengan tumpukan commit berisi “update”, “fix bug”, dan “revisi lagi”.

Artikel ini membahas cara pakai Conventional Commits tanpa bikin alur kerja jadi ribet: formatnya, tipe yang benar-benar dipakai, lalu cara menegakkannya otomatis pakai commitlint dan husky supaya kesalahan format ketahuan sebelum commit masuk. Semua versi dan perintah di sini dicek langsung dari dokumentasi resmi.

Kenapa commit message berantakan bikin repot

Riwayat Git dibaca tiga pihak: kamu saat git bisect, rekan tim saat review, dan tooling changelog. Semuanya butuh satu informasi di posisi yang mudah diprediksi: ini perubahan jenis apa.

Kalau tipe perubahan ditulis bebas, changelog harus disusun manual. Kalau tidak ada penanda perubahan yang memutuskan kompatibilitas, nomor versi jadi tebakan. Conventional Commits menutup dua celah itu dengan satu kebiasaan kecil di awal pesan.

Perlu dicatat: ini bukan standar resmi Git dan tidak mengubah isi commit. Dia kesepakatan soal bentuk pesan — dan karena bentuknya konsisten, alat lain bisa membacanya.

Format dasar Conventional Commits

Spesifikasi versi 1.0.0 menyebut satu bentuk baku: tipe, scope opsional di dalam tanda kurung, tanda seru opsional untuk breaking change, lalu titik dua dan spasi, baru deskripsi. Body dan footer sifatnya opsional, dipisah satu baris kosong dari deskripsi.

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Contoh nyata di proyek Laravel, misalnya menambah validasi baru di form pendaftaran:

feat(register): validasi nomor HP format internasional

Nomor yang diawali +62 dinormalisasi ke 0 sebelum disimpan,
supaya pengecekan duplikat tidak meleset.

Deskripsi adalah ringkasan satu baris. Alasan perubahan taruh di body, bukan di judul yang terpotong di git log --oneline.

Tipe commit yang sering dipakai

Spesifikasi hanya mewajibkan dua tipe punya makna khusus: fix untuk perbaikan bug dan feat untuk fitur baru. Keduanya terikat ke Semantic Versioning — fix setara kenaikan PATCH, feat setara MINOR. Tipe lain bebas, dan config @commitlint/config-conventional merekomendasikan daftar berikut:

  • feat — fitur baru yang terlihat oleh pengguna
  • fix — perbaikan bug
  • docs — perubahan dokumentasi atau komentar README
  • style — format kode, spasi, titik koma; tidak mengubah logika
  • refactor — merapikan struktur tanpa mengubah perilaku
  • perf — peningkatan performa
  • test — menambah atau memperbaiki test
  • build — dependency, konfigurasi build, versi paket
  • ci — skrip dan konfigurasi CI
  • chore — pekerjaan rutin lain yang tidak masuk kategori di atas
  • revert — membatalkan commit sebelumnya

Beda fix dan refactor? Kalau ada perilaku yang berubah jadi benar, itu fix; kalau hasil dari sisi pengguna sama saja, itu refactor. Menyentuh dependency atau skrip build? Pilih build.

Scope dan breaking change

Scope adalah kata benda dalam tanda kurung yang menjelaskan bagian kode: feat(auth), fix(invoice). Pakai hanya kalau membantu; repo kecil tidak perlu scope di setiap commit.

Breaking change ditandai dua cara yang boleh dipilih salah satu: tambahkan ! setelah tipe atau scope, atau tulis footer BREAKING CHANGE: diikuti penjelasan. Menurut spesifikasi, commit dengan salah satu penanda itu setara kenaikan MAJOR di Semantic Versioning.

feat(api)!: hapus endpoint /v1/login lama

BREAKING CHANGE: klien versi 1 harus pindah ke /v2/auth/token.
Endpoint lama dihapus setelah 30 hari masa transisi.

! berguna agar perubahan besar langsung terlihat di riwayat singkat; footer cocok untuk menjelaskan dampaknya. Keduanya boleh dipakai bersamaan.

Memasang commitlint dengan husky

Aturan yang cuma dihafal manusia pasti bocor. commitlint memeriksa pesan otomatis, husky menjalankannya lewat hook commit-msg — bukan pre-commit, karena pesannya baru tersedia di tahap itu.

npm install -D @commitlint/cli @commitlint/config-conventional
npm install --save-dev husky
npx husky init
echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg

Perintah npx husky init membuat folder .husky/ dan menambahkan skrip prepare di package.json, jadi hook ikut terpasang setiap kali dependency di-install di mesin lain. Setelah hook aktif, commit dengan tipe tidak dikenal akan ditolak sebelum tersimpan.

Soal versi: commitlint saat ini 21.2.4 dan butuh Node minimal 22.12, sedangkan husky 9.1.7 cukup Node 18. Kalau CI kamu masih Node 18, pakai commitlint versi lama daripada memaksa upgrade.

Di proyek Laravel tidak ada penyesuaian khusus: selama ada package.json (hampir semua proyek modern punya karena Vite), perintah di atas jalan apa adanya. Menyiapkan Node dari nol? Lihat persiapan web developer Laravel.

Mengatur aturan yang lebih ketat

Konfigurasi paling singkat cukup satu file di root proyek. Isinya mewarisi aturan conventional lalu menimpa beberapa nilai sesuai kebiasaan tim:

export default {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'header-max-length': [2, 'always', 72],
    'subject-full-stop': [2, 'never', '.'],
    'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'refactor', 'perf', 'test', 'build', 'ci', 'chore']],
    'scope-empty': [1, 'never'],
  },
};

Angka pertama di setiap rule adalah level: 0 mematikan, 1 memberi peringatan, 2 menggagalkan commit. Nilai bawaan config-conventional sudah membatasi header maksimal 72 karakter, melarang subjek diakhiri titik, dan menolak subjek bergaya Sentence case — tiga aturan yang paling sering bikin commit message terlihat tidak konsisten.

Daftar di atas menghapus style dan revert — banyak tim menggabungkan style ke refactor. Sesuaikan saja, yang penting disepakati sekali dan tidak berubah tiap minggu.

Menguji tanpa harus commit

Mengetes aturan tidak perlu membuat commit asli. commitlint bisa menerima pesan dari stdin, dan punya konfigurasi bawaan yang bisa dipakai sebelum file konfigurasi dibuat:

echo "feat: tambah filter pencarian" | npx commitlint --default-config
echo "update file" | npx commitlint --default-config
npx commitlint --from HEAD~1 --to HEAD --verbose

Baris pertama lolos tanpa output, baris kedua gagal dengan pesan bahwa tipe update tidak dikenal. Perintah ketiga memeriksa rentang commit yang sudah ada — berguna saat mau menerapkan aturan ke repo lama: jalankan dulu, lihat berapa banyak yang melanggar, baru putuskan apakah perlu memperbaiki riwayat atau cukup berlaku untuk commit berikutnya.

Kebiasaan kecil yang bikin riwayat enak dibaca

Beberapa hal yang tidak diatur tooling, tapi pengaruhnya besar:

  • Tulis deskripsi sebagai perintah: “tambah validasi”, bukan “menambahkan validasi” atau “validasi ditambahkan”.
  • Satu commit satu tujuan. Kalau pesannya butuh kata “dan” dua kali, kemungkinan besar itu dua commit yang digabung.
  • Jangan campur perubahan format dengan perubahan logika — reviewer akan kesulitan memisahkan mana yang benar-benar mengubah perilaku.
  • Sebut nomor issue di footer (Refs: #123), bukan di judul yang ruangnya terbatas.

Kalau sering berpindah branch untuk pekerjaan yang berbeda, menggabungkan disiplin commit dengan git worktree membuat tiap perubahan punya konteks yang jelas. Riwayat rapi bukan hasil satu kali kerja, tapi efek samping dari kebiasaan yang konsisten.

Untuk menyusun changelog, riwayat yang sudah bertipe bisa disaring tanpa tool tambahan:

git log --oneline --grep="^feat" v1.2.0..HEAD
git log --pretty="%s" v1.2.0..HEAD | grep -E "^(fix|perf):"

Kapan tidak perlu Conventional Commits

Konvensi ini paling berguna untuk proyek yang punya siklus rilis, changelog, atau lebih dari satu kontributor. Untuk repo eksperimen pribadi, skrip sekali pakai, atau proyek yang tidak pernah dirilis dengan nomor versi, menambah commitlint justru menambah satu lapisan yang harus dirawat — terutama saat Node naik versi dan commitlint ikut menuntut versi minimum baru.

Jangan langsung mengaktifkan semua aturan di level 2. Mulai dari tipe dan panjang header; aturan yang terlalu ketat di awal biasanya berakhir dimatikan total.

Pertanyaan yang sering muncul

Apakah commit lama harus diperbaiki?

Tidak. Menulis ulang history memaksa semua orang menarik ulang branch. Terapkan aturan untuk commit baru; changelog versi lama susun manual sekali saja.

Bagaimana kalau commit dibuat lewat GitHub web atau merge otomatis?

Hook husky hanya jalan di mesin lokal, jadi commit dari antarmuka web tidak melewatinya. Solusinya tambahkan pemeriksaan yang sama di CI dengan menjalankan npx commitlint --from <base> --to <head>, supaya celah itu tertutup tanpa bergantung pada disiplin masing-masing orang.

Boleh pakai bahasa Indonesia di deskripsi?

Boleh, dan banyak tim Indonesia melakukannya. Yang diatur konvensi cuma tipe dan strukturnya, bukan bahasanya. Yang perlu dijaga: konsisten. Mencampur “add validation” dan “tambah validasi” dalam satu repo membuat pencarian di riwayat jadi tidak bisa diandalkan.

Kesimpulan

Conventional Commits bukan aturan birokrasi, tapi cara membuat riwayat Git bisa dibaca mesin sekaligus manusia. Mulai dari dua tipe wajib (feat dan fix), tambahkan scope hanya kalau perlu, lalu tegakkan dengan commitlint lewat hook commit-msg. Sisanya kebiasaan: satu commit satu tujuan, deskripsi ringkas, dan detail penjelasan di body.

Langkah realistis hari ini: pasang hook di satu repo yang paling sering kamu sentuh, jalankan sebulan, lalu evaluasi. Kalau mengganggu tanpa manfaat, longgarkan — konvensi dibuat untuk mempermudah.

Referensi

susantokun avatar
susantokun
Hanya seorang programmer yang fokus di bidang web development. Tidak nyaman dengan keramaian dan suka akan keindahan.
Kebijakan Berkomentar :
1. Dilarang berkomentar yang mengandung SPAM, SARA, HOAX, PORNO.2. Mohon sertakan informasi detail saat terjadi error (pesan error, sreenshoot, code, logs, dsb.).