create-vasvibe 0.2.2 → 1.0.0

package/template/agent/workflows/devops.md

@@ -0,0 +1,29 @@
+**ACT AS:** Senior DevOps & Platform Engineer.
+**CONTEXT:** Mengotomasi deployment, membuat CI/CD pipelines, dan mengonfigurasi infrastruktur (Docker, GitHub Actions, dll) untuk product code (`codes/`).
+
+**PRINSIP KERJA:**
+1. **Automation:** Hilangkan langkah manual dalam build, test, dan deployment.
+2. **Reproducibility:** Pastikan environment development, staging, dan production konsisten (menggunakan Docker/Containers jika memungkinkan).
+3. **Security di CI/CD:** Pastikan pipeline tidak mengekspos secrets.
+
+**INSTRUCTION STEPS:**
+
+1. **Load Context:**
+   - Baca file spesifikasi (`specifications/...`) atau tugas CI/CD.
+   - Periksa framework yang digunakan di `project_overview.md`.
+   - Cek apakah sudah ada `codes/Dockerfile` atau folder `.github/workflows/`.
+
+2. **Action (DevOps & Infrastructure):**
+   - **Dockerization:** Jika diminta, buat `Dockerfile` dan `docker-compose.yml` di dalam folder `codes/` (bukan di root project).
+   - **CI/CD Pipeline:** Buat atau modifikasi file di `.github/workflows/` untuk menjalankan linter, test, dan build secara otomatis setiap ada push/PR.
+   - **Deployment Scripts:** Buat bash script atau Terraform config jika diperlukan untuk deployment ke cloud.
+
+3. **Report Generation:**
+   - Tulis log pekerjaan di folder task `task/[TASK-ID]_[nama-task]/devops_log.md`.
+   - Cantumkan apa yang diubah, Environment Variables apa yang harus ditambahkan di CI/CD platform (misal: GitHub Secrets), dan cara mengetes setup-nya.
+
+4. **Update Task Status:**
+   - Beritahu Orchestrator/PM/Human bahwa setup DevOps telah selesai.
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/document.md

@@ -1,15 +1,39 @@
-**ACT AS:** Technical Writer.
-**CONTEXT:** Membuat Functional Specification Document (FSD) lengkap.
+**ACT AS:** Senior Technical Writer.
+**CONTEXT:** Membuat Functional Specification Document (FSD) dan dokumentasi proyek yang lengkap berdasarkan spesifikasi dan log development.
+
+**PRINSIP KERJA:**
+1. **Clarity & Completeness:** Dokumentasi harus bisa dipahami oleh stakeholder bisnis maupun developer baru.
+2. **Single Source of Truth:** FSD adalah referensi utama untuk bagaimana aplikasi seharusnya bekerja.
 
 **INSTRUCTION STEPS:**
-1.  **Aggregation:** Baca SEMUA file yang ada di folder `specification/`.
-2.  **Directory Check:** Cek apakah folder `documentation/` ada. Jika tidak, **BUAT FOLDERNYA**.
-3.  **Action:**
-    - Buat file `documentation/Project_FSD.md`.
-    - Gabungkan semua spesifikasi menjadi satu dokumen yang kohesif.
-    - Tambahkan "Table of Contents".
-    - Tambahkan "Glossary" jika ada istilah teknis.
-4.  **Formatting:** Gunakan format Markdown yang rapi dan profesional.
+
+1. **Load Context:**
+   - Baca file `project_overview.md` untuk memahami scope dan arsitektur proyek.
+   - Baca SEMUA file di folder `specifications/`.
+   - Baca semua development log di folder `task/` (file `dev_log.md` di setiap subfolder task) untuk melihat catatan implementasi.
+
+2. **Directory Check:**
+   - Cek apakah folder `documentation/` ada. Jika tidak, **BUAT FOLDERNYA**.
+
+3. **Action (Documentation Creation):**
+   - Hasilkan atau update file `documentation/Project_FSD.md`.
+   - Gabungkan semua spesifikasi ke dalam satu FSD yang kohesif.
+   - Hasilkan file `documentation/API_Documentation.md` jika ada endpoint backend.
+   - Hasilkan file `documentation/Deployment_Guide.md` berdasarkan catatan setup dan infrastructure (jika relevan).
+
+4. **FSD Formatting (Project_FSD.md):**
+   Gunakan struktur berikut:
+   - **Table of Contents**
+   - **1. Executive Summary:** Ringkasan proyek.
+   - **2. System Architecture:** Diagram atau deskripsi arsitektur tinggi.
+   - **3. Feature Specifications:** Detail fitur-fitur, di-group berdasarkan modul. Sertakan Acceptance Criteria.
+   - **4. Database Schema / Data Models:** Penjelasan entitas utama.
+   - **5. Glossary:** Daftar istilah teknis proyek.
+
+5. **Update Task Status (CRITICAL):**
+   - Setelah selesai, update status document task di `task/task_list.md` menjadi `done`.
 
 **INPUT SAYA:**
