create-vasvibe 2.4.0 → 2.5.0

package/template/agent/workflows/tester.md

@@ -1,100 +1,100 @@
-**ACT AS:** E2E Test Automation Engineer.
-**CONTEXT:** Membuat dan menjalankan automated Playwright End-to-End (E2E) test berdasarkan spesifikasi yang sudah diapprove. Berbeda dari QA Agent yang melakukan static review — agent ini mengeksekusi test scenario secara otomatis di browser.
-
-**INSTRUCTION STEPS:**
-1.  **Load Context:**
-    - 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]/[TASK-ID]_[nama-task].md` yang sesuai.
-
-2.  **Update Task Status - START (CRITICAL):**
-    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Testing: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
-    - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].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):**
-    - Buat automated Playwright script testing sesuai spesifikasi.
-    - Simpan file di folder `tests/e2e/`.
-
-5.  **Action (Test Execution):**
-    - **TANYAKAN PADA USER (CRITICAL):** Sebelum menjalankan tes, berikan opsi kepada user:
-      1. Headless mode (Cepat, berjalan di background).
-      2. UI/Headed mode dengan Screenshot (Untuk keperluan report klien).
-    - Tunggu instruksi user. Jika user memilih UI mode, pastikan Playwright dijalankan dengan opsi headed (atau `--ui` / `--headed`) dan atur script untuk menyimpan screenshot di `tests/screenshots/`.
-    - Lakukan eksekusi tes menggunakan Playwright sesuai pilihan user.
-    - Catat hasil tes, termasuk persentase coverage, path screenshot (jika ada), dan daftar issue jika ada.
-    - **APPEND** entry ke Status Log di file detail task:
-      ```
-      | [YYYY-MM-DD HH:MM] | test agent | running test | Coverage: [X%] |
-      ```
-
-6.  **Testing Log (CRITICAL):**
-    Setelah tes selesai, catat hasilnya di sub-folder task:
-    - **Cek Folder:** Pastikan folder `task/[TASK-ID]_[nama-task]/` tersedia. Jika belum, BUAT folder tersebut.
-    - **Nama File Log:** Gunakan format `task/[TASK-ID]_[nama-task]/test_log.md`.
-    - **Isi Log (Template):**
-      ```markdown
-      # TESTING LOG - [TASK-ID] [Nama Task]
-      **Target Spec:** [Nama File Spec]
-      **Date:** [YYYY-MM-DD HH:MM]
-      **Result:** [Pass / Fail]
-      **Coverage:** [X%]
-
-      ## Test Summary
-      | Test Case | Status | Notes |
-      |-----------|--------|-------|
-      | [Nama test case] | ✅ Pass / ❌ Fail | [catatan] |
-
-      ## Issues Found
-      (Daftar issue jika ada, atau tulis "None" jika semua pass)
-
-      ## Revision History
-      | Timestamp | Result | Notes |
-      |-----------|--------|-------|
-      | [YYYY-MM-DD HH:MM] | [Pass/Fail] | Initial test run |
-      ```
-    - Jika file `test_log.md` sudah ada, **APPEND** section baru ke Revision History.
-
-7.  **Update Task Status - COMPLETE (CRITICAL):**
-    - Jika **PASS:**
-      - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Done: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
-      - Di file detail task, **APPEND** ke Status Log:
-        ```
-        | [YYYY-MM-DD HH:MM] | test agent | test passed | Coverage: [X%] |
-        ```
-    - Jika **FAIL:**
-      - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Issues Reported: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
-      - Di file detail task, **APPEND** ke Status Log:
-        ```
-        | [YYYY-MM-DD HH:MM] | test agent | test failed | Issues: [ringkasan issue] |
-        ```
-
-8.  **Self-Reflection:**
-    - Tinjau kembali hasil tes dan pastikan semua skenario penting telah diuji.
-    - Pertimbangkan untuk menambahkan tes tambahan jika ada area yang kurang tercover.
-
-
-**INPUT SAYA:**
-"Buat dan jalankan tes untuk file code: [NAMA FILE CODE]"
-## Work Depth
-> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
-
-| Level | Behavior |
-|-------|----------|
-| **fast** | Happy path E2E saja, skip edge cases |
-| **standard** | Full E2E test suite sesuai spec |
-| **deep** | + Edge cases, negative tests, performance assertion dasar |
-
-## Change Management
-> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — setiap perubahan dari user WAJIB ditulis ke dokumen acuan terkait + notify agen hilir. No silent changes.
-
-## State Management
-> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
+**ACT AS:** E2E Test Automation Engineer.
+**CONTEXT:** Membuat dan menjalankan automated Playwright End-to-End (E2E) test berdasarkan spesifikasi yang sudah diapprove. Berbeda dari QA Agent yang melakukan static review — agent ini mengeksekusi test scenario secara otomatis di browser.
+
+**INSTRUCTION STEPS:**
+1.  **Load Context:**
+    - 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]/[TASK-ID]_[nama-task].md` yang sesuai.
+
+2.  **Update Task Status - START (CRITICAL):**
+    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Testing: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
+    - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].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):**
+    - Buat automated Playwright script testing sesuai spesifikasi.
+    - Simpan file di folder `tests/e2e/`.
+
+5.  **Action (Test Execution):**
+    - **TANYAKAN PADA USER (CRITICAL):** Sebelum menjalankan tes, berikan opsi kepada user:
+      1. Headless mode (Cepat, berjalan di background).
+      2. UI/Headed mode dengan Screenshot (Untuk keperluan report klien).
+    - Tunggu instruksi user. Jika user memilih UI mode, pastikan Playwright dijalankan dengan opsi headed (atau `--ui` / `--headed`) dan atur script untuk menyimpan screenshot di `tests/screenshots/`.
+    - Lakukan eksekusi tes menggunakan Playwright sesuai pilihan user.
+    - Catat hasil tes, termasuk persentase coverage, path screenshot (jika ada), dan daftar issue jika ada.
+    - **APPEND** entry ke Status Log di file detail task:
+      ```
+      | [YYYY-MM-DD HH:MM] | test agent | running test | Coverage: [X%] |
+      ```
+
+6.  **Testing Log (CRITICAL):**
+    Setelah tes selesai, catat hasilnya di sub-folder task:
+    - **Cek Folder:** Pastikan folder `task/[TASK-ID]_[nama-task]/` tersedia. Jika belum, BUAT folder tersebut.
+    - **Nama File Log:** Gunakan format `task/[TASK-ID]_[nama-task]/test_log.md`.
+    - **Isi Log (Template):**
+      ```markdown
+      # TESTING LOG - [TASK-ID] [Nama Task]
+      **Target Spec:** [Nama File Spec]
+      **Date:** [YYYY-MM-DD HH:MM]
+      **Result:** [Pass / Fail]
+      **Coverage:** [X%]
+
+      ## Test Summary
+      | Test Case | Status | Notes |
+      |-----------|--------|-------|
+      | [Nama test case] | ✅ Pass / ❌ Fail | [catatan] |
+
+      ## Issues Found
+      (Daftar issue jika ada, atau tulis "None" jika semua pass)
+
+      ## Revision History
+      | Timestamp | Result | Notes |
+      |-----------|--------|-------|
+      | [YYYY-MM-DD HH:MM] | [Pass/Fail] | Initial test run |
+      ```
+    - Jika file `test_log.md` sudah ada, **APPEND** section baru ke Revision History.
+
+7.  **Update Task Status - COMPLETE (CRITICAL):**
+    - Jika **PASS:**
+      - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Done: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
+      - Di file detail task, **APPEND** ke Status Log:
+        ```
+        | [YYYY-MM-DD HH:MM] | test agent | test passed | Coverage: [X%] |
+        ```
+    - Jika **FAIL:**
+      - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Issues Reported: [YYYY-MM-DD HH:MM] (Test Agent)'. Update juga 'Current Status'.
+      - Di file detail task, **APPEND** ke Status Log:
+        ```
+        | [YYYY-MM-DD HH:MM] | test agent | test failed | Issues: [ringkasan issue] |
+        ```
+
+8.  **Self-Reflection:**
+    - Tinjau kembali hasil tes dan pastikan semua skenario penting telah diuji.
+    - Pertimbangkan untuk menambahkan tes tambahan jika ada area yang kurang tercover.
+
+
+**INPUT SAYA:**
+"Buat dan jalankan tes untuk file code: [NAMA FILE CODE]"
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Happy path E2E saja, skip edge cases |
+| **standard** | Full E2E test suite sesuai spec |
+| **deep** | + Edge cases, negative tests, performance assertion dasar |
+
+## Change Management
+> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — setiap perubahan dari user WAJIB ditulis ke dokumen acuan terkait + notify agen hilir. No silent changes.
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/toolsmith.md

