codehava-agent-kit 2.0.0 → 3.0.0

package/templates/.agent/workflows/launch.md

@@ -0,0 +1,127 @@
+---
+description: |
+  Satu command untuk graduate PLANNING.md + langsung init STATE.md dan MEMORY.md.
+  Eliminasi friction antara planning dan execution — tidak perlu tanya ulang apa
+  yang sudah dijawab di /vibe-plan. Gunakan ini sebagai shortcut dari
+  /graduate → /apply setup untuk project yang sudah planning-complete.
+---
+
+# /launch — Graduate + Init Sekaligus
+
+One command yang menggabungkan `/graduate` + inisialisasi PAUL state files.
+
+---
+
+## Fase 1 — Graduate
+
+Eksekusi penuh workflow `/graduate` termasuk:
+- Quality gate validation
+- README synthesis + user approval
+- App directory creation + git init
+- Tracking update
+
+*Jika graduate gagal (quality fail) → stop di sini, jangan lanjut ke Fase 2.*
+
+---
+
+## Fase 2 — Confirm PAUL Init
+
+Setelah graduate berhasil, tanya user:
+
+```
+✅ Project di-graduate ke apps/[nama-project]/
+
+Inisialisasi STATE.md dan MEMORY.md sekarang untuk managed build?
+(Ini membaca PLANNING.md dan mengisi state files tanpa tanya ulang)
+
+[Y/n]
+```
+
+Jika **N** → berikan instruksi manual:
+```
+Untuk init manual nanti:
+→ Buka apps/[nama-project]/
+→ Jalankan /apply lalu /unify untuk mulai build
+→ State files akan dibuat otomatis saat pertama kali /apply dijalankan
+```
+
+---
+
+## Fase 3 — Headless State Init
+
+Baca PLANNING.md dan README (hasil synthesis) untuk derive:
+- Project type + rigor level
+- Tech stack decisions
+- Phase breakdown
+- Constraints dan anti-patterns
+
+**Populate `.agent/STATE.md`:**
+```markdown
+## Current Position
+- Phase: planning (complete)
+- Active plan: (none yet — run /apply to start)
+- Next task: T001 dari phase pertama
+
+## Project Overview
+- Name: [dari PLANNING.md]
+- Type: [Application/API/Campaign/Utility/Workflow]
+- Current milestone: Milestone 1 — [nama dari phase breakdown]
+```
+
+**Populate `.agent/MEMORY.md`:**
+```markdown
+## Tech Stack
+[Dari PLANNING.md — tech decisions yang sudah dikonfirmasi]
+
+## Constraints
+[Dari PLANNING.md — constraints dan batasan]
+
+## Anti-patterns
+[Dari type config — anti-patterns untuk project type ini]
+```
+
+---
+
+## Fase 4 — Approval Gate
+
+Tampilkan proposed structure ke user:
+
+```
+📋 Proposed Build Structure — [Nama Project]
+
+Phase 1: [nama] → [goal]
+  Task T001: [task pertama dari PLANNING.md]
+  Task T002: [task kedua]
+
+Phase 2: [nama] → [goal]
+  ...
+
+MEMORY.md initialized dengan:
+  Framework: [stack]
+  Database: [database]
+  Constraints: [list singkat]
+
+Approve untuk mulai? (Y/n)
+```
+
+Jika **N** → "Tidak ada masalah. State files tetap tersimpan. Edit manual di `.agent/MEMORY.md` atau `.agent/STATE.md`, lalu jalankan `/apply` kapanpun siap."
+
+---
+
+## Fase 5 — Closing
+
+```
+🚀 [Nama Project] siap untuk build!
+
+Files initialized:
+  ✅ apps/[nama-project]/README.md
+  ✅ apps/[nama-project]/PLANNING.md
+  ✅ .agent/STATE.md
+  ✅ .agent/MEMORY.md
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Mulai coding:
+  /apply   → eksekusi task pertama dari PLANNING.md
+  /progress → lihat full plan dan next action
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```

package/templates/.agent/workflows/new-feature.md

@@ -1,32 +1,30 @@
 ---
-description: Mulai fitur baru dengan benar — buat spec, branch Git, dan siapkan context untuk agent. Gunakan sebelum coding fitur size M atau L.
+description: |
+  Tambahkan fitur baru ke project yang sudah berjalan.
+  Untuk project yang belum ada, gunakan /vibe-plan dulu.
+  Output: deskripsi fitur yang jelas + siap untuk /apply.
 ---
 
-1. Tanya user: "Nama fitur ini apa? Deskripsi singkat tujuannya?"
+1. Tanya user: "Fitur apa yang ingin ditambahkan? Ceritakan tujuannya."
 
