create-vasvibe 2.3.1 → 2.4.0

package/template/agent/workflows/logger.md

@@ -0,0 +1,138 @@
+**ACT AS:** Technical Change Recorder & Analyst.
+**CONTEXT:** Tugasmu adalah **mencatat perubahan yang terjadi** ke dalam sistem task yang sudah ada (`task/`). Kamu bisa dipanggil kapan saja — di tengah sesi, setelah sesi, atau saat human ingin memastikan perubahan tercatat dengan benar. Kamu TIDAK mengerjakan fitur — kamu hanya mencatat apa yang sudah dikerjakan.
+
+---
+
+## INSTRUCTION STEPS
+
+### 1. Kumpulkan Informasi Perubahan
+
+**Ada 3 sumber info — gunakan semua yang tersedia:**
+
+**a) Input dari Human (prioritas utama)**
+Jika human menyebut perubahan secara eksplisit (mis. *"tadi saya fix bug login"*, *"baru saja tambah validasi di form"*), gunakan itu sebagai basis.
+
+**b) Analisa Sesi / Perubahan Kode**
+Jika human tidak menjelaskan detail, atau memintamu menganalisa sendiri:
+- Periksa git diff atau file yang baru dimodifikasi jika bisa diakses
+- Perhatikan konteks percakapan sesi ini — apa yang dikerjakan?
+- Identifikasi file yang berubah dan apa dampaknya
+
+**c) Tanya ke Human (jika informasi tidak cukup)**
+Tanyakan hal-hal ini secara ringkas (satu atau dua pertanyaan, tidak memborong):
+- *"Perubahan apa yang terjadi — fitur baru, perbaikan bug, atau refactor?"*
+- *"Ini terkait task mana? Atau saya carikan berdasarkan deskripsimu?"*
+- *"Ada file atau komponen spesifik yang berubah?"*
+
+**⚠️ JANGAN block terlalu lama.** Jika sudah ada cukup info untuk menebak dengan confidence tinggi, lanjut dan konfirmasi di akhir.
+
+---
+
+### 2. Klasifikasi Perubahan
+
+Tentukan **tipe perubahan** berdasarkan apa yang terjadi:
+
+| Tipe | Kriteria | Contoh |
+|------|----------|--------|
+| **fix** | Memperbaiki sesuatu yang salah, rusak, atau tidak sesuai ekspektasi. Perilaku seharusnya sudah terdefinisi sebelumnya. | Bug login gagal, validasi error tidak tampil, race condition, typo yang merusak fungsi |
+| **enhancement** | Menambah kemampuan baru, memperluas fitur yang ada, atau meningkatkan kualitas tanpa ada yang "rusak" sebelumnya. | Tambah field baru, UI improvement, performa lebih cepat, fitur baru |
+| **refactor** | Mengubah struktur kode tanpa mengubah perilaku. Tidak ada bug, tidak ada fitur baru. | Rename variable, extract function, reorganize folder |
+| **chore** | Perubahan non-fungsional: config, dependency, dokumentasi, test. | Update package version, tambah .env.example key, update README |
+
+> Jika ragu antara fix dan enhancement: **fix** = ada yang salah/rusak sebelumnya. **enhancement** = tidak ada yang salah, tapi sekarang lebih baik.
+
+---
+
+### 3. Identifikasi Task yang Relevan
+
+Baca `task/task_list.md` untuk menemukan task yang paling relevan.
+
+**Strategi matching:**
+- Cocokkan berdasarkan nama fitur / komponen yang disebut human
+- Cocokkan berdasarkan file yang berubah (mis. file di `codes/src/auth/` → cari task tentang Auth)
+- Jika ada beberapa kandidat task, pilih yang paling spesifik
+
+**Edge cases:**
+- **Tidak ada task yang cocok:** Buat log di file baru `task/untracked/[YYYY-MM-DD]_untracked_changes.md` dan beri tahu human bahwa perubahan ini belum punya task terdaftar.
+- **Perubahan lintas beberapa task:** Tulis log di setiap task yang relevan.
+- **Task list belum ada:** Beri tahu human dan tulis log ke `state/knowledge_base/change_log.md` sebagai fallback.
+
+---
+
+### 4. Tulis Log
+
+#### a) Update Status Log di Task Detail File
+Baca file `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`.
+Tambahkan baris baru di tabel **Status Log**:
+
+```
+| [YYYY-MM-DD HH:MM] | logger | [tipe: fix/enhancement/refactor/chore] | [deskripsi singkat 1 baris] |
+```
+
+Contoh:
+```
+| 2025-06-26 14:30 | logger | fix | Perbaiki validasi email yang tidak reject domain kosong |
+| 2025-06-26 14:30 | logger | enhancement | Tambah field `phone_number` opsional di form registrasi |
+```
+
+#### b) Tulis atau Update Dev Log
+Buka atau buat `task/[TASK-ID]_[nama-task]/dev_log.md`.
+
+Jika file belum ada, buat dengan header:
+```markdown
+# DEVELOPMENT LOG - [TASK-ID]: [Task Name]
+
+**Target Spec:** specifications/XXX_spec_*.md
+**Date:** [YYYY-MM-DD HH:MM] (first entry)
+**Status:** In Progress
+```
+
+Tambahkan entry baru di bagian **Revision History**:
+```markdown
+## [YYYY-MM-DD HH:MM] — [tipe]: [judul singkat]
+
+**Type:** fix / enhancement / refactor / chore
+**Changed by:** [human / agent name jika diketahui]
+
+### What Changed
+[Narasi singkat — apa yang berubah dan kenapa]
+
+### Files Affected
+- `[path/file]` — [apa yang berubah di file ini]
+
+### Notes
+[Catatan teknis jika ada — edge case, dependency, hal yang perlu diperhatikan]
+```
+
+#### c) Update `state/context.json`
+Perbarui field `notes` dengan ringkasan perubahan terbaru dan `last_updated` timestamp, `last_agent: "logger"`.
+
+---
+
+### 5. Konfirmasi ke Human
+
+Setelah selesai menulis, tampilkan ringkasan singkat:
+
+```
+✅ Logged ke TASK-XXX: [Nama Task]
+   Tipe  : fix / enhancement / refactor / chore
+   Apa   : [1 kalimat deskripsi]
+   File log: task/TASK-XXX_nama-task/dev_log.md
+```
+
+Jika ada ambiguitas yang masih perlu dikonfirmasi (mis. tipe tidak yakin, task tidak 100% cocok), tanyakan sekarang dan perbaiki jika perlu.
+
+---
+
+## PRINSIP
+
+- **Jangan block terlalu lama** — jika informasi cukup untuk 80% yakin, lanjut dan konfirmasi di akhir.
+- **Satu log entry per perubahan logis** — jika ada 3 perubahan berbeda dalam satu sesi, buat 3 entry terpisah.
+- **Deskripsi konkret** — tulis apa yang berubah, bukan "fixed bug" tapi "fixed bug: email validation tidak reject domain kosong".
+- **Tidak ada log yang dibuat-buat** — jika tidak ada perubahan nyata, katakan itu ke human daripada membuat log kosong.
+- **Selalu tanya minimal** — 1-2 pertanyaan klarifikasi maksimum sebelum mulai menulis log.
+
+---
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/orchestrator.md

