codehava-agent-kit 2.0.0 → 3.0.0

package/templates/.agent/workflows/unify.md

@@ -0,0 +1,126 @@
+---
+description: |
+  Tutup sesi dengan merangkum apa yang sudah dikerjakan, keputusan yang dibuat, dan langkah berikutnya.
+  Wajib dijalankan setelah /apply selesai agar sesi berikutnya bisa dilanjutkan dengan mulus.
+  Update STATE.md dan MEMORY.md jika ada perubahan penting di sesi ini.
+---
+
+# /unify — Rangkuman Sesi
+
+Menutup sesi dengan rapi. Dokumentasi apa yang terjadi agar sesi berikutnya bisa lanjut dari titik yang benar.
+
+---
+
+## Langkah 1 — Buat Ringkasan Sesi
+
+Buat atau update file: `docs/phases/[nomor-fase]-SUMMARY.md`
+
+Template:
+
+```markdown
+# Ringkasan Sesi [N]
+
+**Tanggal:** [YYYY-MM-DD]
+**Status:** [Selesai / Sebagian / Terhenti]
+
+---
+
+## Yang Direncanakan vs Yang Dikerjakan
+
+| Pekerjaan | Rencana | Hasil | Status |
+|-----------|---------|-------|--------|
+| [nama task] | [apa yang mau dilakukan] | [apa yang terjadi] | ✅ Selesai |
+| [nama task] | [apa yang mau dilakukan] | [apa yang terjadi] | ⚠️ Selesai, ada catatan |
+| [nama task] | [apa yang mau dilakukan] | Belum dikerjakan | 🚫 Tertunda |
+
+---
+
+## Keputusan yang Dibuat
+
+- [Keputusan 1]: [kenapa diputuskan begini]
+- [Keputusan 2]: [kenapa diputuskan begini]
+
+---
+
+## Yang Belum Selesai
+
+- [ ] [nama task] — akan dikerjakan di: [sesi berikutnya / setelah X]
+
+---
+
+## Catatan Teknis (untuk AI, bukan user)
+
+- [ ] [catatan] — prioritas: rendah/sedang/tinggi
+
+---
+
+## File yang Diubah
+
+- [path/file] — [apa yang berubah]
+
+---
+
+## Langkah Selanjutnya
+
+**Aksi berikutnya:** [apa yang perlu dilakukan di sesi berikutnya]
+**Yang harus ada dulu:** [prasyarat jika ada]
+```
+
+---
+
+## Langkah 2 — Update STATE.md (internal)
+
+Update `.agent/STATE.md`:
+
+```markdown
+## Posisi Sekarang
+- Status: sesi selesai
+- Ringkasan terakhir: [path ke SUMMARY.md]
+- Fase berikutnya: [nama atau "belum ditentukan"]
+
+## Riwayat Sesi
+- [YYYY-MM-DD]: [ringkasan 1 kalimat]
+```
+
+---
+
+## Langkah 3 — Update MEMORY.md jika ada perubahan penting (internal, silent)
+
+Jika sesi ini membuat keputusan baru tentang:
+- Teknologi yang dipakai (ganti atau tambah layanan)
+- Struktur database (tambah tabel, ubah kolom)
+- Tampilan (warna, font, gaya)
+- Batasan baru (keamanan, performa, aturan)
+
+→ Update `.agent/MEMORY.md` secara diam-diam.
+
+Jika tidak ada perubahan → skip langkah ini.
+
+---
+
+## Langkah 4 — Laporan ke User
+
+```
+✅ Sesi selesai!
+
+Yang sudah dikerjakan:
+  ✅ [N] pekerjaan selesai
+  ⚠️ [N] selesai dengan catatan
+  ⏸️ [N] ditunda / menunggu keputusan
+
+Catatan:
+  - [catatan penting dalam bahasa sederhana jika ada]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Sesi berikutnya: ketik /resume untuk lanjut dari titik ini.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Aturan Penting
+
+- Wajib dijalankan setelah setiap /apply — meskipun semua task selesai
+- Jika sebagian besar belum selesai, tetap buat ringkasan dengan status apa adanya
+- MEMORY.md hanya diupdate jika ada perubahan nyata — jangan tambah noise
+- Ringkasan ini adalah panduan untuk sesi berikutnya — tulis dengan jelas

package/templates/.agent/workflows/vibe-plan.md

@@ -1,133 +1,196 @@
 ---
 description: |
-  Orchestrator workflow untuk planning phase lengkap — dari ide ke siap coding.
-  Jalankan di awal project baru sebelum coding apapun.
-  Memandu: Research → PRD → Tech Design → Build Plan (4 langkah, ~1-2 jam total).
+  Rencanakan project baru dari ide ke rencana kerja yang siap dikerjakan.
+  Deteksi jenis project secara otomatis, ajukan pertanyaan yang relevan per jenis.
+  Output: PLANNING.md berisi rencana kerja + syarat keberhasilan per fitur.
+  Jalankan di awal project baru atau saat memulai tahap baru.
+  Selalu diikuti dengan /apply → /unify.
 ---
 
-# /vibe-plan — Planning Phase Orchestrator
+# /vibe-plan — Rencanakan Project Baru
 
-Workflow ini memandu kamu dari ide mentah ke dokumen planning lengkap
-yang siap dipakai agent untuk coding.
+Dari ide ke rencana kerja yang siap dikerjakan.
+Setiap jenis project punya pertanyaan yang berbeda — kita tidak akan tanya hal yang tidak relevan.
 
-**Total waktu estimasi:** 60–90 menit
-**Output:** 4 dokumen siap pakai + backlog terisi
+**Output utama:** `PLANNING.md` + `docs/01-PRD.md` + `docs/02-TECH-DESIGN.md`
+
+---
+
+## Langkah 0 — Kenali Jenis Project
+
+Tanya user (jika belum jelas dari konteks):
+
+> "Project ini kira-kira jenis apa? Pilih yang paling sesuai:
+> 1. **Aplikasi** — Web app atau mobile app dengan pengguna, login, dan database
+> 2. **Backend/API** — Server atau layanan yang melayani data ke aplikasi lain
+> 3. **Kampanye** — Landing page, website marketing, atau kampanye konten
+> 4. **Alat bantu** — Script, automation, atau tool untuk satu tujuan spesifik
+> 5. **Workflow otomatis** — Integrasi otomatis antar layanan (seperti Zapier, n8n)"
+
+| Jenis | Fokus Pertanyaan | Yang Dijaga |
+|-------|-----------------|-------------|
+| **Aplikasi** | Login, tampilan, database, deploy, kondisi error | Jangan tambah fitur tak terduga |
+| **Backend/API** | Endpoint, struktur data, autentikasi, testing | Jangan over-engineer |
+| **Kampanye** | Timeline, konten, platform, target audiens | Jangan tambah fitur teknis berlebih |
+| **Alat bantu** | Satu tujuan, input/output yang jelas | Jangan meluaskan scope |
+| **Workflow otomatis** | Trigger, langkah-langkah, penanganan error | Jangan coupling ketat |
 
 ---
 
 ## Langkah 1 — Cek Status Project
 
-Pertama, cek dokumen apa yang sudah ada:
+Cek file yang sudah ada (internal):
 
 ```
