lintasAI

Aturan kerja AI untuk tim yang mayoritasnya bukan programmer. Sekali pasang, AI coding di project kamu berhenti ngasal: menjawab dalam Bahasa Indonesia yang bisa dimengerti orang non-teknis, wajib membuktikan tiap klaimnya, dan tidak bisa menjalankan perintah merusak tanpa izinmu.

Jalan di Claude Code · Kimi Code · Codex · Cursor. Windows-only untuk sekarang (kenapa).

npm create lintasai

Jalankan di folder project kamu. Selesai dalam ~1 menit — tak ada langkah lanjutan.

Apa yang kamu dapat

4 pagar yang tak bisa dimatikan — ini inti kit, berlaku di tiap sesi tanpa kamu mengetik apa pun:

| Pagar | Artinya buat kamu | |---|---| | 🇮🇩 Bahasa Indonesia non-programmer | Tiap istilah teknis dijelaskan sekali dengan bahasa awam. Pesan error diterjemahkan jadi "apa artinya + apa langkahnya", bukan ditempel mentah. | | 🔍 Anti-ngarang | AI wajib membuka berkasnya dulu sebelum mengklaim sesuatu ada. Tak bisa menunjuk berkas:baris → ia harus bilang "belum saya cek", bukan menebak. | | 🛑 Tidak boleh merusak | rm -rf, DROP TABLE, git push --force, deploy ke produksi → muncul dialog Setujui/Tolak lebih dulu. Perintah harian (git status, npm run build) tetap lancar. | | ✅ Belum boleh bilang "selesai" | "Selesai" hanya sah setelah dijalankan dan hasilnya dilihat. Ditambah 1–3 langkah klik supaya kamu bisa membuktikannya sendiri tanpa paham kode. |

32 rak panduan per-bidang yang AI buka sendiri sesuai topik — auth, pembayaran, database, deploy, SEO, aksesibilitas, keamanan OWASP, dan seterusnya. Kamu tak perlu tahu nama raknya: cukup bilang "bikin halaman login", AI yang mencari panduan keamanannya.

Kamu ikut naik kelas. Tiap penjelasan memuat tiga hal — apa maksudnya, kenapa begitu, dan langkah berikutnya — supaya lama-lama kamu tak lagi bergantung sepenuhnya pada AI.

Sesudah pasang

npx lintasai doctor    # aturan sampai ke alat AI mana saja? palang mana yang nyala? berkas utuh?
npx lintasai update    # ambil versi baru (cadangkan dulu, deteksi perubahan besar)

Pemasangan menjalankan doctor otomatis di akhir, jadi kamu langsung melihat buktinya — bukan sekadar tulisan "berhasil".

Dokumentasi lengkap

• Panduan pemakai — cara pakai, matriks dukungan per-alat AI apa adanya, FAQ
• Peta isi kit — apa di mana + daftar 32 rak panduan
• Changelog — apa yang berubah tiap versi, ditulis untuk non-programmer
• Panduan pindah versi besar — langkah migrasi saat ada perubahan [BREAKING]

Windows-only

Isi kit sudah 100% Node, tapi pemasangnya masih mengasumsikan cara Windows menata berkas (huruf drive C:\, %USERPROFILE%, letak config global). Memaksakannya di mac/Linux akan memasang kit di tempat yang salah dan aturannya tak akan pernah termuat — jadi kit menolak dengan penjelasan, bukan diam-diam "berhasil". Dukungan mac/Linux ada di rencana sebagai rilis tersendiri.

Lisensi MIT — bebas dipakai, dimodifikasi, dan disebarkan.

Aturan struktur — satu baris, tak ada pengecualian

Ada di dalam kit/ = dikirim ke client. Semua yang di luar kit/ = hanya repo ini.

kit/ adalah muatan yang mendarat sebagai .lintasai/ di project client. Installer menyalin isinya (prefiks kit/ dibuang), jadi tata-letak yang diterima client tidak berubah.

| Di akar repo | Kenapa tidak di dalam kit/ | |---|---| | package.json | Wajib di akar paket (aturan npm) | | eslint.config.mjs | Dicari eslint . dari akar | | CLAUDE.md + lintasAI.md | Kernel-developer privat — sengaja TIDAK dikirim ke client | | docs/ | Dokumentasi mesin + ADR, maintainer-facing | | tests/ | Tes internal (npm test) — tak ikut paket | | create-lintasai/ | Paket npm terpisah (npm create lintasai) | | LICENSE · README.md | Konvensi GitHub; npm juga menyertakannya otomatis |

LICENSE sengaja kembar dengan kit/LICENSE (isinya statis, dijaga tes byte-identik).

Perintah

npm test                 # ~1500 tes Node
npm run preflight        # gerbang pra-rilis (npm run preflight:strict saat mau rilis)
npm run lint             # ESLint
node tools/peta-gen.mjs  # regen kit/PETA.md dari struktur disk

Peta "apa di mana" untuk maintainer juga ada di kit/PETA.md — di-generate otomatis, jadi tak pernah basi.