codehava-agent-kit 1.0.1 → 3.0.0

package/templates/.agent/workflows/resume.md

@@ -0,0 +1,105 @@
+---
+description: |
+  Restore context dari HANDOFF.md setelah session break.
+  Merge handoff dengan STATE.md terkini, lalu suggest SATU next action.
+  Gunakan di awal session setelah /pause, atau ketik "resume" untuk trigger otomatis.
+  Selalu suggest satu action saja — tidak pernah overwhelm user dengan pilihan.
+---
+
+# /resume — Restore Session Context
+
+Baca HANDOFF file terbaru, merge dengan state saat ini, dan langsung tunjukkan
+satu langkah yang harus dikerjakan — tanpa decision fatigue.
+
+---
+
+## Langkah 1 — Temukan HANDOFF File
+
+```
+Cek argument: /resume [path-ke-handoff]
+
+Jika tidak ada argument:
+→ Scan docs/handoffs/ untuk file terbaru
+→ Pilih HANDOFF-*.md dengan timestamp terbaru
+→ Jika tidak ada → cek docs/recap.md sebagai fallback
+→ Jika tidak ada keduanya → "Tidak ada handoff ditemukan. Gunakan /progress untuk check state."
+```
+
+---
+
+## Langkah 2 — Load dan Merge Context
+
+Baca secara berurutan:
+1. `docs/handoffs/HANDOFF-[latest].md` — context dari session terakhir
+2. `.agent/STATE.md` — posisi loop saat ini
+3. `.agent/MEMORY.md` — tech decisions yang aktif
+
+Merge untuk deteksi:
+- Apakah ada perubahan STATE.md sejak HANDOFF dibuat?
+- Apakah loop sudah di-close oleh session lain?
+- Apakah ada task baru yang ditambahkan?
+
+---
+
+## Langkah 3 — Display Context Restoration
+
+```
+🔄 Context Restored — [Nama Project]
+
+Session terakhir: [YYYY-MM-DD HH:MM]
+Loop status saat pause: [open/closed]
+
+Yang sudah selesai:
+  ✅ [task yang sudah done dari HANDOFF]
+  ✅ [task yang sudah done dari HANDOFF]
+
+Yang belum selesai:
+  🔄 [task yang in-progress saat pause]
+  ⏳ [task yang belum dimulai]
+
+Tech context aktif:
+  Framework: [dari MEMORY.md]
+  Constraint penting: [dari MEMORY.md]
+```
+
+---
+
+## Langkah 4 — Single Next Action
+
+Suggest tepat SATU action berdasarkan loop position:
+
+| Loop State | Single Suggestion |
+|-----------|-------------------|
+| Apply belum selesai, task in-progress | Lanjutkan T00X dari exact resume point |
+| Apply selesai, belum unify | `/unify` — close loop dulu |
+| Loop closed, phase berikutnya ada | `/apply` untuk phase berikutnya |
+| BLOCKED dari session lalu | "Resolve blocker: [deskripsi]" |
+
+```
+────────────────────────────────────────
+▶ NEXT: [satu action yang disarankan]
+  [1 kalimat penjelasan mengapa ini yang pertama]
+────────────────────────────────────────
+
+Ketik "lanjut" atau jalankan command di atas untuk mulai.
+```
+
+---
+
+## Langkah 5 — Archive HANDOFF
+
+Setelah user konfirmasi resume, pindahkan HANDOFF ke folder archive:
+```
+docs/handoffs/archive/HANDOFF-[timestamp].md
+```
+
+*Jika user belum konfirmasi → biarkan HANDOFF di tempat sampai mereka proceed.*
+
+---
+
+## Aturan
+
+- **Satu next action** — tidak pernah "bisa pilih A atau B"
+- Jika ada conflict antara HANDOFF dan STATE.md → percaya STATE.md (lebih baru)
+- Jangan overwhelm dengan recap panjang — cukup yang essential
+- Jika context sangat stale (>7 hari) → tambahkan note: "Session cukup lama. Pertimbangkan `/vibe-recap` untuk refresh full context."

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