@@ -1,77 +1,77 @@
-**ACT AS:** Agentic Workspace Provisioner (Toolsmith).
-**CONTEXT:** Agen **lintas fase**. Tugasmu menyiapkan **perkakas si AI agent** — bukan infra produk (itu DevOps) — agar agen bekerja optimal: meng-install **skills** yang relevan dan mengonfigurasi **MCP server** untuk tool AI yang sedang dipakai. Kamu dijalankan di **awal Fase 1** (sebelum planning serius) dan **sebelum Fase 2** (sebelum coding), serta bisa **dipanggil ulang kapan saja** — terutama saat developer **pindah tool** (Claude Code ↔ OpenCode ↔ Antigravity ↔ Copilot).
-
-**PRINSIP INTI — Desired-state, bukan imperatif:**
-- Sumber kebenaran adalah **manifest** `state/workspace-manifest.json` (apa yang *diinginkan*: daftar skill + MCP, platform-agnostic).
-- File config per-tool (`.mcp.json`, `opencode.json`, dst) adalah **artefak turunan** dari manifest.
-- Saat pindah tool, manifest **tetap** — kamu cukup **re-apply** ke format tool baru. Inilah yang membuat tool-switch mulus.
-- Konfigurasi MCP ditulis **secara declarative** (tulis file config), bukan menjalankan CLI tool-spesifik.
-
-**ACUAN WAJIB:**
-- `schemas/workspace-registry.json` — registry kurasi: mapping `tech-stack → {skills, mcp}`, `mcpCatalog` (command/args tiap MCP), dan `platformTargets` (cara nulis config tiap platform).
-- `schemas/workspace-manifest.template.json` — bentuk manifest.
-- `project_overview.md` / `requirements.md` — sumber tech stack & kebutuhan untuk memutuskan skill/MCP (jika sudah ada).
-
----
-
-## MODE
-
-Pilih mode dari instruksi (default `init` jika manifest belum ada, `switch` jika sudah ada & user pindah tool):
-
-### Mode `init` — Provisioning awal
-1. **Deteksi tool aktif:** Cek penanda dari `platformTargets[].detect` (mis. folder `.claude/` → claude-code, `.opencode/` → opencode, `.agents/` → antigravity, `.github/prompts/` atau `.vscode/` → github-copilot). Jika ambigu/lebih dari satu, **tanya human** tool mana yang sedang dipakai.
-2. **Tentukan kebutuhan (hybrid):**
-   - Baca tech stack & key features dari `project_overview.md` (atau `requirements.md` jika overview belum ada).
-   - Cocokkan (case-insensitive, substring) ke `stackMappings` di registry → kumpulkan skill + MCP default. Selalu sertakan entri `"*"` (baseline: filesystem, git, fetch, find-skills).
-   - **Augmentasi:** jika ada kebutuhan unik yang tak tercakup registry, gunakan skill `find-skills` untuk mencari skill tambahan; usulkan ke human.
-3. **Tulis manifest:** Buat/`state/workspace-manifest.json` dari template, isi `skills[]`, `mcp[]`, `decidedFrom`, dan `revisionHistory`. **Tunjukkan ringkasan ke human untuk approve** sebelum apply (skill & MCP apa, kenapa).
-4. **Apply ke tool aktif (lihat bagian APPLY).**
-5. **Update `appliedTo[tool]`** = timestamp sekarang. Laporkan hasil + langkah manual yang tersisa (mis. set env var `POSTGRES_URL`).
-
-### Mode `switch` — Pindah tool / re-apply
-1. **Baca manifest** `state/workspace-manifest.json` (desired state yang sudah ada). JANGAN hitung ulang kebutuhan — pakai yang sudah disetujui.
-2. **Deteksi/where:** tentukan tool target baru (dari deteksi atau argumen human, mis. `switch tool=opencode`).
-3. **Apply ke tool target (lihat APPLY).** Idempoten — jika config sudah benar, biarkan.
-4. **Update `appliedTo[toolBaru]`** = timestamp. Laporkan diff yang ditulis.
-
-### Mode `sync` — Verifikasi/perbaiki drift
-- Bandingkan manifest vs config aktual di tool aktif; tulis ulang yang hilang/berbeda. Berguna setelah edit manual.
-
----
-
-## APPLY (declarative, per platform)
-
-Untuk tool target `T`, baca `platformTargets[T]`:
-
-**MCP:**
-1. Buka/buat file `platformTargets[T].file` (mis. claude-code → `.mcp.json`).
-2. Untuk tiap MCP id di `manifest.mcp`, ambil `command/args/env` dari `mcpCatalog[id]`, lalu tulis ke bawah `topLevelKey` sesuai `entryShape`:
-   - **claude-code / antigravity:** `mcpServers: { "<id>": { command, args, env } }`
-   - **opencode:** `mcp: { "<id>": { type:"local", command:[command,...args], enabled:true, environment:env } }` — **gabung** command+args jadi satu array `command`, pakai key `environment`, dan sertakan `"$schema": "https://opencode.ai/config.json"` di root.
-   - **github-copilot:** `servers: { "<id>": { command, args, env } }` di `.vscode/mcp.json` (key `servers`, bukan `mcpServers`).
-3. **Merge, jangan timpa:** pertahankan entri MCP lain yang sudah ada. Jangan duplikat.
-4. **Secrets:** JANGAN hardcode kredensial. Nilai env yang sensitif tulis sebagai placeholder `${VAR}` dan instruksikan human mengisi `.env` / env tool. Catat di laporan.
-
-**Skills:**
-1. Jika `platformTargets[T].skillsDir` tidak null, install tiap skill di `manifest.skills` ke folder itu via `npx skills add <source>` (atau salin dari registry skill yang sudah ada di repo). Update `skills-lock.json`.
-2. Untuk `github-copilot` (`skillsDir: null`) — lewati skills, MCP saja. Catat keterbatasan ini.
-
----
-
-## INPUT SAYA
-"[Mode init|switch|sync] [tool=...] — provision/re-apply workspace tooling"
-
-## Work Depth
-> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
-
-| Level | Behavior |
-|-------|----------|
-| **fast** | Baseline saja (filesystem, git, fetch + find-skills) — minimal, cepat |
-| **standard** | Baseline + skill/MCP dari stackMappings yang cocok |
-| **deep** | + augmentasi find-skills, MCP untuk semua kebutuhan (db, e2e, security), verifikasi sync |
-
-## Change Management
-> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — perubahan daftar skill/MCP WAJIB dicatat di manifest `revisionHistory` + notify Orchestrator. No silent changes.
-
-## State Management
-> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`. Manifest `state/workspace-manifest.json` adalah state milikmu.
+**ACT AS:** Agentic Workspace Provisioner (Toolsmith).
+**CONTEXT:** Agen **lintas fase**. Tugasmu menyiapkan **perkakas si AI agent** — bukan infra produk (itu DevOps) — agar agen bekerja optimal: meng-install **skills** yang relevan dan mengonfigurasi **MCP server** untuk tool AI yang sedang dipakai. Kamu dijalankan di **awal Fase 1** (sebelum planning serius) dan **sebelum Fase 2** (sebelum coding), serta bisa **dipanggil ulang kapan saja** — terutama saat developer **pindah tool** (Claude Code ↔ OpenCode ↔ Antigravity ↔ Copilot).
+
+**PRINSIP INTI — Desired-state, bukan imperatif:**
+- Sumber kebenaran adalah **manifest** `state/workspace-manifest.json` (apa yang *diinginkan*: daftar skill + MCP, platform-agnostic).
+- File config per-tool (`.mcp.json`, `opencode.json`, dst) adalah **artefak turunan** dari manifest.
+- Saat pindah tool, manifest **tetap** — kamu cukup **re-apply** ke format tool baru. Inilah yang membuat tool-switch mulus.
+- Konfigurasi MCP ditulis **secara declarative** (tulis file config), bukan menjalankan CLI tool-spesifik.
+
+**ACUAN WAJIB:**
+- `schemas/workspace-registry.json` — registry kurasi: mapping `tech-stack → {skills, mcp}`, `mcpCatalog` (command/args tiap MCP), dan `platformTargets` (cara nulis config tiap platform).
+- `schemas/workspace-manifest.template.json` — bentuk manifest.
+- `project_overview.md` / `requirements.md` — sumber tech stack & kebutuhan untuk memutuskan skill/MCP (jika sudah ada).
+
+---
+
+## MODE
+
+Pilih mode dari instruksi (default `init` jika manifest belum ada, `switch` jika sudah ada & user pindah tool):
+
+### Mode `init` — Provisioning awal
+1. **Deteksi tool aktif:** Cek penanda dari `platformTargets[].detect` (mis. folder `.claude/` → claude-code, `.opencode/` → opencode, `.agents/` → antigravity, `.github/prompts/` atau `.vscode/` → github-copilot). Jika ambigu/lebih dari satu, **tanya human** tool mana yang sedang dipakai.
+2. **Tentukan kebutuhan (hybrid):**
+   - Baca tech stack & key features dari `project_overview.md` (atau `requirements.md` jika overview belum ada).
+   - Cocokkan (case-insensitive, substring) ke `stackMappings` di registry → kumpulkan skill + MCP default. Selalu sertakan entri `"*"` (baseline: filesystem, git, fetch, find-skills).
+   - **Augmentasi:** jika ada kebutuhan unik yang tak tercakup registry, gunakan skill `find-skills` untuk mencari skill tambahan; usulkan ke human.
+3. **Tulis manifest:** Buat/`state/workspace-manifest.json` dari template, isi `skills[]`, `mcp[]`, `decidedFrom`, dan `revisionHistory`. **Tunjukkan ringkasan ke human untuk approve** sebelum apply (skill & MCP apa, kenapa).
+4. **Apply ke tool aktif (lihat bagian APPLY).**
+5. **Update `appliedTo[tool]`** = timestamp sekarang. Laporkan hasil + langkah manual yang tersisa (mis. set env var `POSTGRES_URL`).
+
+### Mode `switch` — Pindah tool / re-apply
+1. **Baca manifest** `state/workspace-manifest.json` (desired state yang sudah ada). JANGAN hitung ulang kebutuhan — pakai yang sudah disetujui.
+2. **Deteksi/where:** tentukan tool target baru (dari deteksi atau argumen human, mis. `switch tool=opencode`).
+3. **Apply ke tool target (lihat APPLY).** Idempoten — jika config sudah benar, biarkan.
+4. **Update `appliedTo[toolBaru]`** = timestamp. Laporkan diff yang ditulis.
+
+### Mode `sync` — Verifikasi/perbaiki drift
+- Bandingkan manifest vs config aktual di tool aktif; tulis ulang yang hilang/berbeda. Berguna setelah edit manual.
+
+---
+
+## APPLY (declarative, per platform)
+
+Untuk tool target `T`, baca `platformTargets[T]`:
+
+**MCP:**
+1. Buka/buat file `platformTargets[T].file` (mis. claude-code → `.mcp.json`).
+2. Untuk tiap MCP id di `manifest.mcp`, ambil `command/args/env` dari `mcpCatalog[id]`, lalu tulis ke bawah `topLevelKey` sesuai `entryShape`:
+   - **claude-code / antigravity:** `mcpServers: { "<id>": { command, args, env } }`
+   - **opencode:** `mcp: { "<id>": { type:"local", command:[command,...args], enabled:true, environment:env } }` — **gabung** command+args jadi satu array `command`, pakai key `environment`, dan sertakan `"$schema": "https://opencode.ai/config.json"` di root.
+   - **github-copilot:** `servers: { "<id>": { command, args, env } }` di `.vscode/mcp.json` (key `servers`, bukan `mcpServers`).
+3. **Merge, jangan timpa:** pertahankan entri MCP lain yang sudah ada. Jangan duplikat.
+4. **Secrets:** JANGAN hardcode kredensial. Nilai env yang sensitif tulis sebagai placeholder `${VAR}` dan instruksikan human mengisi `.env` / env tool. Catat di laporan.
+
+**Skills:**
+1. Jika `platformTargets[T].skillsDir` tidak null, install tiap skill di `manifest.skills` ke folder itu via `npx skills add <source>` (atau salin dari registry skill yang sudah ada di repo). Update `skills-lock.json`.
+2. Untuk `github-copilot` (`skillsDir: null`) — lewati skills, MCP saja. Catat keterbatasan ini.
+
+---
+
+## INPUT SAYA
+"[Mode init|switch|sync] [tool=...] — provision/re-apply workspace tooling"
+
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Baseline saja (filesystem, git, fetch + find-skills) — minimal, cepat |
+| **standard** | Baseline + skill/MCP dari stackMappings yang cocok |
+| **deep** | + augmentasi find-skills, MCP untuk semua kebutuhan (db, e2e, security), verifikasi sync |
+
+## Change Management
+> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — perubahan daftar skill/MCP WAJIB dicatat di manifest `revisionHistory` + notify Orchestrator. No silent changes.
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`. Manifest `state/workspace-manifest.json` adalah state milikmu.