@@ -22,6 +22,15 @@ Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline
 9. Invoke DevOps → environment setup (Dockerfile, docker-compose) jika dibutuhkan
 10. **GATE — Blueprint disetujui:** Human approve semua acuan. **API Contract wajib final.**
 
+### 🟦 Fase 1 (terfokus) — `/plan-feature "[Feature Description]" [depth=fast|standard|deep]`
+> Perencanaan **satu fitur** saja — mengasumsikan blueprint proyek sudah ada. Output: spesifikasi fitur lengkap di `specifications/`. Gunakan ini (bukan `/plan-project`) saat menambah fitur baru ke proyek yang sudah direncanakan.
+0. **PRECONDITION:** `project_overview.md` terisi & `specifications/000_spec_environment_setup.md` ada. Jika belum → arahkan human ke `/plan-project`, JANGAN lanjut.
+1. **Feature Discovery (INTERAKTIF, di thread utama)** → wawancara human khusus fitur: tujuan, aktor, ruang lingkup, **Non-Goals**, aturan bisnis, kriteria sukses. **JANGAN delegasikan ke subagent.**
+2. GATE: Human sign-off ruang lingkup & Non-Goals fitur.
+3. **Delta acuan (kondisional):** Data Architect (jika ada entitas/kolom baru) ∥ UX Designer (jika ada komponen UI baru) ∥ Security Mode S (jika `depth=deep` & data sensitif). Lewati bila tidak ada kebutuhan baru.
+4. Invoke Analyst → spesifikasi fitur lengkap di `specifications/NNN_...md` sesuai `schemas/specification.template.md` + Low-Entropy Gate. Atomicity + **API Contract final**.
+5. **GATE — Spec disetujui:** Human `Human Approval Status: approved`; API Contract final sebelum `/build-feature`.
+
 ### 🟩 Fase 2 — `/build-feature "[Feature Name]" [depth=fast|standard|deep]`
 > Implementasi satu fitur dari spec yang sudah ada.
 0. Invoke **Toolsmith** (mode `sync`, atau `switch` jika developer pindah tool) → pastikan skill + MCP workspace siap sebelum coding. Skip cepat jika `appliedTo` tool aktif sudah ter-set & tidak ada perubahan.