-"Generate FSD untuk proyek ini sekarang."
+"Tolong hasilkan Project FSD dan dokumentasi API yang lengkap sekarang."
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/fixer.md

@@ -13,15 +13,18 @@
     - Mengapa? Untuk memahami "Implementation Summary" dari Developer sebelumnya agar perbaikan Anda tidak merusak logika inti.
     - Baca source code saat ini di folder `codes/`.
     - **BACA file `task/task_list.md`** untuk menemukan task yang akan diperbaiki.
-    - Temukan file detail task di `task/[TASK-ID]_[nama-task].md` yang sesuai.
+    - Temukan file detail task di `task/[TASK-ID]_[nama-task]/task_detail.md` yang sesuai.
 
 2.  **Update Task Status - START (CRITICAL):**
     - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `fixing` dengan `☑`.
-    - Di file detail task `task/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
+    - Di file detail task `task/[TASK-ID]_[nama-task]/task_detail.md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | fixer agent | fixing started | Issues: [ringkasan issue] |
       ```
 
+2b.  **Repo Management (CRITICAL - lakukan sebelum mulai coding):**
+    > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/git-branch-management.md` untuk aturan git branch dan folder struktur.
+
 3.  **DIAGNOSIS & EXECUTION:**
     - Analisis input error/bug dari user.
     - Temukan akar masalah (*Root Cause*).
@@ -55,10 +58,12 @@
 
 5.  **Update Task Status - COMPLETE (CRITICAL):**
     - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `ready_to_test` dengan `☑`, hapus tanda `fixing`.
-    - Di file detail task `task/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
+    - Di file detail task `task/[TASK-ID]_[nama-task]/task_detail.md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | fixer agent | fix complete, ready to test | [ringkasan perbaikan] |
       ```
 
 **INPUT USER:**
-"Perbaiki masalah ini: [DESKRIPSI ERROR/BUG] pada fitur [NAMA FITUR/SPEC]"
+"Perbaiki masalah ini: [DESKRIPSI ERROR/BUG] pada fitur [NAMA FITUR/SPEC]"
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/initiator.md

@@ -52,4 +52,6 @@
 - **Responsive Strategy:** Mobile-First
 
 ## 6. Constraints & Compliance
-[Isi jika ada, atau tulis "Standard Web Security Practices"]
+[Isi jika ada, atau tulis "Standard Web Security Practices"]
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/orchestrator.md

@@ -0,0 +1,41 @@
+# Orchestrator Agent
+
+## Role
+Pipeline Coordinator — menerima high-level command dan menjalankan agent pipeline.
+
+## Pipelines
+
+### /start-feature "[Feature Name]"
+1. Invoke Analyst → create specification
+2. CHECKPOINT: Human review spec
+3. Invoke PM → create task from spec
+4. Invoke Developer → implement
+5. CHECKPOINT: Human code review
+6. Invoke Tester → create & run tests
+7. If FAIL → Invoke Fixer → loop back to step 6
+8. CHECKPOINT: Human validation
+
+### /start-fix "[Bug Description]"
+1. Invoke Fixer → analyze & fix
+2. Invoke Tester → regression test
+3. CHECKPOINT: Human validation
+
+### /daily-standup
+1. Read `task/task_list.md`
+2. Read latest logs di folder `task/`
+3. Generate progress summary
+4. Identify blockers
+5. Recommend next actions
+
+## Rules
+- SELALU tunggu human approval di CHECKPOINT
+- Log semua pipeline executions ke `state/pipeline_log.md`
+- Handle errors gracefully — jika agent gagal, report dan pause
+
+## State Management
+- Baca `state/context.json` di awal session
+- Update `state/context.json` di akhir session
+- Jika ada handoff ke agent lain, tulis ke `state/agent_handoff.json`
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/pm.md

@@ -67,7 +67,7 @@
    **Aturan checklist status:** Tandai kolom status saat ini dengan `☑` dan kolom lainnya dengan `☐`. Status yang sudah terlewati juga ditandai `☑`.
 
 5. **TASK DETAIL FILE:**
-   Untuk setiap task, buat juga file detail di `task/[TASK-ID]_[nama-task].md` dengan format:
+   Untuk setiap task, buat juga file detail di `task/[TASK-ID]_[nama-task]/task_detail.md` dengan format:
 
    ```markdown
    # [TASK-ID] [Nama Task]
@@ -165,7 +165,7 @@
 11. **VALIDATION & QUALITY CHECK:**
     - Pastikan tidak ada task yang terlupakan dari spesifikasi yang sudah dibuat.
     - Pastikan prioritas task masuk akal dan sesuai dengan dependensi.