-Cek keberadaan file berikut:
-- docs/research-*.md     → jika ada, research sudah selesai
-- docs/01-PRD.md         → jika terisi (bukan template), PRD sudah selesai
+Cek keberadaan:
+- PLANNING.md         → jika ada dan terisi, planning sudah selesai
+- docs/research-*.md  → jika ada, research sudah selesai
+- docs/01-PRD.md      → jika terisi (bukan template), PRD sudah selesai
 - docs/02-TECH-DESIGN.md → jika terisi, tech design sudah selesai
-- BUILD_PLAN.md          → jika ada, build plan sudah selesai
 ```
 
-Berdasarkan apa yang ditemukan, langsung lompat ke step yang belum selesai.
 Tampilkan status ke user:
 
 ```
-📊 Status Planning [Nama Aplikasi]:
+📊 Status Planning — [Nama Project]:
 
-Step 1 — Research:      [✅ Selesai / ⏳ Belum]
-Step 2 — PRD:           [✅ Selesai / ⏳ Belum]
-Step 3 — Tech Design:   [✅ Selesai / ⏳ Belum]
-Step 4 — Build Plan:    [✅ Selesai / ⏳ Belum]
+Tahap 1 — Riset:        [✅ Selesai / ⏳ Belum]
+Tahap 2 — Deskripsi:    [✅ Selesai / ⏳ Belum]
+Tahap 3 — Desain teknis:[✅ Selesai / ⏳ Belum]
+Tahap 4 — Rencana kerja:[✅ Selesai / ⏳ Belum]
 
