@ojokesusu/lintasai 1.1.2

package/templates/_PATTERNS.md

@@ -0,0 +1,173 @@
+# docs/_PATTERNS.md — Standar Dokumentasi Tim Profesional
+
+> Versi 1 · 2026-05-31 · generic untuk semua proyek tim
+> File ini SISTEM (prefix `_`) — auto-disertakan saat setup. Jangan dihapus, edit hati-hati.
+
+## Tujuan
+File ini = **single source of truth** untuk cara tim ini menulis & me-maintain dokumentasi `.md` di folder `docs/`. Berlaku untuk SEMUA proyek (Next.js, Vue, Python, Go, dll). AI baca file ini di awal kerja docs untuk patuh ke konvensi tim, bukan pakai gaya improvisasi.
+
+Untuk **format konkret per file `.md`** lihat `_EXAMPLE.md` (1 file contoh siap-pakai).
+
+---
+
+## 1. Kapan WAJIB ada file `.md` pendamping?
+
+File kode dengan kondisi DI BAWAH ini WAJIB punya `docs/<basename>.md`:
+
+| Kategori | Pattern (case-insensitive, glob) |
+|---|---|
+| **Auth** | `auth.*`, `*-auth.*`, `session.*`, `login.*`, `oauth.*`, `jwt.*` |
+| **DB / Persistence** | `db.*`, `prisma.*`, `repository.*`, `schema.*`, `models/*` |
+| **Security / Crypto** | `crypto.*`, `encrypt.*`, `permissions.*`, `*-guard.*`, `rate-limit.*` |
+| **API / Router root** | `routes.*`, `controllers/*`, `handlers/*`, `api/*/route.*` |
+| **Entry points** | `main.*`, `index.*`, `app.*`, `server.*`, `layout.*` |
+| **Feature domain** | file kode di folder `features/<nama>/` atau `modules/<nama>/` dengan >1 fungsi publik |
+
+**Tidak wajib** (boleh ada `.md` kalau mau, tapi tidak required):
+- File util kecil 1-fungsi (`format-date.ts`, `pluralize.ts`).
+- File component UI sederhana tanpa state kompleks.
+- Test file (`*.test.ts`, `*.spec.ts`).
+- Type-only file (`types.ts`, `*.d.ts`).
+
+---
+
+## 2. Lokasi & Naming
+
+**Default**: semua `.md` flat di `docs/` (1 level).
+- File pendamping: nama persis = basename file kode → `src/lib/auth.ts` → `docs/auth.md`.
+- File sistem (kit-managed): prefix `_` → `_PATTERNS.md`, `_EXAMPLE.md`.
+- File peta proyek (user-managed): `architecture.md` + `glossary.md`.
+- Registry TOC (AI-managed): `architecture_auto.md`.
+
+**Scaling rule (kalau `docs/` > 30 file)**: pakai subfolder grouping.
+```
+docs/
+├── architecture.md          (peta makro proyek, user-edit)
+├── architecture_auto.md     (registry TOC, AI auto-maintain)
+├── glossary.md              (kamus istilah)
+├── _PATTERNS.md             (file ini)
+├── _EXAMPLE.md              (contoh format `.md` pendamping)
+├── security/
+│   ├── auth.md
+│   ├── encryption.md
+│   └── rate-limit.md
+├── api/
+│   ├── routes.md
+│   └── handlers.md
+└── features/
+    ├── invoices.md
+    └── reports.md
+```
+- AI baca `architecture_auto.md` dulu (lihat aturan READ-MINIMAL di seksi 4), tahu lokasi subfolder, baru cherry-pick file relevan.
+
+---
+
+## 3. Format wajib tiap file `.md` pendamping
+
+```markdown
+# <basename>.md — <deskripsi singkat 1 baris>
+
+> Versi 1 · <YYYY-MM-DD> · auto-generated (atau "user-written")
+
+## Tujuan
+Untuk siapa & masalah apa yang diselesaikan. 1-3 kalimat. Bahasa Indonesia, junior-friendly.
+
+## Cara Pakai
+Contoh pemanggilan singkat (code block kalau ada). Sebut "Dipakai di `<file>:<line>`" kalau diketahui.
+
+## Input / Output
+- Input: parameter, tipe data.
+- Output: return value, side effects, error yang bisa di-throw.
+
+## Dependensi
+- Library: import signifikan.
+- Env: env var yang dibaca.
+- File terkait: file lain yang depend / dipakai.
+
+## Catatan
+- Edge case dari source code.
+- Keputusan penting / non-obvious behavior.
+- Gotcha umum.
+- Source code: `<path>:<line>`.
+```
+
+**Aturan format:**
+- Max ~80 baris per file (kalau lebih, pecah ke `<basename>-<subtopic>.md`).
+- Bahasa Indonesia, definisikan jargon di pemunculan pertama.
+- Jangan karang — `[TBD: <pertanyaan>]` kalau gak yakin.
+- Selalu sertakan source path + line di "Catatan".
+- Tidak boleh ada secret/credential plain di docs (mask: `DATABASE_URL=postgresql://***`).
+
+Contoh konkret 1 file `.md` siap-pakai ada di `_EXAMPLE.md`.
+
+---
+
+## 4. Aturan AI behavior (4 aturan inti dari CLAUDE_universal_v1.md seksi 7)
+
+**4.1 AUTO-SYNC** (seksi 7.1)
+- Tiap edit code yang sudah ada `docs/<basename>.md` → AI WAJIB update `.md` di sesi yang sama (kalau perubahan substansial: signature publik, behavior, dependency, edge case baru).
+- Update `architecture_auto.md` kalau ada `.md` baru/rename/hapus.
+
+**4.2 LAZY-GENERATE** (seksi 7.2)
+- Tiap buat/edit file kode CRITICAL (sesuai pattern di seksi 1 di atas) yang BELUM ada `.md` → AI **sugest** generate per-file, **tanya user dulu**. JANGAN bulk-auto.
+- Default: per-file approval. Bulk-generate manual = paste `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage B: Bootstrap Docs) (on-demand tool).
+
+**4.3 READ-MINIMAL** (seksi 7.3)
+- Saat AI menerima task, baca `docs/architecture.md` DULU (peta makro), lalu `docs/architecture_auto.md` (registry TOC), baru cherry-pick `.md` relevan task.
+- LARANGAN: jangan baca semua `docs/*.md` di awal sesi (boros token kalau folder besar).
+
+**4.4 ARCHITECTURE REGISTRY** (seksi 7.4)
+- `docs/architecture.md` = peta makro proyek, user-edited.
+- `docs/architecture_auto.md` = registry TOC semua `.md` pendamping, AI auto-maintain (1 baris per file).
+- Pisah supaya user-edit tidak konflik dengan AI auto-maintain.
+
+---
+
+## 5. Workflow update docs
+
+**Saat AI edit code:**
+1. Cek apakah ada `docs/<basename>.md` → kalau ada DAN perubahan substansial → update.
+2. Commit code + `.md` bareng-bareng (1 commit boleh include keduanya).
+3. Update `docs/architecture_auto.md` kalau ada perubahan struktur (file baru, rename, hapus).
+
+**Saat AI buat file kode CRITICAL baru:**
+1. Tanya user: "File `<basename>` kena pattern CRITICAL + belum ada `docs/<basename>.md` — generate sekarang? (y/n)"
+2. Kalau "y" → generate pakai format seksi 3.
+3. Kalau "n" → opsional catat di `architecture_auto.md` section "Pending docs".
+
+**Saat user paste `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage C: Update Docs):**
+- Bulk audit semua `.md` vs git log → lapor mana yang outdated → user pilih per-file refresh.
+
+**Saat user paste `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage B: Bootstrap Docs):**
+- On-demand bulk-generate untuk proyek lama yang banyak file CRITICAL tanpa `.md`. Interactive — wajib konfirmasi sebelum write.
+
+---
+
+## 6. Anti-pattern (HINDARI)
+
+- ❌ Bulk auto-generate banyak `.md` sekaligus tanpa per-file approval (kecuali user paste BOOTSTRAP prompt).
+- ❌ Baca semua `docs/*.md` di awal sesi tanpa filter.
+- ❌ Overwrite `.md` existing tanpa user explicit minta.
+- ❌ Skip update `architecture_auto.md` saat tambah/hapus `.md`.
+- ❌ Karang isi `.md` tanpa baca source code (selalu traceable ke `<path>:<line>`).
+- ❌ Tulis `.md` dalam Bahasa Inggris (kecuali override khusus proyek di `AGENTS.md`).
+- ❌ Embed secret/credential plain di `.md` (selalu mask).
+
+---
+
+## 7. Opt-in hooks (opsional, per proyek)
+
+Aktifkan di `AGENTS.md` proyek section "Override khusus proyek":
+
+- **Pre-commit hook** — git hook yang block commit kalau edit `src/lib/*.ts` tanpa edit `docs/*.md` pendamping. Tool: husky, pre-commit, lefthook. Tambah di `package.json` scripts.
+- **CI lint** — workflow GitHub Actions yang fail kalau `architecture_auto.md` outdated vs `docs/` actual files.
+- **Auto-versioning header** — script `docs:bump` yang naikkan `Versi X · <tanggal>` di header `.md` saat update.
+
+Default kit: **tidak aktif** — friction setup tinggi untuk solo/junior. Aktifkan kalau tim sudah disiplin.
+
+---
+
+## 8. Riwayat update aturan
+| Versi | Tanggal | Ringkasan |
+|---|---|---|
+| 1 | 2026-05-31 | Inisialisasi standar dokumentasi tim. |

package/templates/architecture.md

@@ -0,0 +1,180 @@
+# docs/architecture.md — Peta Proyek `<NAMA_PROYEK>`
+> Versi 1 · `[TBD: tanggal hari ini, format YYYY-MM-DD]`
+
+## Pengantar
+File ini adalah **peta proyek 1-halaman**. Dibaca sekali di awal sesi (oleh AI atau dev baru) untuk paham struktur tanpa harus jelajah repo. Update **tiap kali** ada perubahan signifikan: tambah modul, ganti stack, ubah ENV, atau ubah konvensi. Bukan dokumentasi mendalam — detail teknis tetap di file `.md` masing-masing fitur di folder `docs/`.
+
+Semua dokumentasi proyek ditulis dalam **Bahasa Indonesia** (konsisten dengan `CLAUDE.md` global). File ini = peta makro proyek; kamus istilah ada di `docs/glossary.md`; registry semua `.md` pendamping (auto-maintained AI) ada di `docs/architecture_auto.md`.
+
+---
+
+## Tujuan Proyek
+[TBD: 2-3 kalimat. Apa yang dibangun? Untuk siapa? Masalah apa yang diselesaikan?]
+
+Contoh terisi: *"Aplikasi internal manajemen invoice untuk tim finance UKM. Menggantikan workflow Excel + email yang error-prone. Target user: 5-20 staff finance per tenant."*
+
+---
+
+## Stack
+- **Bahasa utama**: [TBD: mis. TypeScript 5.4 / Python 3.12 / Go 1.22 / Dart 3.5]
+- **Framework**: [TBD: lihat templates/STACK_VERSIONS.md untuk versi recommended]
+- **Runtime / Build**: [TBD: mis. Node 20 LTS / Bun 1.1 / uv / go build]
+- **UI / Styling**: [TBD: mis. Tailwind 4 + shadcn/ui / Jinja2 / Material 3]
+- **DB / ORM**: [TBD: mis. PostgreSQL 16 + Prisma 5 / SQLAlchemy 2 / sqlc]
+
+---
+
+## Struktur Folder
+<!-- Tree di bawah contoh proyek Node. Untuk Python/Go/Dart, ganti sesuai konvensi bahasa (mis. `cmd/`, `internal/`, `lib/`). -->
+```text
+<root>/
+├── src/             // source code utama
+├── public/          // aset statis (gambar, favicon)
+├── docs/            // dokumentasi per-modul + architecture.md ini
+├── prisma/          // skema DB & migrasi   [hapus kalau tidak pakai Prisma]
+├── tests/           // unit & integration test
+├── scripts/         // skrip operasional (seed, backup, dll)
+├── .env.example     // template ENV (jangan commit .env asli!)
+└── package.json     // (atau pyproject.toml / go.mod / pubspec.yaml)
+```
+
+---
+
+## Entry Points
+- **App utama**: [TBD: mis. `src/app/layout.tsx` (Next.js App Router) / `main.py` / `cmd/server/main.go` / `lib/main.dart`]
+- **Halaman pertama**: [TBD: mis. `src/app/page.tsx` / route `"/"`]
+- **Background worker / cron**: [TBD: mis. `src/workers/index.ts`. Kosongkan kalau tidak ada]
+
+---
+
+## Modul Inti
+<!-- Isi 5-10 modul paling sering disentuh. Hapus baris contoh sebelum commit. -->
+| Modul | Lokasi | Tujuan | Dependensi Utama |
+|---|---|---|---|
+| `<nama-modul-1>` | `<path>` | [TBD: tujuan singkat 1 baris] | [TBD: lib utama] |
+| `<nama-modul-2>` | `<path>` | [TBD] | [TBD] |
+
+---
+
+## Dependensi Utama
+<!-- Hanya library signifikan (5-10), bukan dump package.json. Sertakan alasan dipakai. -->
+- **`<lib-1>`** — [TBD: 1 baris alasan. Contoh: *"Prisma — ORM type-safe, auto-generate types dari schema"*]
+- **`<lib-2>`** — [TBD]
+
+---
+
+## Environment Variables
+<!-- JANGAN tulis nilai asli. Selalu pakai contoh format / placeholder. -->
+**Loader**: `.env.local` (dev) → `<platform>` dashboard (prod, mis. Vercel/Railway/Fly). Template: `.env.example` di root.
+
+| Nama | Wajib? | Tujuan | Contoh Format |
+|---|---|---|---|
+| `DATABASE_URL` | ya | Koneksi DB utama | `postgresql://user:pass@host:5432/db` |
+| `<NAMA_ENV_2>` | [ya/tidak] | [TBD] | [TBD] |
+
+---
+
+## Skrip & Perintah
+<!-- Contoh di bawah Node. Ganti sesuai stack. -->
+- `npm run dev` — server dev (hot reload) di port 3000  *(Python: `uv run dev` · Go: `go run ./cmd/server`)*
+- `npm run build` — build production
+- `npm run test` — jalankan unit test
+- `npx prisma migrate dev` — bikin & apply migrasi DB lokal
+- [TBD: skrip spesifik proyek — seed, lint, deploy, dll]
+
+---
+
+## Sumber Data Eksternal
+- **Database utama**: [TBD: mis. *"Supabase Postgres (shared dev + prod, lihat `docs/db.md`)"*]
+- **API eksternal**: [TBD: mis. *"Stripe (payment), Resend (email). Config client di `src/lib/clients/`"*]
+- **Cache / Queue**: [TBD: mis. Redis Upstash, atau *"tidak pakai"*]
+- **Storage file**: [TBD: mis. Supabase Storage bucket `<nama-bucket>`]
+
+---
+
+## Deploy & CI
+- **Hosting**: [TBD: mis. Vercel (frontend) + Supabase (DB) / Railway / VPS DigitalOcean]
+- **Branch auto-deploy**: [TBD: mis. `main` → production, `staging` → preview]
+- **CI / Quality gate**: [TBD: mis. GitHub Actions — lint + test wajib hijau sebelum merge]
+- **Rollback**: [TBD: mis. Vercel dashboard → Deployments → Promote previous]
+
+---
+
+## Deployment & Release Strategy
+
+### Alur Deploy
+
+```
+branch (feat/*, fix/*)
+  → PR di GitHub
+  → Vercel Preview Deploy (auto, ~1-3 menit)
+  → Review (owner + AI Reviewer bot)
+  → Squash Merge ke main
+  → Vercel Production Deploy (auto, ~2-5 menit)
+```
+
+`main` = production. Tidak ada manual "promote to production" — merge ke main = langsung deploy.
+
+### Risk Level Strategy (Default — Staging-Only)
+
+Default workflow tim TIDAK pakai feature flag. Tiap task diklasifikasi by Risk Level:
+
+- **🟢 Low**: UI minor, copy edit, refactor internal — review cepat, merge, deploy.
+- **🟡 Medium**: Fitur baru self-contained — test extensive di Vercel preview sebelum merge.
+- **🔴 High**: Sentuh auth/billing/schema-user-visible/destruktif/eksperimental — owner HOLD MERGE sampai yakin, smoke test prod 5+ menit setelah deploy.
+
+Decision tree lengkap: `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 7b.
+
+Feature flag = ADVANCED option (post-launch only): `./.claude-kit/templates/feature-flags-advanced.md`.
+
+### Rollback Strategy
+
+Target time-to-rollback **<5 menit** via git revert:
+```
+git revert HEAD && git push
+```
+Vercel auto-deploy versi sebelumnya 2-5 menit.
+
+Playbook lengkap: `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 13b.
+
+### Database Backup
+
+- Supabase Daily Auto-Backup: aktif, retention 7 hari (Dashboard → Database → Backups).
+- Manual snapshot WAJIB sebelum approve PR yang sentuh migrasi Prisma.
+
+---
+
+## Testing & Quality Gates
+- **Framework test**: [TBD: mis. Vitest / Jest / pytest / go test]
+- **Coverage minimum**: [TBD: mis. 60% pada folder `src/lib/`, atau *"belum di-enforce"*]
+- **Lint / format**: [TBD: mis. ESLint + Prettier, wajib lewat pre-commit hook]
+- **Pre-push check**: [TBD: mis. `npm run check` (lint + typecheck + test)]
+
+---
+
+## Konvensi Penting
+<!-- 3-7 aturan yang KALAU dilanggar = bug atau inkonsistensi. Hapus contoh, isi sesuai proyek. -->
+- [TBD: contoh konvensi route — mis. *"semua handler API harus pakai middleware auth wrapper di `src/lib/<helper>.ts`"*]
+- [TBD: penamaan file — lihat `docs/glossary.md` section "Aturan Penamaan"]
+- [TBD: pola error handling — mis. *"selalu return `{ ok: false, error }` dari API, jangan throw"*]
+- [TBD: format commit — mis. Conventional Commits (`feat:`, `fix:`, `refactor:`)]
+
+---
+
+## Dokumen Terkait
+File lain di folder `docs/` yang melengkapi INDEX ini:
+
+| File | Fungsi |
+|---|---|
+| `glossary.md` | Kamus istilah domain, role, status, & aturan penamaan |
+| `<fitur-1>.md` | [TBD: mis. `auth.md` — detail flow login, session, RBAC] |
+| `<fitur-2>.md` | [TBD: mis. `db.md` — skema DB, konvensi migrasi, ERD] |
+
+> Aturan dokumentasi: tiap fitur/modul baru wajib punya `.md` pendamping (lihat `CLAUDE.md` global section 4).
+
+---
+
+## Riwayat Perubahan
+| Versi | Tanggal | Author | Ringkasan |
+|---|---|---|---|
+| 1 | `[TBD: YYYY-MM-DD]` | `<nama/handle>` | Inisialisasi architecture.md |

package/templates/architecture_auto.md

@@ -0,0 +1,61 @@
+# docs/architecture_auto.md — Registry semua file .md pendamping (TOC)
+
+> Versi 1 · 2026-05-31 · **AUTO-MAINTAINED OLEH AI**
+> Aturan: `CLAUDE_universal_v1.md` seksi 7.4 ARCHITECTURE REGISTRY
+
+## Pengantar
+
+File ini adalah **registry/TOC semua file `.md` pendamping** di folder `docs/`. Tujuannya: AI baca file ini DULU di awal sesi untuk tahu apa yang available, lalu cherry-pick `.md` spesifik sesuai task — **bukan baca semua `docs/*.md`** (cegah boros token saat docs membesar).
+
+**Maintainer**: AI auto-maintain. Tiap kali AI tambah / rename / hapus `.md` pendamping (lewat AUTO-SYNC atau LAZY-GENERATE), file ini WAJIB ter-update di sesi yang sama.
+
+**Pisah dari `architecture.md`** (yang user-edited): supaya user-edit peta makro tidak konflik dengan AI auto-maintain registry.
+
+---
+
+## Format entri
+
+`- [<filename>.md](<path>) — <summary singkat 1 baris, max 80 karakter>`
+
+Contoh:
+```
+- [auth.md](auth.md) — Modul autentikasi (login + session + RBAC)
+- [security/encryption.md](security/encryption.md) — AES-GCM credential vault
+```
+
+---
+
+## Top-level (`docs/*.md`)
+
+<!-- AI tambah baris baru di sini tiap LAZY-GENERATE / BOOTSTRAP -->
+<!-- Format: - [<filename>](<path>) — <summary> -->
+
+*(Belum ada `.md` pendamping. Kalau buat file kode CRITICAL, AI akan tawarkan LAZY-GENERATE — terima dengan "y" → entri muncul di sini otomatis.)*
+
+---
+
+## Subfolder (kalau scale > 30 file)
+
+<!-- Hanya muncul kalau docs/ sudah pakai subfolder grouping (security/, api/, features/). -->
+<!-- AI auto-add section per subfolder + list file di dalamnya. -->
+
+*(Tidak ada subfolder. Default flat di `docs/` sampai docs > 30 file — baru pakai grouping.)*
+
+---
+
+## Pending docs (LAZY-GENERATE skipped)
+
+<!-- File kode CRITICAL yang user skip generate. AI tawarin lagi saat sentuh file di sesi berikutnya. -->
+<!-- Format: - <source-path> — kena pattern <kategori>, user skip pada <tanggal> -->
+
+*(Belum ada — bagian ini terisi otomatis kalau user pilih "n" saat AI sugest LAZY-GENERATE.)*
+
+---
+
+## Riwayat update registry
+
+| Tanggal | Aksi | Catatan |
+|---|---|---|
+| 2026-05-31 | Inisialisasi | Skeleton (registry TOC kosong, AI auto-update saat ada `.md` baru). |
+
+<!-- AI tambah baris baru tiap update registry (file baru / rename / hapus). -->

package/templates/decisions/README.md

@@ -0,0 +1,108 @@
+# decisions/ — Architecture Decision Records (ADR)
+
+> Folder ini menyimpan **catatan keputusan teknis non-sepele** yang diambil di proyek.
+> Tujuannya: kalau 6 bulan lagi ada yang tanya "kenapa dulu pilih X bukan Y?", jawabannya ada di sini — bukan di kepala satu orang.
+
+---
+
+## Apa itu ADR?
+
+**ADR (Architecture Decision Record)** = dokumen pendek 1-2 halaman yang mencatat:
+- **Context** — masalah apa yang dihadapi
+- **Decision** — keputusan apa yang diambil
+- **Konsekuensi** — trade-off (pros, cons, risk)
+
+Format lengkap ada di [`_TEMPLATE.md`](./_TEMPLATE.md) — copy file itu tiap bikin ADR baru.
+
+---
+
+## Naming convention
+
+Nama file: **`ADR-<NNN>-<slug-kebab-case>.md`**
+
+Contoh nyata:
+- `ADR-001-pilih-prisma-vs-drizzle.md`
+- `ADR-002-pakai-nextauth-untuk-staff-portal.md`
+- `ADR-003-supabase-rls-policy-per-tenant.md`
+- `ADR-004-vercel-serverless-vs-self-hosted-vps.md`
+
+Aturan slug:
+- huruf kecil semua
+- pisah dengan `-` (kebab-case)
+- maksimal ~6 kata, ringkas tapi jelas
+
+---
+
+## Numbering rule
+
+- **Sequential:** mulai dari `001`, naik 1 tiap ADR baru (`002`, `003`, ...).
+- **Never reuse:** kalau ADR-005 di-deprecate / di-supersede, **jangan** pakai ulang nomor 005 untuk ADR berbeda. Biarkan tetap ada, tambahkan ADR baru di nomor terbaru.
+- **Padding 3 digit:** pakai `001` bukan `1`, supaya sort by name tetap urut sampai ADR ke-999.
+
+---
+
+## Kapan bikin ADR? (LAZY-DECISION pattern)
+
+Ikut prinsip **LAZY-DECISION**: jangan bikin ADR untuk tiap keputusan kecil — cuma yang **non-sepele** dan **susah di-rollback**.
+
+AI di kit ini akan **sugest otomatis** "ini decision teknis non-sepele, masuk `decisions/`? y/n" saat mendeteksi salah satu trigger berikut:
+
+### Trigger wajib sugest ADR
+
+1. **Ganti library/framework inti** — mis. ganti ORM (Prisma -> Drizzle), ganti auth provider (NextAuth -> Clerk), ganti UI lib.
+2. **Ganti arsitektur** — mis. monolith -> microservice, REST -> tRPC, SSR -> ISR, pindah dari Vercel ke VPS.
+3. **Ganti DB schema fundamental** — mis. ubah primary key strategy, denormalisasi tabel besar, tambah multi-tenancy.
+4. **Ganti auth strategy** — mis. tambah RLS policy, pindah session-based -> JWT, tambah RBAC layer.
+5. **Ganti infrastructure** — mis. ganti hosting, ganti DB provider, tambah message queue, tambah cache layer (Redis).
+6. **Trade-off security vs UX** yang signifikan — mis. relax CORS, pakai service-role key di client.
+
+### Bukan trigger ADR (cukup commit message + docs biasa)
+
+- Rename variable / refactor kecil
+- Tambah komponen UI baru
+- Bug fix
+- Tambah env var
+- Update dependency minor/patch
+
+---
+
+## Status lifecycle
+
+ADR punya 4 status. Selalu update di file kalau berubah.
+
+| Status        | Artinya                                                                  |
+|---------------|--------------------------------------------------------------------------|
+| `Proposed`    | Draft, belum disetujui. Masih bisa diubah / dibatalkan.                  |
+| `Accepted`    | Disetujui & sedang/sudah diimplementasi. Default state setelah merge.    |
+| `Deprecated`  | Tidak dipakai lagi, tapi belum ada penggantinya. Catat alasan.           |
+| `Superseded by ADR-YYY` | Digantikan ADR lain. **Wajib** cantumkan nomor ADR pengganti. |
+
+**Aturan:** kalau ADR di-supersede, **jangan hapus file lama** — biarkan sebagai riwayat. Cuma update field `Status` di header.
+
+---
+
+## Contoh alur pakai
+
+1. User minta: "ganti Prisma ke Drizzle".
+2. AI deteksi trigger #1 (ganti library inti) -> sugest: "ini decision non-sepele, bikin ADR di `docs/decisions/`? y/n".
+3. User: `y`.
+4. AI copy `_TEMPLATE.md` -> `ADR-001-pilih-prisma-vs-drizzle.md`.
+5. AI isi Context + Decision + Alternatif + Konsekuensi berdasarkan diskusi.
+6. Commit bersama PR implementasi.
+7. Kalau nanti di-rollback ke Prisma -> bikin `ADR-007-rollback-ke-prisma.md` + update ADR-001 status jadi `Superseded by ADR-007`.
+
+---
+
+## FAQ
+
+**Q: Bedanya ADR vs comment di code vs commit message?**
+A: Commit message jelasin "apa yang berubah". Comment di code jelasin "gimana cara kerjanya". **ADR jelasin "kenapa pilih ini, bukan yang lain"** — konteks bisnis + trade-off yang tidak muat di commit.
+
+**Q: ADR harus panjang?**
+A: Tidak. 1 halaman cukup. Yang penting **Context + Decision + Konsekuensi** terisi jujur. Lebih baik 1 halaman jujur daripada 5 halaman basa-basi.
+
+**Q: Boleh edit ADR yang sudah `Accepted`?**
+A: Boleh, tapi **append-only** di tabel Riwayat. Jangan rewrite history — itu menghilangkan jejak audit.
+
+**Q: ADR ditulis sebelum atau sesudah implementasi?**
+A: Idealnya **sebelum** (sebagai proposal). Tapi kalau decision sudah terlanjur diimplementasi, tetap tulis ADR retroaktif — lebih baik telat daripada tidak ada.

package/templates/decisions/_TEMPLATE.md

@@ -0,0 +1,84 @@
+# ADR-XXX: <Judul Singkat Decision>
+
+> Ganti `XXX` dengan nomor urut (001, 002, ...). Judul ringkas, gaya kalimat aktif.
+> Contoh nama file: `ADR-001-pilih-prisma-vs-drizzle.md`
+
+---
+
+## Metadata
+
+- **Tanggal:** YYYY-MM-DD <!-- tanggal decision diambil, bukan tanggal draft -->
+- **Status:** Proposed <!-- Proposed | Accepted | Deprecated | Superseded by ADR-YYY -->
+- **Author:** <nama / handle / email> <!-- siapa yang mengusulkan -->
+- **Reviewer:** <opsional — siapa yang ikut menyetujui> <!-- kosongkan kalau solo -->
+
+---
+
+## Context
+
+> Jelaskan **kenapa** decision ini diperlukan. Tulis seperti cerita singkat ke developer baru.
+
+- **Problem statement:** masalah konkret yang sedang dihadapi (1-3 kalimat).
+- **Constraints:** batasan yang memaksa decision ini (budget, deadline, stack existing, skill tim, regulasi).
+- **Asumsi:** hal yang dianggap benar saat decision diambil (penting buat audit di masa depan kalau asumsi berubah).
+
+---
+
+## Decision
+
+> Keputusan **apa** yang diambil. Tulis tegas — bukan "mungkin akan pakai X", tapi "pakai X".
+
+Contoh: "Pakai Prisma sebagai ORM untuk semua akses DB di sisi server."
+
+Kalau perlu, sertakan diagram singkat / pseudo-flow / contoh konfigurasi.
+
+---
+
+## Alternatif yang Ditolak
+
+> List opsi lain yang sempat dipertimbangkan + **alasan ditolak**. Bukan untuk gengsi-gengsian, tapi supaya developer di masa depan tahu "ini sudah pernah dipikirkan".
+
+- **Alternatif A — <nama>:** ditolak karena <reason singkat>.
+- **Alternatif B — <nama>:** ditolak karena <reason singkat>.
+- **Alternatif C — <nama>:** ditolak karena <reason singkat>.
+
+---
+
+## Konsekuensi
+
+> Trade-off real dari decision ini. **Jujur** — kalau ada cons, tulis. Jangan jualan.
+
+### Pros
+- <keuntungan 1>
+- <keuntungan 2>
+
+### Cons
+- <kerugian 1>
+- <kerugian 2>
+
+### Risk
+- <risiko teknis / bisnis / operasional yang harus dipantau ke depan>
+- <mitigasi singkat kalau ada>
+
+---
+
+## Implementation Notes
+
+> Opsional. Isi kalau decision ini sudah / sedang diimplementasi.
+
+- **PR terkait:** <link PR / commit hash>
+- **File yang berubah:** <path utama, mis. `prisma/schema.prisma`, `lib/db.ts`>
+- **Migration plan:** <kalau breaking — langkah migrasi data / kode lama>
+- **Rollback plan:** <kalau decision gagal — cara balik ke state sebelumnya>
+
+---
+
+## Riwayat
+
+> Diisi **hanya kalau ADR ini direvisi** setelah Accepted. Append-only, jangan hapus entry lama.
+
+| Tanggal     | Status            | Oleh         | Catatan                                                       |
+|-------------|-------------------|--------------|---------------------------------------------------------------|
+| YYYY-MM-DD  | Proposed          | <author>     | Draft awal                                                    |
+| YYYY-MM-DD  | Accepted          | <reviewer>   | Disetujui setelah diskusi tim                                 |
+| YYYY-MM-DD  | Superseded        | <author>     | Digantikan ADR-YYY karena <reason>                            |