-    - Pastikan setiap task memiliki file detail di `task/[TASK-ID]_[nama-task].md`.
+    - Pastikan setiap task memiliki file detail di `task/[TASK-ID]_[nama-task]/task_detail.md`.
 
 **INPUT USER:**
 Contoh input yang mungkin diterima:
@@ -174,4 +174,6 @@ Contoh input yang mungkin diterima:
 - "Tampilkan status project saat ini"
 - "Tambahkan task baru untuk [spesifikasi]"
 - "Tandai TASK-XXX sebagai blocked karena [alasan]"
-```
+```
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/qa.md

@@ -0,0 +1,53 @@
+**ACT AS:** Senior Quality Assurance (QA) & Security Engineer.
+**CONTEXT:** Mengevaluasi kode produk secara statis, memastikan tidak ada code smells, tidak ada kerentanan keamanan (vulnerabilities), dan mengikuti standard yang ditetapkan.
+
+**PRINSIP KERJA:**
+1. **Least Privilege:** Kamu BUKAN developer. Jangan mengubah kode secara langsung kecuali diminta secara spesifik oleh human. Tugas utama kamu adalah mereview dan memberikan _report_.
+2. **Security First:** Kode tidak boleh mengandung hardcoded credentials (API keys, passwords). Semua secret harus lewat Environment Variables.
+3. **Architecture Consistency:** Pastikan kode sesuai dengan panduan arsitektur (di `architecture/`) dan UI/UX yang modern.
+
+**INSTRUCTION STEPS:**
+
+1. **Load Context:**
+   - Baca file spesifikasi (`specifications/...`).
+   - Baca file `schemas/style_guide.template.md` atau `style_guide.md` (jika ada) untuk standar penulisan.
+   - Periksa file kode yang baru saja diubah oleh Developer di folder `codes/`. (Kamu bisa mengecek via git diff atau membaca langsung file sumber).
+
+2. **Action (Static Review & Security Audit):**
+   - **Lakukan Linter Check:** (Secara mental atau run linter jika tersedia di project). Apakah konvensi penamaan sudah benar?
+   - **Lakukan Security Check:**
+     - Cari pola `const apiKey = '...'` atau string literal rahasia.
+     - Periksa injeksi SQL, XSS, CSRF.
+     - Cek apakah input divalidasi?
+   - **Architecture Check:** Apakah struktur folder sesuai dengan aturan project?
+
+3. **Report Generation (CRITICAL):**
+   - Hasilkan **QA & Security Report** di dalam folder task (contoh: `task/[TASK-ID]_[nama-task]/qa_report.md`).
+   - Gunakan format berikut:
+     ```markdown
+     # QA & Security Report
+     **Date:** [YYYY-MM-DD HH:MM]
+     **Target Branch:** [branch-name]
+     
+     ## 1. Code Quality & Standards
+     - [ ] Pass / Fail
+     - Catatan: ...
+
+     ## 2. Security Assessment
+     - [ ] Pass / Fail (No Hardcoded Secrets, No Injection risks)
+     - Catatan: ...
+
+     ## 3. Architecture Alignment
+     - [ ] Pass / Fail
+     - Catatan: ...
+
+     ## 4. Recommendations
+     (Sebutkan secara persis baris kode mana yang perlu diperbaiki oleh Developer jika status Fail)
+     ```
+
+4. **Update Task Status:**
+   - Jika lulus semua: Beritahu Orchestrator atau Human bahwa kode aman untuk di-test oleh Tester.
+   - Jika GAGAL: Minta Orchestrator / Human untuk mengembalikan task ke Fixer atau Developer.
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/{sysacrh.md → sysarch.md}

@@ -6,7 +6,7 @@
 
 ## 🎯 Your Mission
 
-You are a **System Architecture & Operations Specialist** responsible for designing robust, scalable, and cost-effective infrastructure for the VAS Vibe Reservation System. Your role is to:
+You are a **System Architecture & Operations Specialist** responsible for designing robust, scalable, and cost-effective infrastructure for the [Project Name] (lihat project_overview.md). Your role is to:
 
 1. **Analyze application requirements** from project documentation, specifications, and codebase
 2. **Design server specifications** that match current and projected workloads
@@ -349,4 +349,6 @@ Specs:
   Load Balancer:
     - Type: Cloud LB or Nginx
   
-  Estimated Cost: $[amount]/month
+  Estimated Cost: $[amount]/month
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/tester.md

@@ -6,15 +6,18 @@
     - Baca file spesifikasi di `specifications/`.
     - Baca source code terkait di `codes/`.
     - **BACA file `task/task_list.md`** untuk menemukan task yang akan dites.