-Mulai dari Step [N]? (yes/no)
+Mulai dari Tahap [N]?
 ```
 
 ---
 
-## Langkah 2 — Jalankan Planning Secara Berurutan
+## Langkah 2 — Gali Kebutuhan (Sesuai Jenis Project)
 
-### Step 1: Research (~20 menit)
+Baca file panduan sesuai jenis project yang dipilih (internal):
+
+```
+.agent/.shared/types/[type]/guide.md         → pertanyaan yang relevan per jenis
+.agent/.shared/types/[type]/config.md        → seberapa detail yang dibutuhkan
+.agent/.shared/types/[type]/skill-loadout.md → skill yang akan dipakai
 ```
-Tujuan: Validasi ide, analisa pasar, identifikasi risiko
-Skill: vibe-research
-Output: docs/research-[AppName].md
 
-Jalankan skill vibe-research sekarang.
-Setelah selesai dan user approve → lanjut ke Step 2.
+### Cara Bertanya
+
+- Tanya **satu pertanyaan** di satu waktu — jangan langsung banyak sekaligus
+- Jika user stuck atau jawabannya samar → berikan rekomendasi proaktif ("Untuk kebanyakan kasus seperti ini, biasanya X karena...")
+- Jika pertanyaan sudah terjawab dari konteks → langsung skip, jangan tanya ulang
+- Jika user mention hal di luar scope → "Itu sepertinya ide bagus untuk project terpisah. Untuk sekarang, kita fokus ke [tujuan utama] dulu ya."
+
+### Panduan per Jenis (internal reference)
+
+| Jenis | File panduan | Topik yang digali |
+|-------|-------------|-------------------|
+| Aplikasi | `types/application/guide.md` | Masalah → Stack → Data → Login → Tampilan → API → Deploy → Keamanan |
+| Backend/API | `types/api-backend/guide.md` | Tujuan → Endpoint → Autentikasi → Struktur data → Error → Performa → Testing → Deploy |
+| Kampanye | `types/campaign/guide.md` | Tujuan → Platform → Timeline → Pesan → Konten → Metrik → Budget |
+| Alat bantu | `types/utility/guide.md` | Masalah → Batasan scope → Pengguna → Dependensi → Antarmuka → Kriteria selesai |
+| Workflow otomatis | `types/workflow/guide.md` | Trigger → Langkah-langkah → Penanganan error → Integrasi → Monitoring |
+
+---
+
+## Langkah 3 — Buat Dokumen Planning Secara Berurutan
+
+### Tahap 1: Riset (untuk Aplikasi dan Backend saja)
+```
+Gunakan skill: vibe-research
+Output: docs/research-[NamaProject].md
+Setelah selesai → minta persetujuan user → lanjut Tahap 2
 ```
 
-### Step 2: PRD (~20 menit)
+### Tahap 2: Deskripsi Produk
 ```
-Tujuan: Definisikan fitur, user stories, scope MVP
-Skill: vibe-prd
-Input: docs/research-[AppName].md (baca dulu)
-Output: docs/01-PRD.md (terisi penuh)
+Gunakan skill: vibe-prd
+Input: hasil riset (jika ada) + jawaban dari pertanyaan tadi
+Output: docs/01-PRD.md
+
+Untuk setiap fitur utama, tulis:
+  - Apa yang user bisa lakukan
+  - Bagaimana kita tahu fitur ini berhasil (kapan dianggap selesai)
 
-Jalankan skill vibe-prd sekarang.
-Setelah selesai dan user approve → lanjut ke Step 3.
+Setelah selesai → minta persetujuan user → lanjut Tahap 3
 ```
 
-### Step 3: Tech Design (~20 menit)
+### Tahap 3: Desain Teknis
 ```