-2. **Wajib BDD Spec:** Cek apakah sudah ada spec di folder `specs/` untuk fitur ini.
-   Jika belum ada, **PANGGIL SKILL `feature-spec-writer`** sekarang juga untuk membuat spec baru dengan format `NNN-nama-fitur.md`. Pastikan spec mencakup *Acceptance Criteria (Given-When-Then), 4 UI States, dan Data Contract JSON* sebelum lanjut coding!
+2. **Tentukan besarnya fitur (internal):**
+   - **Kecil** (1 file) → langsung kerjakan, tidak perlu deskripsi panjang
+   - **Sedang** (2–5 file) → buat deskripsi fitur, minta persetujuan, baru kerjakan
+   - **Besar** (6+ file atau belum jelas) → sarankan pecah jadi 2 fitur terpisah:
+     > "Fitur ini cukup besar. Lebih baik kita bagi: [bagian A] dulu, baru [bagian B]. Setuju?"
 
-3. Tanya user: "Fitur ini terkait REQ ID berapa dari PRD? (contoh: REQ-020)"
-   Tambahkan referensi REQ ID ke spec.
+3. **Buat deskripsi fitur (untuk fitur Sedang dan Besar):**
+   Cek apakah sudah ada deskripsi di `specs/` untuk fitur ini.
+   Jika belum, buat `[nomor]-[nama-fitur].md` yang berisi:
+   - Apa yang fitur ini lakukan (dari sudut pandang user)
+   - Bagaimana tampilannya: kondisi normal, loading, berhasil, error
+   - File mana yang tidak boleh diubah
 
-4. Pastikan branch `main` up-to-date:
-// turbo
-   `git checkout main && git pull origin main`
+4. Tunjukkan deskripsi ke user, minta konfirmasi:
+   > "Ini rencana fiturnya. Sudah sesuai? Kalau iya, kita mulai."
 
-5. Buat feature branch baru:
-// turbo
-   `git checkout -b feat/[nama-fitur-singkat]`
+5. Setelah user setuju → jalankan `/apply`.
 
-6. Tampilkan isi spec yang baru dibuat ke user dan minta approval:
-   "Spec sudah siap. Review dan konfirmasi untuk mulai implementasi."
+6. Setelah `/apply` selesai → jalankan `/unify` untuk merangkum sesi.
 
-7. Setelah user approve, mulai implementasi sesuai acceptance criteria di spec.
-   Hanya ubah file yang tercantum di bagian "File yang Akan Diubah" di spec.
-
-8. Saat implementasi selesai, jalankan type check:
-// turbo
-   `npm run type-check`
-
-9. Jika tidak ada error TypeScript, commit dengan pesan yang sesuai:
-   `git add -A && git commit -m "feat([scope]): [deskripsi singkat]"`
+7. Setelah unify → simpan perubahan ke git.

package/templates/.agent/workflows/pause.md