@@ -30,6 +39,7 @@ Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline
 3. **Implementasi (tergantung depth):**
    - `depth=fast` → Invoke **Fullstack** (fullstack tunggal)
    - `depth=standard|deep` → Invoke **Backend Engineer** ∥ **Frontend Engineer** (paralel, honor API Contract)
+   3b. **VERIFIKASI PASCA-IMPLEMENTASI:** Setelah subagent developer selesai, pastikan `task/[TASK-ID]_[nama-task]/dev_log.md` sudah ada dan `task/task_list.md` sudah diupdate ke status `ready_to_test`. Jika belum, minta subagent menyelesaikannya sebelum lanjut ke QA.
 4. Invoke QA → static review + unit test
 5. **GATE — Code review lulus:** Human review (pakai QA report sebagai referensi)
 
@@ -56,6 +66,15 @@ Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline
 #### `/setup-workspace [init|switch|sync] [tool=...]`
 > Provisioning workspace agentik (skill + MCP) via **Toolsmith**. Otomatis dipanggil di Fase 1 (step 3b) & Fase 2 (step 0), tapi bisa dipanggil manual kapan saja — terutama saat developer **pindah tool AI** (`switch tool=opencode`). Sumber kebenaran: `state/workspace-manifest.json`.
 
+#### `/build-prototype "[Screens/Feature]" [depth=fast|standard]`
+> Prototipe UI/UX cepat (frontend-only, data mock) untuk presentasi/menyepakati desain dengan klien. **Di luar 4 fase — throwaway/demo, tanpa backend/spec/API Contract.**
+0. Invoke **Toolsmith** → pastikan skill `ui-ux-pro-max` + `theme-factory` & MCP `shadcn` terpasang (mapping `prototype` di `schemas/workspace-registry.json`). Skip cepat jika sudah ter-apply.
+1. Brief prototipe (INTERAKTIF, di thread utama) → layar/alur + referensi visual. Opsional pra-kode: mockup inline `visualize`/Canva bila tool aktif punya.
+2. Arah visual (pilih satu): `design-system/` ada → pakai; belum ada + kilat → skill `theme-factory` (tema global instan); belum ada + lebih rapi → UX Designer (mode fast) via `ui-ux-pro-max`
+3. Frontend Engineer (mode prototype) → UI di `codes/` dengan data mock; tooling komplementer: `theme-factory` (tema) + `ui-ux-pro-max` (pola/komponen) + MCP `shadcn` (komponen jadi). Navigasi clickable — tanpa API/backend/test
+4. CHECKPOINT: Jalankan dev server, demo ke klien, kumpulkan feedback UI/UX, iterasi step 3 sampai disepakati
+5. Jika disepakati & lanjut ke produk → arahkan ke `/plan-feature` atau `/plan-project`
+
 #### `/deliver-feature "[Feature Name]" [depth=]`
 > Jalankan Fase 2 → Fase 3 berurutan untuk satu fitur (build lalu test), dengan gerbang di tiap fase.
 
@@ -68,10 +87,10 @@ Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline
 5. CHECKPOINT: Human review CHANGELOG & approve release tag
 
 #### `/start-fix "[Bug Description]" [depth=]`
-1. Invoke Fixer → analyze root cause & fix
-2. Invoke QA → quick review pada kode yang diubah
+1. Invoke Fixer → analisis root cause & fix. Teruskan deskripsi bug dari argumen. Jika `task/task_list.md` tidak ada, Fixer langsung diagnosa source code.
+2. Invoke QA → quick static review pada file yang diubah Fixer
 3. Invoke Tester → regression test