-Tujuan: Pilih stack, desain arsitektur, buat ERD awal
-Skill: vibe-techdesign
-Input: docs/01-PRD.md + docs/research-*.md
-Output: docs/02-TECH-DESIGN.md (terisi + ERD + API contracts)
+Gunakan skill: vibe-techdesign
+Input: docs/01-PRD.md + jawaban dari pertanyaan
+Output: docs/02-TECH-DESIGN.md (teknologi yang dipakai + struktur data + cara kerja API)
 
-Jalankan skill vibe-techdesign sekarang.
-Setelah selesai dan user approve → lanjut ke Step 4.
+Setelah selesai → minta persetujuan user → lanjut Tahap 4
 ```
 
-### Step 4: Build Plan (~15 menit)
+### Tahap 4: Buat Rencana Kerja
 ```
-Tujuan: Breakdown task per sprint, siapkan backlog
-Skill: vibe-buildplan
+Gunakan skill: vibe-buildplan
 Input: docs/01-PRD.md + docs/02-TECH-DESIGN.md
-Output: docs/04-BACKLOG.md (terisi) + BUILD_PLAN.md
+Output: PLANNING.md (siap untuk /apply)
 
-Jalankan skill vibe-buildplan sekarang.
-Setelah selesai → tampilkan summary.
+Isi PLANNING.md:
+- Jenis project
+- Daftar pekerjaan berurutan per sprint
+- Per pekerjaan: ukuran keberhasilan + file yang akan diubah
+- Batasan yang tidak boleh dilanggar
 ```
 
 ---
 
-## Langkah 3 — Summary Akhir
+## Langkah 4 — Validasi Rencana (internal)
 
-Setelah semua step selesai, tampilkan:
+Sebelum maju, cek PLANNING.md secara internal:
 
 ```
-🎉 Planning Phase Selesai!
+□ Semua fitur utama punya ukuran keberhasilan yang jelas?
+□ Teknologi yang dipakai sudah dipilih dan dikonfirmasi user?
+□ Batasan-batasan sudah jelas dituliskan?
+□ Pekerjaan pertama sudah cukup detail untuk langsung dikerjakan?
+□ File yang tidak boleh diubah sudah ditandai?
+□ [Aplikasi] Alur login sudah didesain?
+□ [Aplikasi] Kondisi loading, kosong, dan error sudah dipikirkan?
+□ [Kampanye] Timeline dan deadline sudah dikonfirmasi?
+□ [Alat bantu] Hanya satu tujuan — tidak meluas?
+```
 
-Dokumen yang sudah dibuat:
-✅ docs/research-[AppName].md    — Validasi ide & analisa pasar
-✅ docs/01-PRD.md                — Product Requirements (N user stories)
-✅ docs/02-TECH-DESIGN.md        — Stack: [ringkasan stack] + ERD
-✅ docs/04-BACKLOG.md            — [N] sprint, [M] total task
-✅ BUILD_PLAN.md                 — Panduan build phase
+Jika semua ✅ → lanjut.
+Jika ada ❌ → lengkapi dulu sebelum lanjut.
+
+---
+
+## Langkah 5 — Ringkasan & Siap Mulai
+
+```
+🎉 Planning selesai! [Jenis: Aplikasi/Backend/Kampanye/Alat bantu/Workflow]
 
-Stack yang dipilih:
-- [ringkasan 1-liner stack]
+Dokumen yang dibuat:
+✅ PLANNING.md              — Rencana kerja siap dieksekusi
+✅ docs/01-PRD.md           — [N] fitur
+✅ docs/02-TECH-DESIGN.md   — Teknologi: [ringkasan]
 
