# UPDATE_KIT_PROMPT_v1.md - Prompt Update Kit lintasAI (Single-Paste) > Versi: v1 · Untuk staff IT non-programmer · Bahasa Indonesia > Pasangan dari `JALANKAN_KIT.md` (setup awal). File ini = **update kit** yang sudah terpasang. --- ## Cara pakai Paste **seluruh isi file ini** ke Claude Code (di project yang sudah pakai lintasAI). AI akan otomatis cek versi, jelaskan apa yang berubah pakai analogi yang gampang, minta konfirmasi sekali, lalu eksekusi update-nya. Anggap aja seperti **update aplikasi WhatsApp di HP**: kamu tinggal tekan "Update", aplikasi yang ngurus sendiri - kamu cuma kasih izin sekali di awal. --- ## Implicit consent Dengan paste prompt ini, kamu (staff) **memberi izin AI untuk**: 1. Baca `AGENTS.md` + `./.claude-kit/CHANGELOG.md` (cek versi kit yang lagi terpasang). 2. Tarik info versi terbaru dari GitHub remote (`github.com/ojokesusu/lintasAI`). 3. Jalankan `./.claude-kit/kit.ps1 update` kalau memang ada versi baru. 4. Backup kit lama otomatis (`.bak` files) sebelum re-clone. 5. Cleanup backup lama (> 30 hari atau lebih dari 3 versi terakhir). AI **tidak akan** sentuh file project kamu (kode app, `docs/`, `AGENTS.md` kamu) - itu dilindungi manifest sha256 (sama persis logic-nya kayak `uninstall.ps1`). --- ## Workflow yang AI jalankan Ikuti urutan ini step-by-step. Jangan skip step kecuali user bilang skip eksplisit. ### Step 1 - Baca versi kit yang terpasang Buka file: - `./AGENTS.md` → cari field "Versi kit di `./.claude-kit/`" (contoh: `v1.0.0`). - `./.claude-kit/CHANGELOG.md` → konfirmasi versi terbaru di file lokal (entry paling atas). Catat: `CURRENT_VERSION = v1.x.y`. ### Step 2 - Cek versi terbaru di GitHub > ⚠️ PENTING (v1.13.1): JANGAN urutkan tag dengan `Sort-Object` biasa (urutan ABJAD) — secara teks `v1.5.9` > `v1.13.0` (SALAH, itu bikin AI salah lapor "sudah terbaru"). Pakai cast `[version]` (semver) di bawah. Ini SAMA dengan logika resmi di `update-kit.ps1`. Jalankan (silent, tanpa output panjang) — urutan semver yang BENAR: ```powershell git ls-remote --tags https://github.com/ojokesusu/lintasAI | ForEach-Object { if ($_ -match 'refs/tags/(v\d+\.\d+\.\d+)(?:\^\{\})?$') { $Matches[1] } } | Sort-Object -Unique | Sort-Object -Property @{ Expression = { [version]($_ -replace '^v','') }; Descending = $true } | Select-Object -First 1 ``` Atau alternatif: fetch `CHANGELOG.md` di branch `main` GitHub via WebFetch (kalau git remote belum di-config) — ambil entry versi paling atas. Catat: `LATEST_VERSION = v1.x.z`. (Sumber kebenaran sebenarnya = `update-kit.ps1` sendiri saat dijalankan; deteksi manual ini hanya untuk **komunikasi ke staff**, bukan keputusan akhir.) ### Step 3 - Bandingkan Kalau `CURRENT_VERSION == LATEST_VERSION`: > "Kit lintasAI kamu udah versi terbaru (`v1.x.y`). Kayak buka Tokopedia trus dia bilang 'Sudah versi terbaru' - gak perlu update. Selesai." Stop di sini. **Jangan** lanjut step 4+. Kalau beda → lanjut step 4. ### Step 4 - Parse CHANGELOG entries di antara versi Baca `./.claude-kit/CHANGELOG.md` (lokal = versi lama) **dan** CHANGELOG terbaru dari GitHub remote. Ambil semua entry antara `CURRENT_VERSION` (exclusive) sampai `LATEST_VERSION` (inclusive). Contoh: current `v1.0.0`, latest `v1.2.0` → parse entry `v1.0.1`, `v1.0.2`, `v1.1.0`, `v1.2.0`. ### Step 5 - Auto-classify per entry ke Tier 1-4 Logic klasifikasi: | Tier | Trigger label/content | Analogi tools digital | |------|----------------------|-----------------------| | **Tier 1 (Silent)** | Patch version bump tanpa label apapun. Isi: typo, fix grammar, link mati. | WhatsApp `2.23.10 → 2.23.11` auto-update di background - kamu gak ngerasa apa-apa, tau-tau udah update. | | **Tier 2 (AI auto-sync)** | Minor version bump tanpa label. Isi: aturan baru, template baru, section CLAUDE_universal baru. | iPhone `iOS 17.3 → 17.4` minor - fitur baru aktif setelah restart, tapi cara pakai HP-mu gak berubah. | | **Tier 3 ([BREAKING])** | Label `[BREAKING]` di CHANGELOG. Isi: struktur file pindah, format manifest ganti, naming convention diubah. | iPhone `iOS 16 → iOS 17` major - backup wajib, ada migration screen pas booting pertama. | | **Tier 4 ([SCAN-REQUIRED])** | Label `[SCAN-REQUIRED]`. Isi: bulk-bootstrap logic ganti, scan rule baru yang harus apply ke project lama. | Tokopedia Seller ganti algoritma kategori - produk lama harus di-remap ulang ke kategori baru, bukan cuma update app. | Default kalau ragu antara Tier 1 vs Tier 2: pilih **Tier 2** (lebih informatif buat user). Default kalau ragu antara Tier 3 vs Tier 4: cek apakah ada instruksi "scan project ulang" di CHANGELOG. Ya → Tier 4, tidak → Tier 3. ### Step 6 - Compose summary (Bahasa Indonesia + analogi wajib) Format laporan ke staff: ``` Update tersedia: v1.0.0 → v1.2.0 Yang berubah: [Tier 1: 3 perbaikan kecil] Kayak WhatsApp auto-update - ada perbaikan typo & link mati, tapi cara kamu pakai kit gak berubah sama sekali. [Tier 2: 1 aturan baru] Section 4.5 di CLAUDE_universal_v1.md ("Audit Post-Setup Pattern"). Kayak iPhone dapat fitur baru di iOS minor update - AI otomatis mulai pakai aturan ini abis update. Kamu gak perlu hafal. [Tier 3 (perubahan besar): kosong] [Tier 4 (perlu periksa ulang project): kosong] Yang ke-update: 4 file di ./.claude-kit/ Yang ke-backup otomatis: ./.claude-kit.backup-2026-06-04/ Yang DILINDUNGI (gak disentuh): - File project kamu (kode app, docs/, dll) - AGENTS.md kamu (aturan khusus yang kamu atur sendiri untuk project ini) Yang perlu kamu lakuin abis update: TIDAK ADA - langsung lanjut kerja seperti biasa. AI akan otomatis pakai aturan baru di sesi berikutnya. ``` Kalau ada Tier 3 → tambah section: ``` PERHATIAN [BREAKING] (perubahan besar — ada langkah wajib yang harus dijalankan sebelum lanjut kerja): [judul perubahan] Langkah penyesuaian (penataan ulang — disalin dari catatan perubahan kit): 1. 2. Estimasi waktu: ``` Kalau ada Tier 4 → tambah section: ``` PERHATIAN [SCAN-REQUIRED] (project kamu perlu diperiksa ulang sekali): Abis update, paste JALANKAN_KIT.md ulang biar AI scan project pakai aturan baru. Kayak Tokopedia minta produk lama ditata ulang ke kategori baru. ``` ### Step 7 - Popup konfirmasi Tanya staff — tampilkan sebagai **kotak pilihan klik** (`AskUserQuestion`) kalau tersedia; blok di bawah = isi kanonik + fallback teks (per `JALANKAN_KIT.md` > "Cara Tampil Popup"): > "Lanjut update sekarang? > [1] Ya, update sekarang (rekomendasi) — biar kit ikut versi terbaru, ada backup otomatis + bisa dibalikin > [2] Tidak, nanti saja > [cancel] Batalkan proses update > (Pilih dengan KLIK [1] / [2] / [cancel] — TIDAK ada default otomatis untuk keputusan update; diam = tunggu, bukan 'Ya'.)" > ⚠️ PENTING (v1.13.1): update = mengganti file kit (re-clone). Walau ada backup + rollback, ini perubahan nyata → **WAJIB konfirmasi eksplisit** (sesuai §4.5 "jangan auto-execute update tanpa confirm" + §8.2 Aturan 5). Kalau staff **belum** memilih [1] / [2] / [cancel] → **JANGAN auto-jalan**; tunggu pilihannya (boleh ulangi popup sekali). **Diam ≠ setuju.** Pengecualian satu-satunya: kalau project memang **eksplisit** mengaktifkan Mode Auto-Confirm di `AGENTS.md` (§15, default MATI), baru boleh anggap silence = [1]. Kalau "[2]" / "[cancel]" → batalkan. Kalau "[1]" (atau auto-confirm aktif) → lanjut step 8. Kalau "[2]" atau "[cancel]" → "Oke, update di-cancel. Kit masih di `v1.x.y`. Paste prompt ini lagi kalau berubah pikiran." → stop. ### Step 8 - Execute update Jalankan: ```powershell ./.claude-kit/kit.ps1 update ``` Script ini yang akan: 1. Atomic re-clone dari GitHub tag `LATEST_VERSION`. 2. Backup folder lama ke `.claude-kit.backup-`. 3. Cek manifest sha256 → file yang user modify (selain template) di-preserve. 4. Cleanup `.bak` files > 30 hari atau lebih dari 3 versi terakhir. 5. Update field versi di `AGENTS.md`. Kalau script fail di tengah jalan → auto-rollback (kit balik ke `CURRENT_VERSION`). Lapor error ke staff. ### Step 9 - Laporan hasil + recommend next step Format laporan sukses: ``` Update beres. Kit sekarang v1.2.0. Backup tersimpan di: ./.claude-kit.backup-2026-06-04/ Backup lama yang dihapus otomatis (beres-beres rutin): Langkah berikutnya yang AI sarankan: [kalau ada Tier 4] Paste JALANKAN_KIT.md supaya AI periksa ulang project kamu (scan). [kalau ada Tier 3] Ikuti langkah penyesuaian (Migration Steps) di atas. [kalau cuma Tier 1/2] Lanjut kerja biasa - gak perlu apa-apa. ``` Lalu popup interaktif — tampilkan sebagai **kotak pilihan klik** (`AskUserQuestion`) kalau tersedia (4 opsi utama; `[help]` lewat "Other"); blok di bawah = isi kanonik + fallback teks: > "Mau lanjut ke step apa? > [1] Lanjut task sebelumnya - update sukses, balik kerja (rekomendasi, default) — paling aman, cuma balik kerja, tidak mengubah apa-apa > [2] Cek file yang berubah (AI tampilkan perbandingan isi lama vs baru — kayak Track Changes di Word) > [3] Balikin ke versi lama (kembalikan kit ke sebelum update) > [4] Selesai (tutup sesi ini) > [help] Jelaskan apa yang berubah di kit sebelum aku pilih > > Default (Enter/kosong) -> [1] Lanjut task sebelumnya" Ini menu **pasca-update-sukses** (non-destruktif): kalau staff diam, default ke **[1] Lanjut task** itu AMAN (cuma balik kerja). TAPI **[3] Balikin ke versi lama** = aksi nyata → WAJIB dipilih eksplisit, jangan dijalankan dari "diam". (Beda dari Step 7: di Step 7 update BELUM jalan, jadi "diam ≠ setuju"; di sini update SUDAH sukses, menu cuma soal langkah berikutnya.) --- ## Mapping intent staff → langkah | Staff bilang | AI jalankan | |--------------|-------------| | "v1.2.0 rilis, update dong" | Full workflow step 1-9. | | "lintasAI ada versi baru?" | Step 1-3 doang (cek saja, gak update). | | "update kit" | Full workflow. | | "rollback dong, update tadi bikin error" | Rollback flow: cari folder `.claude-kit.backup-` terbaru, rename `.claude-kit/` jadi `.claude-kit.broken-/`, rename backup jadi `.claude-kit/`, restore versi di `AGENTS.md`. Lapor ke staff. | | "update tapi keep file customization saya" | Full workflow + jelasin di summary: "Tenang, kit simpan daftar sidik jari tiap file (manifest sha256) yang melindungi file editan kamu. Kayak Google Drive sync — file yang kamu ubah di lokal gak ketimpa versi cloud." | | "kit saya pake versi berapa?" | Step 1 doang. Lapor versi current. | | "hapus backup lama" | Cleanup manual: list `.claude-kit.backup-*`, hapus yang > 30 hari atau lebih dari 3 versi terakhir. Lapor space yang di-free. | --- ## Tone & gaya komunikasi - **Senior dev jelasin ke junior staff** - sabar, gak nyinyir, gak pakai jargon kering. - **Analogi tools digital populer WAJIB** tiap kali jelasin konsep teknis. Pool analogi: Tokopedia, Shopee, Gojek, WhatsApp, BCA mobile, Excel, Google Drive, Notion, Discord, iPhone, Spotify, Netflix. - **Pendek > panjang**. Staff sibuk, gak baca dinding teks. - **Konfirmasi sekali di awal**, abis itu jalan terus sampai selesai. --- ## Closing message setelah update Setelah step 9 dieksekusi dan staff jawab popup (atau diam = default), tutup dengan: > "Update kit beres. Kalau ada perilaku AI yang berubah aneh abis ini, paste `JALANKAN_KIT.md` untuk menyamakan ulang aturan kit (re-sync). Atau bilang ke aku: 'rollback dong'. Aman." End sesi update.