create-vasvibe 2.3.1 → 2.5.0

package/template/_gitignore

@@ -1,141 +1,141 @@
-# {{projectName}} .gitignore
-# Generated by create-vasvibe
-
-# ==========================================
-# Project Folders to Ignore
-# ==========================================
-# Ignore all files in codes folder (development code)
-codes/*
-!codes/.gitkeep
-
-
-project_overview.md
-development_log.md
-.mcp.json
-opencode.json
-
-# ==========================================
-# OS Files
-# ==========================================
-# macOS
-.DS_Store
-.AppleDouble
-.LSOverride
-._*
-
-# Windows
-Thumbs.db
-ehthumbs.db
-Desktop.ini
-$RECYCLE.BIN/
-
-# Linux
-*~
-.directory
-
-# ==========================================
-# IDE & Editor Files
-# ==========================================
-# VS Code
-.vscode/
-*.code-workspace
-
-# JetBrains IDEs (WebStorm, IntelliJ, etc.)
-.idea/
-*.iml
-*.iws
-*.ipr
-
-# Sublime Text
-*.sublime-project
-*.sublime-workspace
-
-# Vim
-*.swp
-*.swo
-
-# Emacs
-\#*\#
-.\#*
-
-# ==========================================
-# Node.js
-# ==========================================
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# ==========================================
-# Frontend frameworks
-# ==========================================
-.next/
-out/
-build/
-dist/
-
-# ==========================================
-# Environment Variables
-# ==========================================
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-.env*.local
-
-# ==========================================
-# Database
-# ==========================================
-*.sqlite
-*.sqlite3
-*.db
-
-# Prisma
-prisma/migrations/
-!prisma/migrations/.gitkeep
-
-# ==========================================
-# Logs
-# ==========================================
-logs/
-*.log
-
-# ==========================================
-# Testing
-# ==========================================
-coverage/
-.nyc_output/
-*.lcov
-
-# ==========================================
-# Build & Cache
-# ==========================================
-.cache/
-.parcel-cache/
-.turbo/
-*.tsbuildinfo
-
-# ==========================================
-# Dependencies
-# ==========================================
-jspm_packages/
-
-# ==========================================
-# Miscellaneous
-# ==========================================
-.vercel
-.netlify
-.firebase/
-
-# Temporary files
-*.tmp
-*.temp
-tmp/
-temp/
-
-# OpenCode local artifacts
-.opencode/node_modules/
-.opencode/bun.lock
+# {{projectName}} .gitignore
+# Generated by create-vasvibe
+
+# ==========================================
+# Project Folders to Ignore
+# ==========================================
+# Ignore all files in codes folder (development code)
+codes/*
+!codes/.gitkeep
+
+
+project_overview.md
+development_log.md
+.mcp.json
+opencode.json
+
+# ==========================================
+# OS Files
+# ==========================================
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Linux
+*~
+.directory
+
+# ==========================================
+# IDE & Editor Files
+# ==========================================
+# VS Code
+.vscode/
+*.code-workspace
+
+# JetBrains IDEs (WebStorm, IntelliJ, etc.)
+.idea/
+*.iml
+*.iws
+*.ipr
+
+# Sublime Text
+*.sublime-project
+*.sublime-workspace
+
+# Vim
+*.swp
+*.swo
+
+# Emacs
+\#*\#
+.\#*
+
+# ==========================================
+# Node.js
+# ==========================================
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# ==========================================
+# Frontend frameworks
+# ==========================================
+.next/
+out/
+build/
+dist/
+
+# ==========================================
+# Environment Variables
+# ==========================================
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env*.local
+
+# ==========================================
+# Database
+# ==========================================
+*.sqlite
+*.sqlite3
+*.db
+
+# Prisma
+prisma/migrations/
+!prisma/migrations/.gitkeep
+
+# ==========================================
+# Logs
+# ==========================================
+logs/
+*.log
+
+# ==========================================
+# Testing
+# ==========================================
+coverage/
+.nyc_output/
+*.lcov
+
+# ==========================================
+# Build & Cache
+# ==========================================
+.cache/
+.parcel-cache/
+.turbo/
+*.tsbuildinfo
+
+# ==========================================
+# Dependencies
+# ==========================================
+jspm_packages/
+
+# ==========================================
+# Miscellaneous
+# ==========================================
+.vercel
+.netlify
+.firebase/
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+temp/
+
+# OpenCode local artifacts
+.opencode/node_modules/
+.opencode/bun.lock

package/template/agent/workflows/_shared/change-management.md

@@ -1,70 +1,70 @@
-# Change Management — "No Silent Changes" (Shared)
-
-Aturan komunikasi rigid yang WAJIB diikuti **setiap agen**. Tujuannya: tidak ada perubahan yang hilang jejak. Setiap perubahan yang diminta user — sekecil apapun — harus terdokumentasi di acuan yang benar dan agen hilir harus tahu.
-
----
-
-## Prinsip Inti
-
-> **Jika kamu menerima perubahan, kamu tidak boleh hanya mengerjakannya — kamu wajib menuliskannya.**
-
-Kode yang berubah tanpa acuannya ikut berubah = **utang yang dilarang**.
-
----
-
-## Protokol Wajib (4 Langkah)
-
-Saat user (atau agen lain) meminta perubahan, SEBELUM menganggap selesai:
-
-1. **IDENTIFY** — Tentukan dokumen acuan mana yang terdampak:
-   - Perubahan kebutuhan/scope → `specifications/[file].md`
-   - Perubahan data model → `state/knowledge_base/data-model/`
-   - Perubahan arsitektur → `state/knowledge_base/architecture/`
-   - Perubahan UI/desain → `state/knowledge_base/design-system/`
-   - Perubahan security → `state/knowledge_base/security/`
-   - Perubahan **API Contract** → spec terkait **DAN** notify Backend + Frontend Engineer
-
-2. **UPDATE** — Edit dokumen acuan tersebut + tambahkan baris di **Revision History**-nya:
-   ```
-   | [YYYY-MM-DD HH:MM] | [agen] | [ringkasan perubahan] | requested by user |
-   ```
-
-3. **RECORD ADR** — Jika perubahan berdampak pada keputusan desain/arsitektur, buat **Architecture Decision Record**:
-   - Path: `state/knowledge_base/decisions/ADR-[NNN]-[judul-singkat].md`
-   - Gunakan template `schemas/adr.template.md`
-
-4. **NOTIFY** — Tulis `state/agent_handoff.json` agar agen hilir tahu ada perubahan acuan:
-   ```json
-   {
-     "from_agent": "[agen]",
-     "to_agent": "[agen terdampak / 'all']",
-     "task_id": "[TASK-ID]",
-     "timestamp": "[YYYY-MM-DD HH:MM]",
-     "status": "spec_changed",
-     "notes": "API Contract POST /bookings berubah: tambah field 'voucher_code'",
-     "artifacts": ["specifications/004_booking.md", "state/knowledge_base/decisions/ADR-007-voucher.md"]
-   }
-   ```
-
----
-
-## Kapan Wajib ADR?
-
-Buat ADR untuk keputusan yang **sulit/mahal diubah** nanti:
-- Ganti library/framework inti
-- Perubahan skema database
-- Perubahan kontrak API yang breaking
-- Perubahan strategi auth/security
-- Trade-off arsitektur signifikan
-
-Perubahan kecil (copy text, warna minor) cukup Revision History di doc terkait — tidak perlu ADR.
-
----
-
-## Anti-Pattern (DILARANG)
-
-- ❌ "User minta ubah validasi, langsung ubah kode saja." → Spec tidak ter-update, Tester tes hal yang salah.
-- ❌ "Aku ubah response API, nanti Frontend nyusul." → FE tidak di-notify, integrasi pecah.
-- ❌ "Perubahan kecil, tidak perlu dicatat." → Akumulasi drift, knowledge base jadi bohong.
-
-> 📎 Lihat fase & kepemilikan dokumen di `agent/workflows/_shared/phases.md`.
+# Change Management — "No Silent Changes" (Shared)
+
+Aturan komunikasi rigid yang WAJIB diikuti **setiap agen**. Tujuannya: tidak ada perubahan yang hilang jejak. Setiap perubahan yang diminta user — sekecil apapun — harus terdokumentasi di acuan yang benar dan agen hilir harus tahu.
+
+---
+
+## Prinsip Inti
+
+> **Jika kamu menerima perubahan, kamu tidak boleh hanya mengerjakannya — kamu wajib menuliskannya.**
+
+Kode yang berubah tanpa acuannya ikut berubah = **utang yang dilarang**.
+
+---
+
+## Protokol Wajib (4 Langkah)
+
+Saat user (atau agen lain) meminta perubahan, SEBELUM menganggap selesai:
+
+1. **IDENTIFY** — Tentukan dokumen acuan mana yang terdampak:
+   - Perubahan kebutuhan/scope → `specifications/[file].md`
+   - Perubahan data model → `state/knowledge_base/data-model/`
+   - Perubahan arsitektur → `state/knowledge_base/architecture/`
+   - Perubahan UI/desain → `state/knowledge_base/design-system/`
+   - Perubahan security → `state/knowledge_base/security/`
+   - Perubahan **API Contract** → spec terkait **DAN** notify Backend + Frontend Engineer
+
+2. **UPDATE** — Edit dokumen acuan tersebut + tambahkan baris di **Revision History**-nya:
+   ```
+   | [YYYY-MM-DD HH:MM] | [agen] | [ringkasan perubahan] | requested by user |
+   ```
+
+3. **RECORD ADR** — Jika perubahan berdampak pada keputusan desain/arsitektur, buat **Architecture Decision Record**:
+   - Path: `state/knowledge_base/decisions/ADR-[NNN]-[judul-singkat].md`
+   - Gunakan template `schemas/adr.template.md`
+
+4. **NOTIFY** — Tulis `state/agent_handoff.json` agar agen hilir tahu ada perubahan acuan:
+   ```json
+   {
+     "from_agent": "[agen]",
+     "to_agent": "[agen terdampak / 'all']",
+     "task_id": "[TASK-ID]",
+     "timestamp": "[YYYY-MM-DD HH:MM]",
+     "status": "spec_changed",
+     "notes": "API Contract POST /bookings berubah: tambah field 'voucher_code'",
+     "artifacts": ["specifications/004_booking.md", "state/knowledge_base/decisions/ADR-007-voucher.md"]
+   }
+   ```
+
+---
+
+## Kapan Wajib ADR?
+
+Buat ADR untuk keputusan yang **sulit/mahal diubah** nanti:
+- Ganti library/framework inti
+- Perubahan skema database
+- Perubahan kontrak API yang breaking
+- Perubahan strategi auth/security
+- Trade-off arsitektur signifikan
+
+Perubahan kecil (copy text, warna minor) cukup Revision History di doc terkait — tidak perlu ADR.
+
+---
+
+## Anti-Pattern (DILARANG)
+
+- ❌ "User minta ubah validasi, langsung ubah kode saja." → Spec tidak ter-update, Tester tes hal yang salah.
+- ❌ "Aku ubah response API, nanti Frontend nyusul." → FE tidak di-notify, integrasi pecah.
+- ❌ "Perubahan kecil, tidak perlu dicatat." → Akumulasi drift, knowledge base jadi bohong.
+
+> 📎 Lihat fase & kepemilikan dokumen di `agent/workflows/_shared/phases.md`.

package/template/agent/workflows/_shared/git-branch-management.md

@@ -1,25 +1,25 @@
-# Git Branch Management (Shared)
-
-## Rules
-1. **NEVER** commit/push langsung ke `main` atau `development`.
-2. **PENTING — Struktur Repo:** Workspace ini terdiri dari DUA repo git terpisah:
-   - **Agent repo** (root): `{project-name}/` — berisi semua file agent, spec, task, logs. Jangan commit kode produk di sini.
-   - **Product repo** (subfolder): `codes/` — repo git terpisah yang di-push ke `{repo-url}`. Semua operasi git untuk kode produk dilakukan DI DALAM folder `codes/`.
-3. **Semua perintah git untuk kode produk harus dijalankan dari dalam folder `codes/`.**
-4. **Konvensi Nama Branch:** gunakan format `feature/nama-fitur`, `fix/nama-bug`, atau `test/nama-fitur`.
-5. **Konvensi Commit (CRITICAL):** Wajib menggunakan **Conventional Commits** format:
-   - `feat: [pesan]` untuk fitur baru.
-   - `fix: [pesan]` untuk bug fix.
-   - `chore: [pesan]` untuk update tooling/config.
-   - `docs: [pesan]` untuk perubahan dokumentasi.
-   - `test: [pesan]` untuk penambahan test.
-
-## Steps
-1. **Cek branch saat ini** dengan `git -C codes/ branch --show-current`.
-2. **Cek apakah ada perubahan yang belum di-commit** dengan `git -C codes/ status`.
-   - **Jika ada perubahan belum ter-commit:** HENTIKAN pekerjaan. Informasikan kepada user bahwa branch saat ini masih memiliki perubahan yang belum di-commit. Minta user untuk commit, push, dan merge fitur tersebut ke branch `development` terlebih dahulu sebelum melanjutkan.
-3. **Jika working tree clean:**
-   - Pindah ke branch `development`: `git -C codes/ checkout development`.
-   - Pull perubahan terbaru: `git -C codes/ pull origin development`.
-   - Buat atau pindah ke branch yang sesuai dengan task: `git -C codes/ checkout -b [type]/[nama-task]`.
-4. **JANGAN lakukan commit dan push otomatis** setelah pekerjaan selesai. Hasil pekerjaan perlu diverifikasi oleh user terlebih dahulu.
+# Git Branch Management (Shared)
+
+## Rules
+1. **NEVER** commit/push langsung ke `main` atau `development`.
+2. **PENTING — Struktur Repo:** Workspace ini terdiri dari DUA repo git terpisah:
+   - **Agent repo** (root): `{project-name}/` — berisi semua file agent, spec, task, logs. Jangan commit kode produk di sini.
+   - **Product repo** (subfolder): `codes/` — repo git terpisah yang di-push ke `{repo-url}`. Semua operasi git untuk kode produk dilakukan DI DALAM folder `codes/`.
+3. **Semua perintah git untuk kode produk harus dijalankan dari dalam folder `codes/`.**
+4. **Konvensi Nama Branch:** gunakan format `feature/nama-fitur`, `fix/nama-bug`, atau `test/nama-fitur`.
+5. **Konvensi Commit (CRITICAL):** Wajib menggunakan **Conventional Commits** format:
+   - `feat: [pesan]` untuk fitur baru.
+   - `fix: [pesan]` untuk bug fix.
+   - `chore: [pesan]` untuk update tooling/config.
+   - `docs: [pesan]` untuk perubahan dokumentasi.
+   - `test: [pesan]` untuk penambahan test.
+
+## Steps
+1. **Cek branch saat ini** dengan `git -C codes/ branch --show-current`.
+2. **Cek apakah ada perubahan yang belum di-commit** dengan `git -C codes/ status`.
+   - **Jika ada perubahan belum ter-commit:** HENTIKAN pekerjaan. Informasikan kepada user bahwa branch saat ini masih memiliki perubahan yang belum di-commit. Minta user untuk commit, push, dan merge fitur tersebut ke branch `development` terlebih dahulu sebelum melanjutkan.
+3. **Jika working tree clean:**
+   - Pindah ke branch `development`: `git -C codes/ checkout development`.
+   - Pull perubahan terbaru: `git -C codes/ pull origin development`.
+   - Buat atau pindah ke branch yang sesuai dengan task: `git -C codes/ checkout -b [type]/[nama-task]`.
+4. **JANGAN lakukan commit dan push otomatis** setelah pekerjaan selesai. Hasil pekerjaan perlu diverifikasi oleh user terlebih dahulu.

package/template/agent/workflows/_shared/phases.md

@@ -1,88 +1,88 @@
-# Phases (Shared)
-
-Project VasVibe dikerjakan dalam **4 fase** dengan gerbang (gate) human di tiap transisi. Setiap agen WAJIB tahu fase mana yang sedang berjalan dan tidak boleh melompati gerbang tanpa approval.
-
----
-
-## Fase 1 — Perencanaan (Planning)
-
-**Tujuan:** Menghasilkan **blueprint** (dokumen acuan) yang dipakai semua fase berikutnya.
-
-| Agen | Output (acuan) |
-|------|----------------|
-| **Discovery** (paling hulu, INTERAKTIF) | `state/knowledge_base/requirements/requirements.md` |
-| Initiator | `project_overview.md` (sintesis dari requirements) |
-| **Toolsmith** (setelah tech stack diketahui) | `state/workspace-manifest.json` + config MCP per tool |
-| SysArch | `state/knowledge_base/architecture/` |
-| Data Architect | `state/knowledge_base/data-model/` |
-| UX Designer | `state/knowledge_base/design-system/` |
-| Security (Mode Standards) | `state/knowledge_base/security/security-standards.md` |
-| Analyst | `specifications/` (user story + **API Contract**) |
-
-**Discovery dulu:** Sebelum dokumen apapun, Discovery mewawancarai human (tanya-jawab) untuk menggali kebutuhan. Karena interaktif, **Discovery berjalan di thread utama**, bukan sebagai subagent. Outputnya (`requirements.md`) di-sign-off human, lalu jadi input Initiator.
-
-**Gate:** Human menyetujui blueprint. **API Contract wajib final** — ini seam antara Backend & Frontend.
-
----
-
-## Fase 2 — Pengerjaan (Implementation)
-
-**Tujuan:** Mengubah blueprint menjadi kode yang sudah di-review.
-
-| Agen | Peran |
-|------|-------|
-| Analyst (spec-lock) | Refine AC detail just-in-time sebelum coding |
-| Backend Engineer | API, business logic, akses DB — honor API Contract |
-| Frontend Engineer | UI/UX, frontend — honor API Contract, ikuti design-system |
-| Fullstack (fast only) | Fullstack tunggal — **hanya saat `depth=fast`** sebagai pengganti FE+BE |
-| QA | Static review + unit test sebelum lanjut |
-
-**Boundary:** API Contract menyatukan BE & FE — keduanya kerja paralel terhadap kontrak yang sama.
-**Gate:** Code review lulus.
-
----
-
-## Fase 3 — Testing
-
-**Tujuan:** Verifikasi fungsional terhadap spesifikasi.
-
-| Agen | Peran |
-|------|-------|
-| Tester | E2E test berdasarkan `specifications/` |
-| Fixer | Perbaiki bug temuan (loop dengan Tester sampai hijau) |
-
-**Gate:** Semua test fungsional hijau.
-
----
-
-## Fase 4 — Hardening
-
-**Tujuan:** Memastikan ketangguhan & keamanan sebelum produksi. **Dijalankan per-release**, bukan per-fitur.
-
-| Agen | Peran |
-|------|-------|
-| Security | Pen-test, OWASP audit, security fix (Mode B/C/D) |
-| Reliability Engineer | Performance, resilience, error handling, load test |
-| Fixer | Remediasi temuan |
-
-**Gate:** Sign-off siap produksi.
-
----
-
-## Cross-Phase (Lintas Fase)
-
-| Agen | Peran |
-|------|-------|
-| PM | Koordinasi task & status di semua fase |
-| Orchestrator | Menjalankan pipeline & menjaga gerbang fase |
-| **Toolsmith** | Provisioning workspace agentik (skill + MCP); re-apply saat pindah tool AI |
-| DevOps | CI/CD, containerization (Implementation & Hardening) |
-| Document | Dokumentasi (akhir siklus) |
-
----
-
-## Aturan Fase
-
-- **Tidak boleh lompat gerbang** tanpa human approval.
-- Setiap output fase adalah **acuan** untuk fase berikutnya — perubahan harus mengikuti `_shared/change-management.md`.
-- Fase boleh iteratif: jika Testing menemukan cacat desain, kembali ke Perencanaan via change-management, bukan tambal diam-diam.
+# Phases (Shared)
+
+Project VasVibe dikerjakan dalam **4 fase** dengan gerbang (gate) human di tiap transisi. Setiap agen WAJIB tahu fase mana yang sedang berjalan dan tidak boleh melompati gerbang tanpa approval.
+
+---
+
+## Fase 1 — Perencanaan (Planning)
+
+**Tujuan:** Menghasilkan **blueprint** (dokumen acuan) yang dipakai semua fase berikutnya.
+
+| Agen | Output (acuan) |
+|------|----------------|
+| **Discovery** (paling hulu, INTERAKTIF) | `state/knowledge_base/requirements/requirements.md` |
+| Initiator | `project_overview.md` (sintesis dari requirements) |
+| **Toolsmith** (setelah tech stack diketahui) | `state/workspace-manifest.json` + config MCP per tool |
+| SysArch | `state/knowledge_base/architecture/` |
+| Data Architect | `state/knowledge_base/data-model/` |
+| UX Designer | `state/knowledge_base/design-system/` |
+| Security (Mode Standards) | `state/knowledge_base/security/security-standards.md` |
+| Analyst | `specifications/` (user story + **API Contract**) |
+
+**Discovery dulu:** Sebelum dokumen apapun, Discovery mewawancarai human (tanya-jawab) untuk menggali kebutuhan. Karena interaktif, **Discovery berjalan di thread utama**, bukan sebagai subagent. Outputnya (`requirements.md`) di-sign-off human, lalu jadi input Initiator.
+
+**Gate:** Human menyetujui blueprint. **API Contract wajib final** — ini seam antara Backend & Frontend.
+
+---
+
+## Fase 2 — Pengerjaan (Implementation)
+
+**Tujuan:** Mengubah blueprint menjadi kode yang sudah di-review.
+
+| Agen | Peran |
+|------|-------|
+| Analyst (spec-lock) | Refine AC detail just-in-time sebelum coding |
+| Backend Engineer | API, business logic, akses DB — honor API Contract |
+| Frontend Engineer | UI/UX, frontend — honor API Contract, ikuti design-system |
+| Fullstack (fast only) | Fullstack tunggal — **hanya saat `depth=fast`** sebagai pengganti FE+BE |
+| QA | Static review + unit test sebelum lanjut |
+
+**Boundary:** API Contract menyatukan BE & FE — keduanya kerja paralel terhadap kontrak yang sama.
+**Gate:** Code review lulus.
+
+---
+
+## Fase 3 — Testing
+
+**Tujuan:** Verifikasi fungsional terhadap spesifikasi.
+
+| Agen | Peran |
+|------|-------|
+| Tester | E2E test berdasarkan `specifications/` |
+| Fixer | Perbaiki bug temuan (loop dengan Tester sampai hijau) |
+
+**Gate:** Semua test fungsional hijau.
+
+---
+
+## Fase 4 — Hardening
+
+**Tujuan:** Memastikan ketangguhan & keamanan sebelum produksi. **Dijalankan per-release**, bukan per-fitur.
+
+| Agen | Peran |
+|------|-------|
+| Security | Pen-test, OWASP audit, security fix (Mode B/C/D) |
+| Reliability Engineer | Performance, resilience, error handling, load test |
+| Fixer | Remediasi temuan |
+
+**Gate:** Sign-off siap produksi.
+
+---
+
+## Cross-Phase (Lintas Fase)
+
+| Agen | Peran |
+|------|-------|
+| PM | Koordinasi task & status di semua fase |
+| Orchestrator | Menjalankan pipeline & menjaga gerbang fase |
+| **Toolsmith** | Provisioning workspace agentik (skill + MCP); re-apply saat pindah tool AI |
+| DevOps | CI/CD, containerization (Implementation & Hardening) |
+| Document | Dokumentasi (akhir siklus) |
+
+---
+
+## Aturan Fase
+
+- **Tidak boleh lompat gerbang** tanpa human approval.
+- Setiap output fase adalah **acuan** untuk fase berikutnya — perubahan harus mengikuti `_shared/change-management.md`.
+- Fase boleh iteratif: jika Testing menemukan cacat desain, kembali ke Perencanaan via change-management, bukan tambal diam-diam.