@@ -0,0 +1,118 @@
+---
+description: |
+  Buat HANDOFF.md dan update STATE.md sebelum menutup session.
+  Gunakan sebelum mengakhiri sesi kerja, saat context window hampir penuh,
+  atau saat harus switch ke task lain. Berbeda dari /vibe-recap yang hanya
+  kompaksi context — /pause membuat formal handoff dengan exact resume point.
+---
+
+# /pause — Create Session Handoff
+
+Buat HANDOFF-{tanggal}.md yang cukup detail sehingga session berikutnya
+bisa resume tepat dari titik berhenti — tanpa tanya ulang apapun.
+
+---
+
+## Langkah 1 — Deteksi Current Position
+
+Baca `.agent/STATE.md` untuk tahu:
+- Phase apa yang sedang dikerjakan
+- Task mana yang sedang jalan
+- Loop status: sudah apply tapi belum unify?
+
+Tanya user jika diperlukan: "Ada yang sedang dikerjakan yang perlu dicatat sebelum pause?"
+
+---
+
+## Langkah 2 — Buat HANDOFF File
+
+Path: `docs/handoffs/HANDOFF-[YYYY-MM-DD-HHMM].md`
+
+Gunakan template dari `.agent/.shared/HANDOFF-template.md` dan isi dengan:
+
+```markdown
+# HANDOFF — [YYYY-MM-DD HH:MM]
+
+## Status Saat Ditutup
+- Closed at: [timestamp]
+- Reason: [pause / context-limit / interrupt / end-of-day]
+- Loop status: [open — belum unify / closed — sudah unify]
+
+## Yang Sedang Dikerjakan
+- Active plan: [path ke PLAN.md atau task description]
+- Current task: [T00X — deskripsi task]
+- Progress: [sudah berapa yang selesai dari total]
+
+[Checklist task dengan status aktual]
+[✓] T001 — [nama]
+[✓] T002 — [nama]
+[~] T003 — [nama] (in progress — sudah selesai bagian A, belum bagian B)
+[ ] T004 — [nama]
+
+## Yang Sudah Selesai Session Ini
+- [perubahan 1] — [file yang diubah]
+- [perubahan 2] — [file yang diubah]
+- [keputusan yang dibuat]
+
+## Masalah yang Diketahui
+- [issue 1] — severity: [Low/Medium/High]
+
+## Exact Resume Point
+1. Buka [path ke file yang sedang dikerjakan]
+2. Lanjutkan dari: [titik exact — fungsi/komponen/baris mana]
+3. Setelah itu: [T00X berikutnya]
+4. Jangan lupa: [hal penting yang mudah terlupakan]
+
+## Context Penting
+- [constraint atau keputusan yang sedang aktif]
+- [pattern yang sedang diikuti]
+```
+
+---
+
+## Langkah 3 — Update STATE.md
+
+```markdown
+## Current Position
+- Phase: [nama] (paused)
+- Last handoff: docs/handoffs/HANDOFF-[timestamp].md
+- Resume: run /resume untuk restore context
+```
+
+---
+
+## Langkah 4 — Optional WIP Commit
+
+Tanya user: "Mau commit WIP sekarang sebelum pause?"
+
+Jika ya:
+```bash
+git add [files yang dimodifikasi]
+git commit -m "wip([scope]): pause — [deskripsi singkat progress]"
+```
+
+---
+
+## Langkah 5 — Closing
+
+```
+⏸️ Session di-pause dengan benar.
+
+HANDOFF dibuat: docs/handoffs/HANDOFF-[timestamp].md
+STATE.md: updated
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Untuk resume di session berikutnya:
+  /resume   → restore context otomatis
+  atau ketik: "Baca docs/handoffs/HANDOFF-[timestamp].md dan lanjutkan"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Aturan
+
+- HANDOFF harus cukup detail untuk zero-context resumption
+- Tidak ada placeholder yang dibiarkan kosong — isi semuanya
+- Satu HANDOFF per session pause (jangan overwrite yang lama)
+- Jika loop masih open (apply belum unify) → catat eksplisit di status

package/templates/.agent/workflows/pipeline.md

@@ -0,0 +1,95 @@
+---
+description: |
+  Read-only view dari semua project di ideation pipeline.
+  Scan PLANNING.md files, kategorikan status (in-progress/ready/graduated).
+  Gunakan untuk review semua project aktif, pilih mana yang dikerjakan selanjutnya,
+  atau konfirmasi apakah project sudah di-graduate.
+---
+
+# /pipeline — Project Ideation Pipeline View
+
+Read-only tool. Tidak membuat atau mengubah file apapun.
+
+---
+
+## Langkah 1 — Scan Directories
+
+```
+Scan:
+  projects/*/PLANNING.md  → ideation pipeline
+  apps/*/                 → graduated projects
+  .agent/ACTIVE.md        → tracking metadata (jika ada)
+```
+
+---
+
+## Langkah 2 — Kategorikan Status
+
+Per project, tentukan status:
+
+| Status | Kriteria |
+|--------|----------|
+| **In Progress** | PLANNING.md ada tapi belum complete (ada placeholder/TBD) |
+| **Ready to Graduate** | PLANNING.md ada, quality gate pass, belum ada di apps/ |
+| **Graduated** | Ada di apps/ directory, git initialized |
+| **Active Build** | Graduated + `.agent/STATE.md` ada dan loop belum closed |
+
+---
+
+## Langkah 3 — Display Pipeline
+
+```
+📊 Project Pipeline — [tanggal]
+
+┌─────────────────────────────────────────────────────┐
+│  IN PROGRESS (ideation belum selesai)               │
+├─────────────────────────────────────────────────────┤
+│  • [nama-project-1] (Application) — [tanggal buat]  │
+│    Missing: Phase Breakdown, Tech Stack             │
+│    → /vibe-plan untuk lanjut                        │
+└─────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────┐
+│  READY TO GRADUATE ✅                               │
+├─────────────────────────────────────────────────────┤
+│  • [nama-project-2] (Utility) — [tanggal buat]      │
+│    Quality: Pass                                    │
+│    → /graduate [nama-project-2]                     │
+└─────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────┐
+│  ACTIVE BUILD 🔨                                    │
+├─────────────────────────────────────────────────────┤
+│  • [nama-project-3] (API/Backend) — Phase 2/4       │
+│    Loop: APPLY (in progress)                        │
+│    → /progress untuk next action                    │
+└─────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────┐
+│  GRADUATED (siap tapi belum mulai build)            │
+├─────────────────────────────────────────────────────┤
+│  • [nama-project-4] (Campaign) — [tanggal graduate] │
+│    → /launch [nama-project-4] untuk init build      │
+└─────────────────────────────────────────────────────┘
+
+Summary: [N] in progress, [N] ready, [N] active, [N] graduated
+```
+
+---
+
+## Jika Pipeline Kosong
+
+```
+Pipeline kosong. Belum ada project yang sedang berjalan.
+
+Mulai project baru:
+  /vibe-plan   → mulai ideation dari ide
+```
+
+---
+
+## Aturan
+
+- Ini adalah **read-only** — tidak ada file yang dibuat atau diubah
+- Selalu tampilkan suggested next action per project
+- Jika ACTIVE.md tidak ada → derive status dari filesystem saja

package/templates/.agent/workflows/progress.md

@@ -0,0 +1,103 @@
+---
+description: |
+  Tampilkan progress visual project + suggest SATU next action.
+  Mencegah decision fatigue — tidak pernah menampilkan multiple options.
+  Gunakan kapanpun ingin tahu "harus ngapain sekarang?" atau untuk check-in
+  di tengah sesi, setelah /resume, atau sebelum mulai session baru.
+---
+
+# /progress — Smart Progress View + Single Next Action
+
+Baca STATE.md dan PLANNING.md, tampilkan progress visual, suggest satu langkah selanjutnya.
+Tidak pernah lebih dari satu suggestion — itu intentional untuk cegah kebingungan.
+
+---
+
+## Langkah 1 — Load State
+
+Baca:
+- `.agent/STATE.md` — current loop position
+- `.agent/MEMORY.md` — tech context
+- `PLANNING.md` atau `docs/phases/` — phase progress
+- `docs/task_on_hand.md` — active task checklist (jika ada)
+
+---
+
+## Langkah 2 — Hitung Progress
+
+```
+Milestone progress:
+  Phases complete: X dari Y
+  Current phase: [nama] — Z% selesai
+
+Current loop position:
+  PLAN → APPLY → UNIFY
+  [✓]    [✓]    [○]    ← contoh: sudah apply, belum unify
+```
+
+---
+
+## Langkah 3 — Routing Table (Suggest SATU Action)
+
+| Situasi | Single Suggestion |
+|---------|------------------|
+| Tidak ada PLANNING.md | `/vibe-plan` |
+| PLANNING.md ada, belum di-graduate | `/graduate [nama]` |
+| Graduated, STATE.md belum ada | `/launch [nama]` |
+| Plan belum ada untuk phase ini | `/vibe-plan` atau `/new-feature` |
+| Plan ada, belum di-apply | `/apply` |
+| Apply selesai, belum unify | `/unify` |
+| Loop closed, ada phase berikutnya | `/apply` (phase berikutnya) |
+| Semua phase done | "Siap deploy — jalankan `/deploy`" |
+| Ada task BLOCKED | "Resolve blocker: [deskripsi spesifik]" |
+| Context window penuh | `/vibe-recap` |
+
+---
+
+## Langkah 4 — Display
+
+```
+════════════════════════════════════════
+PROGRESS — [Nama Project]
+════════════════════════════════════════
+
+Milestone: [nama] — [X]% complete
+├── Phase 1: [nama] ████████████ Done
+├── Phase 2: [nama] ████████░░░░ 70%
+│   └── T001 ✅  T002 ✅  T003 🔄  T004 ⏳
+├── Phase 3: [nama] ░░░░░░░░░░░░ Pending
+└── Phase 4: [nama] ░░░░░░░░░░░░ Pending
+
+Current Loop: Phase 2
+┌─────────────────────────────────────┐
+│  PLAN ──▶ APPLY ──▶ UNIFY          │
+│    ✓        ✓        ○             │
+└─────────────────────────────────────┘
+
+────────────────────────────────────────
+▶ NEXT: /unify
+  Close the loop dan dokumenkan phase 2.
+────────────────────────────────────────
+```
+
+---
+
+## Jika Ada Context Advisory
+
+Jika STATE.md menunjukkan session sudah panjang atau /vibe-recap belum dijalankan lama:
+
+```
+⚠️ Context Advisory:
+   Session sudah cukup panjang. Pertimbangkan /vibe-recap
+   sebelum melanjutkan agar konteks tetap segar.
+```
+
+---
+
+## Aturan
+
+- **Selalu suggest tepat SATU action** — tidak pernah "bisa A atau B atau C"
+- Jika user provide context ("saya cuma punya 30 menit"), sesuaikan suggestion:
+  - Waktu terbatas → suggest task terkecil yang bisa di-close
+  - Ada bug urgent → prioritaskan itu dulu sebelum planned work
+- Read-only — tidak mengubah file apapun

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."