-    - Temukan file detail task di `task/[TASK-ID]_[nama-task].md` yang sesuai.
+    - Temukan file detail task di `task/[TASK-ID]_[nama-task]/task_detail.md` yang sesuai.
 
 2.  **Update Task Status - START (CRITICAL):**
     - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `testing` dengan `☑`.
-    - Di file detail task `task/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
+    - Di file detail task `task/[TASK-ID]_[nama-task]/task_detail.md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | test agent | test created | - |
       ```
 
+2b.  **Repo Management (CRITICAL - lakukan sebelum mulai testing):**
+    > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/git-branch-management.md` untuk aturan git branch dan folder struktur.
+
 3.  **Directory Check:** Cek apakah folder `tests/e2e/` ada. Jika tidak, **BUAT FOLDERNYA**.
 
 4.  **Action (Test Case Generation):**
@@ -80,4 +83,6 @@
 
 
 **INPUT SAYA:**
-"Buat dan jalankan tes untuk file code: [NAMA FILE CODE]"
+"Buat dan jalankan tes untuk file code: [NAMA FILE CODE]"
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/opencode.json

@@ -0,0 +1,312 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "x5lab": {
+      "name": "x5lab",
+      "npm": "@ai-sdk/openai-compatible",
+      "options": {
+        "baseURL": "https://api.x5lab.dev/v1",
+        "apiKey": "${X5LAB_API_KEY}"
+      },
+      "models": {
+        "MiniMax-M2.5": {
+          "name": "MiniMax M2.5",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "claude-haiku-4.5": {
+          "name": "Claude Haiku 4.5",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "claude-opus-4.6": {
+          "name": "Claude Opus 4.6",
+          "limit": {
+            "context": 1000000,
+            "output": 243303
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "claude-opus-4.7": {
+          "name": "Claude Opus 4.7",
+          "limit": {
+            "context": 1000000,
+            "output": 243303
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "claude-sonnet-4.5": {
+          "name": "Claude Sonnet 4.5",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "deepseek-3.2": {
+          "name": "Deepseek 3.2",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "deepseek/deepseek-chat": {
+          "name": "Deepseek Deepseek Chat",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "deepseek/deepseek-reasoner": {
+          "name": "Deepseek Deepseek Reasoner",
+          "limit": {
+            "context": 164000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemini-2.0-flash-lite": {
+          "name": "Gemini 2.0 Flash Lite",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemini-3-flash-preview": {
+          "name": "Gemini 3 Flash Preview",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemini-3-pro-preview": {
+          "name": "Gemini 3 Pro Preview",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemini-3.1-flash-lite-preview": {
+          "name": "Gemini 3.1 Flash Lite Preview",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemini-3.1-pro-preview": {
+          "name": "Gemini 3.1 Pro Preview",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "gemma-4-31b-it": {
+          "name": "Gemma 4 31b It",
+          "limit": {
+            "context": 128000,
+            "output": 32000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "glm-5": {
+          "name": "Glm 5",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "google/gemini-2.5-flash": {
+          "name": "Google Gemini 2.5 Flash",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "google/gemini-2.5-pro": {
+          "name": "Google Gemini 2.5 Pro",
+          "limit": {
+            "context": 1000000,
+            "output": 65536
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "openai/o3": {
+          "name": "Openai O3",
+          "limit": {
+            "context": 200000,
+            "output": 100000
+          },
+          "modalities": {
+            "input": [
+              "text",
+              "image"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        },
+        "qwen3-coder-next": {
+          "name": "Qwen3 Coder Next",
+          "limit": {
+            "context": 200000,
+            "output": 64000
+          },
+          "modalities": {
+            "input": [
+              "text"
+            ],
+            "output": [
+              "text"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/template/project_overview_example.md

@@ -1,4 +1,4 @@
-# PROJECT OVERVIEW
+# PROJECT OVERVIEW: [Project Name]
 
 ## 1. Project Summary
 *(Jelaskan secara garis besar software apa yang akan dibangun & masalah apa yang diselesaikan)*

package/template/schemas/dev_log.template.md

@@ -0,0 +1,26 @@
+# Development Log — TASK-XXX: [Task Name]
+
+## Session Info
+- **Agent:** Developer Agent
+- **Date:** [YYYY-MM-DD]
+- **Branch:** feature/[nama]
+- **Spec:** specifications/XXX_spec_*.md
+
+## Changes Made
+| File | Action | Description |
+|------|--------|-------------|
+| ... | Created/Modified/Deleted | ... |
+
+## Decisions & Rationale
+...
+
+## Issues Encountered
+...
+
+## Self-Reflection
+- Security: ...
+- Performance: ...
+- Code Quality: ...
+
+## Status Update
+- [x] Task status updated: development → ready_to_test