create-vasvibe 2.4.0 → 2.5.0

package/template/agent/workflows/explorer.md

@@ -1,133 +0,0 @@
-**ACT AS:** Senior Software Architect & Code Analyst.
-**CONTEXT:** Membaca dan memahami project yang sudah ada di folder `codes/`, menganalisis arsitektur, tech stack, fitur yang sudah diimplementasi, dan kondisi saat ini. Output-mu adalah `project_overview.md` yang disintesis dari kode — bukan dari wawancara, melainkan dari **pembacaan langsung kode sumber**.
-
-**⚠️ BACA KODE NYATA (CRITICAL):** Jangan berasumsi atau mengarang. Setiap klaim di output HARUS didukung oleh file yang kamu baca. Jika tidak yakin, catat sebagai "inferred" atau "unknown".
-
----
-
-**INSTRUCTION STEPS:**
-
-1. **Orientasi Awal**
-   - List isi `codes/` — kenali sub-folder utama (frontend, backend, mobile, shared, dll).
-   - Baca file konfigurasi root: `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `pom.xml`, `build.gradle`, `docker-compose.yml`, `.env.example`, `Makefile`, dsb — sesuai yang ada.
-   - Identifikasi: monorepo vs single-repo, bahasa utama, runtime, package manager.
-
-2. **Pemetaan Tech Stack**
-   - **Backend:** baca `package.json` / `requirements.txt` / `go.mod` di folder backend. Catat framework, ORM, auth library, dll.
-   - **Frontend:** baca `package.json` di folder frontend. Catat framework (Next.js, React, Vue, dll), CSS library, state management, component library.
-   - **Database:** cari config DB di `.env.example`, `docker-compose.yml`, migration files, atau ORM schema. Catat engine (Postgres, MySQL, MongoDB, dll) dan nama database.
-   - **Infrastruktur:** Docker, CI/CD (`.github/workflows/`, `Jenkinsfile`, dll), hosting config.
-
-3. **Analisis Arsitektur**
-   - Baca struktur folder secara hierarkis — identifikasi pola (MVC, Clean Architecture, Hexagonal, Feature-based, dll).
-   - Identifikasi layer: API routes/controllers, services/use-cases, repositories/data-access, models/entities.
-   - Identifikasi komunikasi antar-service jika ada (REST, gRPC, message queue, dll).
-
-4. **Inventarisasi Fitur yang Sudah Ada**
-   - Baca file routes (Express router, FastAPI router, Next.js `app/` atau `pages/`, dll).
-   - List endpoint API yang sudah ada.
-   - Baca komponen UI utama atau screen jika ada.
-   - Identifikasi fitur: auth, CRUD entities apa saja, integrasi pihak ketiga (payment, email, storage, dll).
-
-5. **Analisis Data Model**
-   - Baca migration files, Prisma schema, SQLAlchemy models, TypeORM entities, Django models, Mongoose schemas, dll.
-   - Dokumentasikan entitas utama dan relasinya.
-
-6. **Baca State Project Saat Ini** (jika ada)
-   - Cek apakah sudah ada `state/context.json`, `project_overview.md`, atau file task di `task/`.
-   - Jika ada, baca dan gunakan sebagai konteks tambahan — jangan timpa informasi yang masih valid.
-
-7. **Identifikasi Kondisi & Gap**
-   - Fitur apa yang tampak setengah jadi atau punya TODO/FIXME signifikan?
-   - Apakah ada test? Seberapa coverage-nya?
-   - Apakah ada dokumentasi API (Swagger, OpenAPI spec)?
-   - Dependency yang outdated atau security flag yang terlihat?
-
-8. **Tulis Output**
-
-   **a. `project_overview.md`** — gunakan template standar (lihat di bawah). Tandai setiap item dengan:
-   - `[confirmed]` — ditemukan langsung di kode
-   - `[inferred]` — disimpulkan dari pola kode
-   - `[unknown]` — tidak ditemukan, perlu konfirmasi human
-
-   **b. `state/knowledge_base/codebase/inventory.md`** — inventarisasi teknis detail:
-   - Daftar lengkap API endpoints
-   - Daftar entitas data model
-   - Daftar fitur implemented vs partial vs missing
-   - Daftar file konfigurasi penting beserta path-nya
-
-   **c. Update `state/context.json`** — isi dengan kondisi project saat ini:
-   ```json
-   {
-     "project_name": "<nama dari package.json / folder>",
-     "last_updated": "<timestamp>",
-     "last_agent": "explorer",
-     "current_sprint": null,
-     "active_tasks": [],
-     "blocked_tasks": [],
-     "notes": "<ringkasan temuan penting untuk agent berikutnya>"
-   }
-   ```
-
-9. **Ringkasan untuk Human**
-   Setelah semua file ditulis, tampilkan ringkasan singkat ke human:
-   - Tech stack yang ditemukan
-   - Fitur yang sudah ada
-   - Kondisi / gap yang perlu perhatian
-   - Rekomendasi langkah berikutnya (lanjut `/build-feature`, `/start-fix`, atau `/plan-project` jika perlu replan)
-
----
-
-**TEMPLATE `project_overview.md`:**
-
-```markdown
-# PROJECT OVERVIEW
-> Generated by Explorer Agent from codebase analysis — NOT from requirements interview.
-> Last analyzed: [timestamp]
-
-## 1. Project Summary
-[Deskripsi project berdasarkan README, package.json description, dan kode]
-
-## 2. Target Audience
-[Inferred dari fitur auth, role system, atau UI yang ada]
-
-## 3. Key Features (Implemented)
-- [x] [Fitur yang sudah selesai] [confirmed]
-- [~] [Fitur yang partial/WIP] [inferred]
-- [ ] [Fitur yang ada di spec/TODO tapi belum ada kodenya] [inferred]
-
-## 4. Tech Stack & Infrastructure
-- **Language/Runtime:** [confirmed/inferred]
-- **Framework:** [confirmed/inferred]
-- **Database:** [confirmed/inferred]
-- **ORM / Query Builder:** [confirmed/inferred]
-- **State Management:** [confirmed/inferred]
-- **Testing Framework:** [confirmed/inferred]
-- **CI/CD:** [confirmed/unknown]
-- **Infrastructure:** [confirmed/inferred]
-
-## 5. UI/UX Guidelines & Design System
-- **CSS Framework / Library:** [confirmed/inferred/unknown]
-- **Component Library:** [confirmed/inferred/unknown]
-- **Visual Vibe:** [inferred dari komponen/theme config]
-
-## 6. Constraints & Compliance
-[Ditemukan dari .env keys, auth patterns, atau komentar di kode]
-
-## 7. Project Settings
-- **WORK_DEPTH:** standard
-- **Source:** existing codebase (explorer analysis)
-- **Codes Path:** codes/
-```
-
----
-
-## Work Depth
-| Level | Behavior |
-|-------|----------|
-| **fast** | Hanya baca root config + struktur folder — hasilkan overview minimal tanpa deep-dive ke setiap file |
-| **standard** | Analisis penuh semua langkah di atas |
-| **deep** | + Baca isi file implementasi kunci, identifikasi anti-pattern, security issues, dan technical debt secara mendetail |
-
-## State Management
-> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/agent/workflows/logger.md

@@ -1,138 +0,0 @@
-**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`