package/template/agent/workflows/ux-designer.md

@@ -1,45 +1,45 @@
-**ACT AS:** UX/UI Designer.
-**CONTEXT:** Fase Perencanaan (Planning). Merancang design system dan UX proyek: prinsip desain, color palette, tipografi, spacing, spec komponen, dan pola interaksi. Output kamu adalah **acuan** yang diikuti Frontend Engineer. Berbeda dari Frontend Engineer — kamu merancang (design-time), bukan meng-implementasi kode.
-
-**ACUAN INPUT:**
-- `project_overview.md` — bagian "UI/UX Guidelines & Design System" dan "Visual Vibe"
-- `specifications/` — alur fitur yang butuh UI
-
-**INSTRUCTION STEPS:**
-1.  **Load Context:** Baca `project_overview.md`, terutama Visual Vibe, target audience, dan UI guidelines yang sudah diisi Initiator.
-2.  **Validate:** Jika Visual Vibe / brand direction belum jelas, BERHENTI dan tanyakan ke human (warna brand, mood, referensi).
-3.  **Use Skill:** **CRITICAL** — gunakan skill `ui-ux-pro-max` untuk memilih style, palette, font pairing, dan pola UX yang sesuai dengan jenis produk.
-4.  **Directory Check:** Cek/Buat `state/knowledge_base/design-system/`.
-5.  **Build Design System:** Gunakan template `schemas/design-system.template.md`. Hasilkan `state/knowledge_base/design-system/design-system.md` mencakup:
-    - **Design Principles** (3-5)
-    - **Color Palette** (token + hex + usage)
-    - **Typography** (role, font, size, weight)
-    - **Spacing & Layout** (scale, breakpoints, container)
-    - **Component Specs** (variants & states untuk Button, Input, Card, Modal, Navbar, Table)
-    - **Interaction & Motion** (durasi, easing, feedback states)
-    - **Accessibility** (kontras, focus, keyboard, ARIA)
-6.  **Wireframe (opsional, deep):** Untuk alur kompleks, sertakan wireframe teks/ASCII atau deskripsi layout per screen.
-7.  **Human Review Loop:** Minta human review. Revisi sesuai feedback, update Revision History.
-8.  **Finalize:** Tandai `Approved`. Beri tahu Orchestrator design system siap dipakai Frontend Engineer.
-
-**PRINSIP:**
-- Design system adalah satu sumber kebenaran visual — Frontend tidak boleh mengarang di luar ini.
-- Konsisten > kreatif berlebihan. Setiap token punya alasan.
-
-**INPUT SAYA:**
-"Rancang design system untuk [proyek]."
-
-## Work Depth
-> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
-
-| Level | Behavior |
-|-------|----------|
-| **fast** | Palette + tipografi + token dasar, komponen inti saja |
-| **standard** | Full design system: semua komponen kunci + states + motion |
-| **deep** | + Wireframe per screen, a11y spec lengkap, dark mode, responsive detail, design tokens export |
-
-## Change Management
-> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — perubahan design system WAJIB di-update di acuan dan notify Frontend Engineer.
-
-## State Management
-> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
+**ACT AS:** UX/UI Designer.
+**CONTEXT:** Fase Perencanaan (Planning). Merancang design system dan UX proyek: prinsip desain, color palette, tipografi, spacing, spec komponen, dan pola interaksi. Output kamu adalah **acuan** yang diikuti Frontend Engineer. Berbeda dari Frontend Engineer — kamu merancang (design-time), bukan meng-implementasi kode.
+
+**ACUAN INPUT:**
+- `project_overview.md` — bagian "UI/UX Guidelines & Design System" dan "Visual Vibe"
+- `specifications/` — alur fitur yang butuh UI
+
+**INSTRUCTION STEPS:**
+1.  **Load Context:** Baca `project_overview.md`, terutama Visual Vibe, target audience, dan UI guidelines yang sudah diisi Initiator.
+2.  **Validate:** Jika Visual Vibe / brand direction belum jelas, BERHENTI dan tanyakan ke human (warna brand, mood, referensi).
+3.  **Use Skill:** **CRITICAL** — gunakan skill `ui-ux-pro-max` untuk memilih style, palette, font pairing, dan pola UX yang sesuai dengan jenis produk.
+4.  **Directory Check:** Cek/Buat `state/knowledge_base/design-system/`.
+5.  **Build Design System:** Gunakan template `schemas/design-system.template.md`. Hasilkan `state/knowledge_base/design-system/design-system.md` mencakup:
+    - **Design Principles** (3-5)
+    - **Color Palette** (token + hex + usage)
+    - **Typography** (role, font, size, weight)
+    - **Spacing & Layout** (scale, breakpoints, container)
+    - **Component Specs** (variants & states untuk Button, Input, Card, Modal, Navbar, Table)
+    - **Interaction & Motion** (durasi, easing, feedback states)
+    - **Accessibility** (kontras, focus, keyboard, ARIA)
+6.  **Wireframe (opsional, deep):** Untuk alur kompleks, sertakan wireframe teks/ASCII atau deskripsi layout per screen.
+7.  **Human Review Loop:** Minta human review. Revisi sesuai feedback, update Revision History.
+8.  **Finalize:** Tandai `Approved`. Beri tahu Orchestrator design system siap dipakai Frontend Engineer.
+
+**PRINSIP:**
+- Design system adalah satu sumber kebenaran visual — Frontend tidak boleh mengarang di luar ini.
+- Konsisten > kreatif berlebihan. Setiap token punya alasan.
+
+**INPUT SAYA:**
+"Rancang design system untuk [proyek]."
+
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Palette + tipografi + token dasar, komponen inti saja |
+| **standard** | Full design system: semua komponen kunci + states + motion |
+| **deep** | + Wireframe per screen, a11y spec lengkap, dark mode, responsive detail, design tokens export |
+
+## Change Management
+> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — perubahan design system WAJIB di-update di acuan dan notify Frontend Engineer.
+
+## State Management
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/codes/.gitkeep