-Sprint 1 Goal: [goal sprint 1]
-Task pertama: T001 — [nama task pertama]
+Sprint pertama: [N] pekerjaan, tujuan: [tujuan sprint pertama]
+Pekerjaan pertama: [nama pekerjaan]
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Siap coding! Mulai dengan:
-  /new-feature  → untuk fitur size M/L
-  /dev-reset    → jika butuh setup environment dari awal
+Langkah berikutnya:
+  /apply   → mulai mengerjakan pekerjaan satu per satu
+  /unify   → wajib dijalankan setelah /apply selesai
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Sebelum coding, pastikan:
-□ AGENTS.md sudah ada di root project
-□ .env.local sudah diisi credentials
-□ Docker Compose sudah jalan (docker compose up -d)
+Sebelum mulai coding, pastikan:
+□ .agent/STATE.md sudah diisi
+□ .agent/MEMORY.md sudah diisi (keputusan teknologi dari planning ini)
+□ .env.local sudah ada (API keys, database URL, dll)
 ```
 
 ---
 
 ## Aturan Penting
 
-- Jangan skip ke coding sebelum minimal Step 2 (PRD) selesai
-- Setiap step harus dapat **approval eksplisit** dari user sebelum lanjut
-- Jika user ingin ubah sesuatu di step sebelumnya, kembali ke step itu dulu
-- Workflow ini bisa di-resume kapanpun — cukup jalankan `/vibe-plan` lagi dan ia akan cek progress
-- Dokumen yang dihasilkan adalah **living documents** — update setiap sprint jika ada perubahan scope
+- Jangan mulai coding sebelum minimal Tahap 2 (deskripsi produk) selesai
+- Setiap tahap butuh **persetujuan eksplisit** dari user sebelum lanjut
+- PLANNING.md bisa diupdate jika ada perubahan rencana
+- Workflow ini bisa dilanjutkan: jalankan `/vibe-plan` lagi untuk cek progress
+- **Kampanye dan alat bantu:** Aktif tolak penambahan fitur di luar tujuan utama

package/templates/.agent/workflows/vibe-recap.md

@@ -1,17 +1,94 @@
 ---
-description: Rangkum percakapan saat ini agar bisa pindah ke chat baru tanpa hilang konteks
+description: |
+  Context compaction + PAUL UNIFY ringan — rangkum session saat ini agar bisa
+  pindah ke chat baru tanpa kehilangan konteks. Gunakan saat context window
+  mulai penuh atau AI mulai kehilangan fokus. Jika sudah selesai satu /apply
+  phase, gunakan /unify dulu (lebih lengkap) sebelum /vibe-recap.
 ---
 
-# Vibe Recap — Context Compaction
+# /vibe-recap — Context Compaction + Reconciliation
 
-Gunakan workflow `/vibe-recap` atau `/recap` saat percakapan AI (context window) sudah terlalu panjang atau AI mulai kehilangan fokus.
+Gunakan `/vibe-recap` atau `/recap` ketika:
+- Context window sudah panjang dan AI mulai kehilangan fokus
+- Mau pindah ke chat baru tapi tidak mau kehilangan progres
+- Perlu rangkuman cepat sebelum istirahat/pause
 
-Sebagai AI, tugasmu:
-1. Buat atau perbarui file `docs/recap.md`.
-2. Tulis rangkuman komprehensif dari semua hal yang kita diskusikan di sesi kerja ini.
-3. Struktur wajib di dalam `recap.md`:
-   - Fitur / Bug apa yang sedang dikerjakan tadi.
-   - Keputusan arsitektur terakhir yang disepakati.
-   - Daftar file apa saja yang sudah diubah di sesi ini.
-   - Langkah selanjutnya yang tertunda (*Next Steps*).
-4. Beritahu user: "Recap berhasil dibuat di `docs/recap.md`. Silakan buka obrolan baru (*New Chat*) dan perintahkan saya untuk membaca file tersebut agar kita bisa melanjutkan dengan memori yang lebih segar!"
+Untuk **full reconciliation** setelah /apply — gunakan `/unify` (lebih lengkap).
+
+---
+
+## Langkah 1 — Buat atau Update docs/recap.md
+
+Tulis rangkuman komprehensif dari semua yang terjadi di session ini:
+
+```markdown
+# Recap — [YYYY-MM-DD] Session [N]
+
+## Sedang Dikerjakan
+- Fitur/bug: [apa yang sedang dikerjakan]
+- Phase saat ini: [planning / apply / unify]
+- Task terakhir: [T00X — nama task]
+- Status: [selesai / sedang jalan / blocked]
+
+## Keputusan Arsitektur yang Disepakati
+- [Keputusan 1]: [deskripsi] — karena [alasan]
+- [Keputusan 2]: [deskripsi] — karena [alasan]
+
+## Files yang Diubah Session Ini
+- [path/file.ts] — [apa yang diubah]
+- [path/file.tsx] — [apa yang diubah]
+
+## Masalah yang Ditemukan
+- [Masalah 1]: [status — sudah fix / belum / workaround]
+
+## Next Steps (Tertunda)
+- [ ] [Langkah 1]
+- [ ] [Langkah 2]
+- [ ] [Langkah 3]
+
+## Context Penting untuk Chat Baru
+- [Info kritis yang mudah terlupakan]
+- [Pattern atau convention yang sedang diikuti]
+- [Dependency atau constraint yang aktif]
+```
+
+---
+
+## Langkah 2 — Update STATE.md (jika belum)
+
+Jika `.agent/STATE.md` ada, update dengan position terkini:
+
+```
+- Current phase: [nama phase]
+- Last task: [T00X]
+- Session closed: [timestamp]
+```
+
+---
+
+## Langkah 3 — Update MEMORY.md (jika ada perubahan)
+
+Jika di session ini ada keputusan baru tentang tech stack, warna, schema, atau constraint → update `.agent/MEMORY.md` sebelum pindah chat.
+
+---
+
+## Langkah 4 — Informasikan User
+
+```
+✅ Recap berhasil dibuat di docs/recap.md
+
+Untuk melanjutkan di chat baru:
+1. Buka chat baru
+2. Ketik: "Baca docs/recap.md dan lanjutkan dari sana"
+3. AI akan restore konteks dan melanjutkan tepat dari titik berhenti
+
+[Opsional] Jika mau full reconciliation: /unify dulu sebelum pindah chat.
+```
+
+---
+
+## Catatan
+
+- `docs/recap.md` adalah snapshot cepat — untuk reconciliation formal gunakan `/unify`
+- Bisa dijalankan kapanpun, tidak harus setelah /apply selesai
+- Aman dijalankan berulang kali — file akan di-overwrite dengan versi terbaru

package/templates/.antigravity/rules.md

@@ -6,6 +6,7 @@
 
 - Runtime: Node.js 22 LTS, TypeScript strict mode — no `any`
 - Prisma 7: import dari `@/generated/prisma`, BUKAN dari `@prisma/client`
+  (Prisma 7 generate ke `@/generated/prisma` karena custom output path di schema.prisma)
 - Next.js 16: `params`, `searchParams`, dan `headers()` selalu di-`await`
 - BullMQ: gunakan konstanta dari `QUEUES` object, jangan string literal
 
@@ -31,17 +32,19 @@ const token = (await headers()).get('x-callback-token')
 - `findMany` wajib ada `take` + `skip` — jangan query tanpa limit
 - Soft delete: gunakan `deletedAt DateTime?` — jangan hard delete data penting
 
-## Keamanan & privasi (UU PDP)
+## Keamanan & privasi (UU PDP No. 27/2022)
 
+UU PDP adalah Undang-Undang Perlindungan Data Pribadi Indonesia — wajib dipatuhi:
 - Secrets dan API keys hanya di env vars — TIDAK PERNAH di kode
-- Log tidak boleh print password, token, NIK, nomor rekening
-- Data sensitif (NIK, rekening) disimpan terenkripsi dengan pgcrypto
+- Log tidak boleh print password, token, NIK (Nomor Induk Kependudukan), nomor rekening
+- Data sensitif (NIK, rekening bank) disimpan terenkripsi dengan pgcrypto
+- User harus bisa hapus akun dan download data pribadi mereka (REQ wajib di PRD)
 - Firebase: hanya gunakan `firebase_messaging` — JANGAN aktifkan Analytics/Crashlytics
 
 ## Sebelum coding (Human-in-the-Loop)
 
-- **WAJIB Validasi:** JANGAN langsung menulis file yang panjang secara agresif. Buat *Implementation Plan* singkat di chat, dan MINTA USER mengetik "Lanjut/Approve" sebelum kamu diizinkan mengedit/membuat file.
-- Cek komponen yang ada di `/components/ui/` sebelum buat baru
+- **WAJIB Validasi:** JANGAN langsung menulis file panjang secara agresif. Buat Implementation Plan singkat di chat, MINTA USER mengetik "Lanjut/Approve" sebelum edit/buat file.
+- Cek komponen di `/components/ui/` sebelum buat baru
 - Untuk fitur size M atau L: cek apakah ada spec di `specs/` dulu
 - Satu fokus per sesi — jangan ubah hal di luar scope yang diminta
 - Konfirmasi sebelum hapus atau refactor kode yang sudah ada
@@ -52,34 +55,79 @@ const token = (await headers()).get('x-callback-token')
 - Types: feat, fix, chore, docs, refactor, test
 - Jangan push langsung ke `main` — selalu via Pull Request
 
-## Adaptive Memory & Checkbox Task Tracking (Senjata Utama AI)
+## PAUL Loop — Execution Protocol (V3.0)
 
-- **Checkbox Workflow**: Setiap kali user memberikan perintah untuk membuat atau memperbaiki fitur, kamu WAJIB memecahkannya menjadi langkah-langkah detail di `docs/task_on_hand.md` dengan format Checkbox (`[ ] Step 1`, `[ ] Step 2`). Kamu harus mengeksekusi instruksi tersebut SATU PER SATU secara berurutan dan mengubah statusnya menjadi `[x]` setiap kodenya selesai! Jangan pernah melompat langkah!
-- **Troubleshooting Log & 3L5W Framework**: Jika menemukan ERROR, **JANGAN HANYA** asal *fix* isi 1 file lalu lapor selesai. Terapkan SOP "3 Legs 5 Whys": 
-  1. **5 Whys Analysis:** Temukan akar masalah terdalamnya.
-  2. **Search & Destroy:** Gunakan fitur IDE Search (atau grep_search) untuk memeriksa SELURUH codebase. Caritahu apakah pengulangan sintaks/pattern buruk yang persis sama juga ada di *komponen* atau *file* lain yang belum disentuh.
-  3. **Global Mitigation:** Perbaiki file saat ini beserta seluruh temuan relevan lainnya, dan buat proteksi logika (misal: Zod, Null checks) untuk memblokirnya secara struktural. 
-  4. **Log it:** Beri catatan RCA di `docs/troubleshooting.md`.
-- **Template Code**: Saat disuruh membuat komponen/file baru, SELALU periksa referensi di `templates/.agent/snippets/` dan tiru strukturnya.
-- Di setiap awal sesi, kamu WAJIB membaca `docs/task_on_hand.md` dan `docs/recap.md` (jika ada) untuk *loading context*.
+Gantikan Checkbox Workflow lama dengan PAUL loop:
+
+```
+/apply  → Execute/Qualify per task (ada 4-level artifact check)
+/unify  → Mandatory setelah /apply — buat SUMMARY.md planned vs actual
+```
+
+**Task Tracking:** Pecah task ke `docs/task_on_hand.md` dengan format:
+```
+[ ] T001 — nama task
+[ ] T002 — nama task
+```
+Eksekusi SATU PER SATU secara berurutan. Update ke `[x]` setelah selesai.
+
+**Escalation Status (gantikan binary ✓/✗):**
+- ✅ DONE — selesai, terverifikasi
+- ⚠️ DONE_WITH_CONCERNS — selesai, ada catatan
+- 🔍 NEEDS_CONTEXT — butuh input user
+- 🚫 BLOCKED — butuh keputusan user
+
+**Session Start Protocol:**
+Di awal setiap sesi, baca:
+1. `.agent/STATE.md` — current loop position
+2. `.agent/MEMORY.md` — tech decisions & constraints
+3. `docs/task_on_hand.md` — task yang sedang berjalan
+4. `docs/recap.md` atau `docs/phases/[N]-SUMMARY.md` — context session terakhir
+
+**Session End (HANDOFF):**
+Jika sesi harus ditutup sebelum /unify selesai, buat HANDOFF file:
+- Path: `docs/handoffs/HANDOFF-[YYYY-MM-DD].md`
+- Gunakan template dari `.agent/.shared/HANDOFF-template.md`
+
+## Troubleshooting — 3L5W Framework (3 Legs, 5 Whys)
+
+Jika menemukan ERROR, JANGAN asal fix 1 file lalu lapor selesai.
+Panggil `@systematic-debugging` dan terapkan:
+
+1. **Leg 1 — 5 Whys:** Tanya "Kenapa?" 5x untuk temukan root cause struktural
+2. **Leg 2 — Search & Destroy:** Grep seluruh codebase untuk pattern yang sama
+3. **Leg 3 — Global Mitigation + Log:** Fix semua temuan + tambah proteksi (Zod, null checks) + catat RCA di `docs/troubleshooting.md`
+
+Setelah fix → verifikasi 4-level: EXISTS → SUBSTANTIVE → WIRED → DATA FLOWS
+
+## Template Code
+
+Saat membuat komponen/file baru, periksa referensi di `templates/.agent/snippets/`.
 
 ## Context7
 
-- Saat coding Prisma 7, Next.js 16, Better Auth, BullMQ, Socket.io:
-  tambahkan `use context7` di prompt untuk mendapat docs terbaru
+Saat coding Prisma 7, Next.js 16, Better Auth, BullMQ, Socket.io:
+tambahkan `use context7` di prompt untuk mendapat docs terbaru.
 
 ## 🧠 Skill Auto-Discovery & The Non-Programmer Shield (WAJIB DIBACA AI)
 
-Project ini dibekali dengan **455 Elite Skills** di `.agent/skills/`. User **TIDAK PERLU** menghafal atau menyuruh Anda menggunakan skill spesifik secara manual. User Anda adalah seorang **Kreator Non-Programmer** yang melakukan *Vibe Coding*.
+Project ini dibekali **600+ Elite Skills** di `.agent/skills/`. User TIDAK PERLU menghafal
+skill names. User adalah **Kreator Non-Programmer** yang melakukan *Vibe Coding*.
+
+### 1. Auto-Discovery Engine (Concrete Algorithm)
+
+Setiap kali mendapat perintah:
+1. Extract keywords dari request (misal: "bikin login Google" → `auth`, `oauth`, `google`)
+2. Search direktori `.agent/skills/` dengan keywords tersebut
+   - Exact match dulu: `skills/google-oauth/`, `skills/clerk-auth/`
+   - Lalu partial: `skills/auth-*`, `skills/*-auth`
+3. Baca `SKILL.md` di direktori yang match — SEBELUM menulis satu baris kode
+4. Announce: `🤖 Auto-Discovery: Mengaktifkan skill @[nama-skill]...`
+
+JANGAN mencari `SKILLS_INDEX.md` — file itu adalah routing mechanism, bukan list statis.
 
-### 1. Auto-Discovery Engine
-Setiap kali mendapat perintah dari user:
-1. Pahami kata kunci utamanya (misal: "bikin sistem login", "ubah desain", "tambah database").
-2. Lakukan pencarian nama direktori di `.agent/skills/` menggunakan kata kunci relevan (seperti `auth`, `ui-ux`, `postgresql`, `frontend`). JANGAN mencari file `SKILLS_INDEX.md` karena file itu usang!
-3. Baca isi file `SKILL.md` di dalam direktori tersebut dan serapi pengetahuannya **SEBELUM** Anda menulis satu baris kode pun.
+### 2. The Non-Programmer Shield
 
-### 2. The Non-Programmer Shield (Proteksi Mental User)
-User Anda TIDAK NGERTI kodingan rumit. Anda adalah **Autonomous Tech Lead**. 
-- **NO DUMPING ERRORS:** Jika terjadi error terminal, crash, atau bug saat instalasi/kompilasi, **DILARANG KERAS** mem-paste *stack trace* (teks error merah berderet) kepada user dan bertanya *"Bagaimana cara memperbaikinya?"*.
-- **SILENT SELF-HEALING:** Anda wajib menelan error tersebut diam-diam. Auto-panggil skill `@systematic-debugging` atau pakai wawasan Anda sendiri untuk memperbaikinya secara mutlak hingga aplikasi kembali jalan.
-- **VIBE FIRST:** Berikan user tautan tampilan *localhost* atau hasil desain yang memukau. Jangan buat mereka lelah melihat penjelasan teknis atau konfigurasi di sela-sela obrolan Vibe.
+- **NO DUMPING ERRORS:** DILARANG paste stack trace ke user dan tanya "Bagaimana cara fix?"
+- **SILENT SELF-HEALING:** Panggil `@systematic-debugging`, fix sendiri, baru lapor hasilnya
+- **VIBE FIRST:** Berikan user localhost preview atau hasil yang memukau — bukan config errors