Skip to Content
Engineering HandbookHow We Work

How We Work

[Draft] Bagian ini di-draft dari pola yang keliatan di CLAUDE.md & workflow yang ada. Tolong dikoreksi biar jadi “jiwa” tim yang beneran, bukan tebakan.

Engineering principles

Diturunkan dari coding rules di workspace CLAUDE.md:

  1. Mikir sebelum ngoding. Nyatakan asumsi. Kalau ragu, tanya — jangan nebak diam-diam.
  2. Simplicity first. Kode minimum yang nyelesaiin masalah. Nggak ada yang spekulatif.
  3. Surgical changes. Sentuh yang perlu aja. Jangan “m-mperbaiki” kode sebelah di luar scope.
  4. Goal-driven. Tetapkan success criteria yang bisa diverifikasi, lalu loop sampai kebukti.
  5. Surface konflik, jangan dirata-rata. Kalau dua pola bentrok, pilih yang lebih baru/teruji + jelasin kenapa.
  6. Baca sebelum nulis. Pahami export, caller, util bersama sebelum nambah kode.
  7. Fail loud. “Selesai” itu salah kalau ada yang di-skip diam-diam. Munculin ketidakpastian, jangan sembunyiin.

Ownership

  • Satu repo, satu tim pemilik. Default: perubahan single-folder. Jangan ngedit repo lain kecuali ticket-nya integration. Lihat Architecture untuk peta kepemilikan.
  • End-to-end. Yang ngerjain fitur bertanggung jawab dari kode → test → verifikasi → rollback plan.
  • Kontrak berubah = kabarin konsumer. Kalau request/response API berubah, notify semua konsumer (web, mobile) di ticket yang sama.

Communication norms

[Draft — usulkan default]

  • Tulis dulu. Keputusan penting ditulis (spec / ADR / PR description), bukan cuma di chat.
  • Bahasa. Casual boleh Bahasa Indonesia; istilah teknis tetap English.
  • Bottom-line first. Jawaban/ringkasan dulu, detail belakangan.
  • Async-friendly. Nggak semua harus meeting; default ke keputusan tertulis yang bisa dibaca ulang.

Definition of Done (short)

Sebuah kerjaan “selesai” kalau: acceptance criteria kebukti, test ditambah & hijau di CI, checks wajib lolos, PR terisi penuh, review didapat, dan rollback path dinyatakan. Detail per-repo di Engineering Process.

OverviewOnboarding