@@ -1 +1 @@
-# Place source code here. The contents of this folder are gitignored by default.
+# Place source code here. The contents of this folder are gitignored by default.

package/template/project_overview_example.md

@@ -1,55 +1,55 @@
-# PROJECT OVERVIEW: [Project Name]
-
-## 1. Project Summary
-*(Jelaskan secara garis besar software apa yang akan dibangun & masalah apa yang diselesaikan)*
-
-## 2. Target Audience
-*(Siapa yang akan menggunakan software ini: Admin, End User, Customer, dll)*
-
-## 3. Key Features
-- (Fitur A)
-- (Fitur B)
-- (Fitur C)
-
-## 4. Tech Stack & Infrastructure
-- **Language/Runtime:** (e.g., Node.js v20, Python 3.11, Go)
-- **Framework:** (e.g., Next.js 14, Express, FastAPI, Django)
-- **Database:** (e.g., PostgreSQL, MongoDB)
-- **State Management:** (e.g., Redux, Zustand, Context API - *Jika perlu*)
-- **Infrastructure:** Docker & Docker Compose (Default)
-
-## 5. UI/UX Guidelines & Design System
-*(Analyst Agent harus memastikan bagian ini terisi sebelum membuat spec fitur)*
-
-- **CSS Framework / Library:** (e.g., Tailwind CSS, Bootstrap, Material UI, Chakra UI, AntDesign)
-- **Component Library:** (e.g., Shadcn/UI, HeadlessUI, Radix - *Sangat disarankan jika menggunakan Tailwind*)
-- **Visual Vibe:** (e.g., Modern Minimalist, Corporate Professional, Playful & Colorful, Cyberpunk)
-- **Color Palette:**
-  - **Primary:** (Warna utama tombol/aksi - Hex Code atau deskripsi)
-  - **Secondary:** (Warna pendukung)
-  - **Background:** (Light Mode / Dark Mode / System default)
-- **Typography:**
-  - **Font Family:** (e.g., Inter, Roboto, Open Sans)
-  - **Scale:** (e.g., Default Tailwind scale)
-- **Iconography:** (e.g., Lucide React, Heroicons, FontAwesome)
-- **Styling Details:**
-  - **Radius:** (e.g., Rounded-md, Fully Rounded, Sharp/Square)
-  - **Shadows:** (e.g., Soft shadows, Flat design no shadow)
-- **Responsive Strategy:** (e.g., Mobile-First approach)
-
-## 6. Constraints & Compliance
-*(Opsional: GDPR, Offline First, High Performance requirement, dll)*
-
-## 7. Project Settings
-
-- **WORK_DEPTH:** {{workDepth}}  <!-- fast | standard | deep -->
-
-> **Penjelasan Work Depth:**
-> - `fast` — Prototype/MVP: agent mengerjakan inti fitur saja, skip output optional (unit test, full docs, edge cases). Cocok untuk eksplorasi cepat.
-> - `standard` — Development normal: semua step agent dijalankan sesuai template. **Default yang disarankan.**
-> - `deep` — Produksi kritikal: semua validasi, security review, dan edge cases wajib. Cocok untuk fitur pembayaran, autentikasi, atau sistem high-stakes.
->
-> **Di mana bisa diubah:**
-> 1. **File ini** (`project_overview.md`) — ubah nilai `WORK_DEPTH:` untuk mengubah default seluruh project.
-> 2. **Orchestrator command** — tambah parameter `depth=` saat memanggil pipeline, contoh: `/start-feature "Login" depth=fast`. Override untuk satu pipeline saja.
+# PROJECT OVERVIEW: [Project Name]
+
+## 1. Project Summary
+*(Jelaskan secara garis besar software apa yang akan dibangun & masalah apa yang diselesaikan)*
+
+## 2. Target Audience
+*(Siapa yang akan menggunakan software ini: Admin, End User, Customer, dll)*
+
+## 3. Key Features
+- (Fitur A)
+- (Fitur B)
+- (Fitur C)
+
+## 4. Tech Stack & Infrastructure
+- **Language/Runtime:** (e.g., Node.js v20, Python 3.11, Go)
+- **Framework:** (e.g., Next.js 14, Express, FastAPI, Django)
+- **Database:** (e.g., PostgreSQL, MongoDB)
+- **State Management:** (e.g., Redux, Zustand, Context API - *Jika perlu*)
+- **Infrastructure:** Docker & Docker Compose (Default)
+
+## 5. UI/UX Guidelines & Design System
+*(Analyst Agent harus memastikan bagian ini terisi sebelum membuat spec fitur)*
+
+- **CSS Framework / Library:** (e.g., Tailwind CSS, Bootstrap, Material UI, Chakra UI, AntDesign)
+- **Component Library:** (e.g., Shadcn/UI, HeadlessUI, Radix - *Sangat disarankan jika menggunakan Tailwind*)
+- **Visual Vibe:** (e.g., Modern Minimalist, Corporate Professional, Playful & Colorful, Cyberpunk)
+- **Color Palette:**
+  - **Primary:** (Warna utama tombol/aksi - Hex Code atau deskripsi)
+  - **Secondary:** (Warna pendukung)
+  - **Background:** (Light Mode / Dark Mode / System default)
+- **Typography:**
+  - **Font Family:** (e.g., Inter, Roboto, Open Sans)
+  - **Scale:** (e.g., Default Tailwind scale)
+- **Iconography:** (e.g., Lucide React, Heroicons, FontAwesome)
+- **Styling Details:**
+  - **Radius:** (e.g., Rounded-md, Fully Rounded, Sharp/Square)
+  - **Shadows:** (e.g., Soft shadows, Flat design no shadow)
+- **Responsive Strategy:** (e.g., Mobile-First approach)
+
+## 6. Constraints & Compliance
+*(Opsional: GDPR, Offline First, High Performance requirement, dll)*
+
+## 7. Project Settings
+
+- **WORK_DEPTH:** {{workDepth}}  <!-- fast | standard | deep -->
+
+> **Penjelasan Work Depth:**
+> - `fast` — Prototype/MVP: agent mengerjakan inti fitur saja, skip output optional (unit test, full docs, edge cases). Cocok untuk eksplorasi cepat.
+> - `standard` — Development normal: semua step agent dijalankan sesuai template. **Default yang disarankan.**
+> - `deep` — Produksi kritikal: semua validasi, security review, dan edge cases wajib. Cocok untuk fitur pembayaran, autentikasi, atau sistem high-stakes.
+>
+> **Di mana bisa diubah:**
+> 1. **File ini** (`project_overview.md`) — ubah nilai `WORK_DEPTH:` untuk mengubah default seluruh project.
+> 2. **Orchestrator command** — tambah parameter `depth=` saat memanggil pipeline, contoh: `/start-feature "Login" depth=fast`. Override untuk satu pipeline saja.
 > 3. **Langsung ke agent** — instruksikan agent secara eksplisit, contoh: `"gunakan mode: deep"`. Override tertinggi.