Konvensi commit

Referensi kanonik untuk pesan commit git, tag rilis, dan disiplin kepengarangan. Ringkasan di CLAUDE.md Konvensi adalah deklarasi inline; halaman ini adalah referensi mandiri yang dikutip kontributor hilir.

---

1. Conventional CommitsCopy Anchor Link

Subjek commit mengikuti bentuk Conventional Commits: <type>(<scope>): <subject>. Himpunan tertutup <type> adalah {feat, fix, chore, docs, refactor, test, perf, ci, build, style, revert, release}. <scope> adalah permukaan yang disentuh commit (mis., feat(conformity), docs(adr), fix(ci)); scope dihilangkan hanya untuk perubahan lintas-bidang yang tidak terlokalisasi.

Subjek bermodus imperatif, huruf kecil setelah titik dua type/scope, tanpa titik di akhir, dan kurang dari 72 karakter. Body — dipisahkan dari subjek oleh satu baris kosong — menjelaskan mengapa perubahan itu ada, bukan apa yang diubah diff; diff itu sendiri adalah catatan kanonik tentang apa.

2. Disiplin kepengarangan (khusus-manusia)Copy Anchor Link

Setiap permukaan kepengarangan di setiap artefak git (subjek commit, body commit, bidang Author:, trailer Co-Authored-By:, trailer Signed-off-by:, nama branch, nama tag, anotasi tag, nama stash, body git-notes, judul PR, deskripsi PR) menamai hanya kontributor manusia. Harness tidak pernah mengatribusikan dirinya sendiri, model bahasa yang mendasarinya, runtime / lingkungan / IDE / ekstensi / vendor, atau alat otomatis lainnya, ke salah satu permukaan tersebut. Pola yang dilarang mencakup Co-Authored-By: <model-name>, Co-Authored-By: <noreply@*-vendor.com>, narasi body seperti generated with X atau co-authored by an automated helper, dan setiap penanda baris-subjek yang menandakan kepengarangan non-manusia. Spesifikasi lengkap berada di src/apothem/rules/production-ready-prs.md §6; penegakan mekanis berada di src/apothem/hooks/messages/pretooluse-bash.md Scan 3.

3. Tag rilis (Semantic Versioning)Copy Anchor Link

Tag rilis mengikuti Semantic Versioning (vMAJOR.MINOR.PATCH). Perubahan yang merusak menaikkan MAJOR, penambahan yang kompatibel ke belakang menaikkan MINOR, dan perbaikan bug menaikkan PATCH. Tag dianotasi (git tag -a) dan ditandatangani pada tingkat publikasi sesuai site/content/docs/governance/release-engineering-policy.mdx. Versi paket berada di manifes sumber (pyproject.toml version), dan permukaan runtime / pembawa-versi diturunkan dari metadata paket tersebut.

4. Kadensi per-tugasCopy Anchor Link

Commit dilakukan per-tugas pada keseriusan SHARED+, per-fase pada PERSONAL_USE, dan opsional pada EXPLORING. Commit suatu tugas dilakukan segera setelah gerbang verifikasi tugas lolos; commit yang ditunda menumpuk konteks dan berisiko kehilangan cakupan. Disiplin lengkap berada di src/apothem/rules/operational-mandates.md §CM-13.

5. ValidatorCopy Anchor Link

Rantai hook pre-commit di .pre-commit-config.yaml menegakkan gerbang kualitas per-tulis. Penegakan disiplin kepengarangan di hook bash (Scan 3 dari src/apothem/hooks/messages/pretooluse-bash.md) menangkap trailer dan penanda body yang dilarang sebelum operasi tulis git apa pun dilakukan.