-4. CHECKPOINT: Human validation
+4. CHECKPOINT: Tampilkan ringkasan bug, root cause, file yang diubah — minta validasi human
 
 #### `/security-audit "[scope]"`
 > Audit keamanan ad-hoc di luar siklus release.

package/template/schemas/specification.template.md

@@ -7,39 +7,53 @@
 - **Depends on:** SPEC-YYY
 
 ## User Story
-Sebagai [role], saya ingin [action], sehingga [benefit].
+Sebagai [role konkret], saya ingin [action], sehingga [benefit].
+
+## Non-Goals / Out of Scope
+Daftar eksplisit apa yang TIDAK dikerjakan fitur ini (pagar ruang lingkup untuk developer).
+- ...
 
 ## Technical Flow
-1. [Langkah 1 — contoh: User submit form login]
+1. [Langkah 1 — satu aktor + satu aksi, contoh: User submit form login]
 2. [Langkah 2 — contoh: Backend validasi credentials]
 3. [Langkah 3 — contoh: Return JWT token]
 
 ## Acceptance Criteria
-- [ ] ...
-- [ ] ...
+Format Given/When/Then, tiap kriteria binary (lulus/gagal). Wajib mencakup happy path & failure path.
+- [ ] **Given** ... **When** ... **Then** ...
+- [ ] **Given** ... **When** ... **Then** ...
 
 ## API Contract
-### [METHOD] /api/endpoint
-**Request:**
-```json
-{}
-```
-**Response (200):**
+### [METHOD] /api/v1/endpoint
+- **Auth:** [public | Bearer JWT | ...]
+- **Success status:** [200 | 201 | ...]
+
+**Request** — setiap field: `nama` (casing sesuai konvensi project) · tipe · required? · constraint
+| Field | Type | Required | Constraint |
+|-------|------|----------|------------|
+| ... | ... | ... | ... |
+
 ```json
-{}
+{ "contoh": "nilai nyata, bukan kosong" }
 ```
-**Response (Error):**
+**Response (Success):**
 ```json
-{}
+{ "contoh": "nilai nyata" }
 ```
+**Response (Error)** — enumerasi setiap kondisi (HTTP status + kode error):
+| HTTP | Error Code | Kapan terjadi |
+|------|-----------|---------------|
+| 400 | VALIDATION_ERROR | ... |
+| 401 | ... | ... |
 
 ## Database Changes
-(Tabel baru, kolom baru, atau index yang dibutuhkan — atau tulis "None")
+Tabel/kolom/index baru — nama, tipe, nullability, default (harus cocok dengan `state/knowledge_base/data-model/`) — atau tulis "None".
 
 ## UI/UX
-(Screenshot mockup, deskripsi komponen, atau link ke desain — atau tulis "None")
+Rujuk komponen dari `state/knowledge_base/design-system/` dengan nama persis; sertakan state kosong/loading/error — atau tulis "None".
 
 ## Edge Cases & Validation
+Aturan validasi per field (batas, format, required/optional) + pesan/kode error persis.
 - [ ] ...
 
 ---

package/template/schemas/workspace-registry.json

@@ -5,6 +5,7 @@
   "stackMappings": {
     "_comment": "tech-stack / capability keyword -> recommended skills + mcp ids. Match loosely (case-insensitive substring) against project_overview tech stack & key features.",
     "ui|frontend|react|next|nextjs|vue|svelte|tailwind|shadcn": { "skills": ["ui-ux-pro-max"], "mcp": ["shadcn"] },
+    "prototype|mockup|wireframe|demo": { "skills": ["ui-ux-pro-max", "theme-factory"], "mcp": ["shadcn"] },
     "postgres|postgresql|prisma|sql|database": { "skills": [], "mcp": ["postgres"] },
     "e2e|test|testing|playwright|qa": { "skills": [], "mcp": ["playwright"] },
     "security|auth|oauth|pentest|owasp": { "skills": ["penetration-testing"], "mcp": [] },

package/template/specifications/.gitkeep

@@ -1 +1,3 @@
-# Place specification documents here. The contents of this folder are gitignored by default.
+# Keeps the specifications/ folder in the repository.
+# Specification files generated by the Analyst agent (e.g. 000_spec_environment_setup.md)
+# ARE tracked and should be committed — they are the source of truth for development.