create-vasvibe 2.2.0 → 2.3.1

package/README.md

@@ -1,33 +1,71 @@
 # create-vasvibe
 
-Scaffold a new project with VasVibe agents, prompts, and workflows preconfigured.
+Scaffold a new VasVibe project with **19 agents**, **4-phase workflow**, and **multi-tool support** preconfigured.
+
+**VasVibe v2.2** — AI-native development framework with:
+- ✅ 4-Phase Model (Perencanaan → Pengerjaan → Testing → Hardening) with gates
+- ✅ 19 specialized agents (Discovery, Backend/Frontend/Fullstack, Security, Reliability, DevOps, etc.)
+- ✅ Toolsmith agent for agentic workspace provisioning (skills + MCP)
+- ✅ Multi-tool support (Claude Code, OpenCode, GitHub Copilot, Antigravity)
+- ✅ No Silent Changes protocol (every change tracked in docs)
+- ✅ Work Depth system (fast/standard/deep)
 
 ```bash
 npx create-vasvibe my-new-project
 ```
 
-The command produces a project folder containing the agent toolchains your team uses, plus the standard working folders (`codes/`, `specifications/`, `tests/`) with their `.gitignore` rules already in place.
+The command produces a project folder containing all agent toolchains, workflows, schemas, and standard working folders (`codes/`, `specifications/`, `state/`, `tests/`) with `.gitignore` rules already configured.
 
 ## What you get
 
 ```
 my-new-project/
-├── .agents/                # Shared skills (developer, pm, find-skills, ...)
-├── .claude/                # Claude Code agents & skills
-├── .opencode/              # OpenCode commands & skills
-├── .github/prompts/        # GitHub Copilot prompt files
-├── agent/workflows/        # Tool-agnostic workflow markdown
-├── codes/                  # Source code (gitignored by default)
-├── specifications/         # Technical specs (gitignored by default)
-├── tests/                  # Tests (gitignored by default)
+├── .agents/                        # Antigravity agent wrappers & skills
+├── .claude/                        # Claude Code agents & skills
+├── .opencode/                      # OpenCode commands & skills
+├── .github/prompts/                # GitHub Copilot prompt files (19 agents)
+├── agent/workflows/                # Source of truth: agent definitions (19 total)
+│   ├── _shared/
+│   │   ├── phases.md               # 4-phase model definition
+│   │   ├── change-management.md    # No Silent Changes protocol
+│   │   ├── work-depth.md           # Work depth (fast/standard/deep)
+│   │   └── git-branch-management.md # Git workflow for code-writing agents
+│   ├── orchestrator.md             # Pipeline coordinator
+│   ├── discovery.md                # Requirement gathering
+│   ├── initiator.md                # Project overview
+│   ├── backend.md, frontend.md, fullstack.md # Implementation agents
+│   ├── data-architect.md, ux-designer.md    # Design phase
+│   ├── analyst.md                  # Specifications
+│   ├── qa.md, tester.md, fixer.md  # QA & testing
+│   ├── security.md, reliability.md # Hardening phase
+│   ├── toolsmith.md ⭐ NEW         # Agentic workspace provisioning
+│   ├── devops.md, pm.md            # Infrastructure & project mgmt
+│   └── document.md                 # Documentation
+│
+├── schemas/                        # Shared schemas ⭐ v2.2
+│   ├── workspace-registry.json         # Skill + MCP catalog, tech-stack mappings
+│   └── workspace-manifest.template.json # Workspace provisioning template
+│
+├── state/                          # Workspace & knowledge base ⭐ v2.2
+│   ├── workspace-manifest.json     # Desired-state config (platform-agnostic)
+│   └── knowledge_base/             # Living docs (architecture, data-model, etc.)
+│
+├── codes/                          # Source code (gitignored by default)
+├── specifications/                 # Technical specs (gitignored by default)
+├── tests/                          # Tests (gitignored by default)
+├── task/                           # Task management
+├── logs/                           # Auto-generated logs
 ├── project_overview_example.md
-├── skills-lock.json
+├── QUICK-START.md                  # Workflow guide (Indonesian)
+├── AGENT_PERSONAS.md               # All 19 agents documented
 ├── GIT_STRUCTURE_GUIDE.md
-├── PROJECT_README.example.md
-├── README.md
 └── .gitignore
 ```
 
+**Multi-Tool:** Agents auto-propagate from `agent/workflows/` to `.claude/`, `.opencode/`, `.agents/`, and `.github/prompts/` for full tool parity.
+
+**Workspace Provisioning:** Run `/setup-workspace init` to auto-detect your tool, derive skills + MCP from tech stack, and write `state/workspace-manifest.json`.
+
 `opencode.json` is intentionally not generated. Create one yourself per your AI provider settings (see https://opencode.ai/docs).
 
 ## Usage
@@ -36,6 +74,30 @@ my-new-project/
 npx create-vasvibe <project-name> [options]
 ```
 
+### Workflow
+
+1. **Create project**
+   ```bash
+   npx create-vasvibe my-app
+   ```
+
+2. **Choose work depth** (when prompted)
+   - `fast` — MVP, prototype, single Fullstack agent
+   - `standard` — Production normal, Backend+Frontend parallel *(default)*
+   - `deep` — Fintech/auth/sensitive data, full security+reliability
+
+3. **Setup workspace** (after tech stack is known)
+   ```bash
+   cd my-app
+   /setup-workspace init
+   ```
+   → Toolsmith detects active tool, derives skills+MCP from tech stack, writes `state/workspace-manifest.json` and tool-specific MCP config
+
+4. **Start planning**
+   ```bash
+   /plan-project "Your project idea here"
+   ```
+
 ### Options
 
 | Flag             | Description                                              |
@@ -52,31 +114,52 @@ npx create-vasvibe <project-name> [options]
 ### Examples
 
 ```bash
-# Interactive
+# Interactive (choose depth + tools)
 npx create-vasvibe my-app
 
-# Defaults, no questions
-npx create-vasvibe my-app --yes
+# Fast mode MVP
+npx create-vasvibe my-app --yes   # uses fast depth, all tools
 
 # Only OpenCode + workflows
 npx create-vasvibe my-app --yes --no-claude --no-github
 ```
 
+### Quick Start
+
+After scaffold, read **`QUICK-START.md`** for step-by-step workflow guide (Indonesian):
+- Mental model of 4 phases
+- Command reference (/plan-project, /build-feature, /test-feature, /release)
+- Work depth strategy
+- Gate approval process
+
 ## Development (for maintainers)
 
-This package lives at `packages/create-vasvibe/` inside the monorepo. The source of truth for template content is the repo root; `template/` is generated by a sync script.
+This package lives at `packages/create-vasvibe/` in the monorepo. Source of truth for content is the repo root (`agent/workflows/`, `schemas/`, `.claude/`, `.opencode/`, `.agents/`, `.github/prompts/`); `template/` is generated by a sync script.
+
+**Key changes in v2.2:**
+- Source of truth → 19 agents in `agent/workflows/` (not 8)
+- Multi-tool propagation: auto-syncs to `.claude/`, `.opencode/`, `.agents/`, `.github/prompts/`
+- Added: `schemas/workspace-registry.json`, `schemas/workspace-manifest.template.json`
+- Added: `state/` folder with `workspace-manifest.json` and `knowledge_base/` template
+- Added: `_shared/` docs (phases.md, change-management.md, work-depth.md, git-branch-management.md)
+- Renamed: `developer.md` → `fullstack.md`
 
 ```bash
-# Sync template/ from repo root
+# Sync template/ from repo root (runs on every npm publish)
 npm run sync-template
 
 # Test scaffold locally
 node bin/cli.mjs /tmp/test-scaffold --yes
 
-# Inspect what npm publish would include
+# Verify what gets published
 npm pack --dry-run
 ```
 
+**Template sync logic:**
+- Reads source files from repo root: `agent/workflows/`, `schemas/`, `.claude/`, `.opencode/`, `.agents/`, `.github/prompts/`, `QUICK-START.md`, `AGENT_PERSONAS.md`
+- Copies to `template/` directory
+- On `npm publish`, `prepublishOnly` hook runs sync automatically
+
 `prepublishOnly` runs `sync-template` automatically, so a regular `npm publish` always ships an up-to-date template.
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vasvibe",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Scaffold a new project with VasVibe agents, prompts, and workflows preconfigured (Claude, OpenCode, GitHub Copilot).",
   "type": "module",
   "bin": {
@@ -42,4 +42,4 @@
     "url": "https://github.com/anomalyco/vas_vibe.git",
     "directory": "packages/create-vasvibe"
   }
-}
+}

package/template/.agents/workflows/explorer.md

@@ -0,0 +1,78 @@
+# Explorer Agent — Workflow Detail
+
+**Role:** Senior Software Architect & Code Analyst  
+**Trigger:** `/explore-codebase` atau dipanggil Orchestrator sebelum `/build-feature` pada project existing.  
+**Input:** Codebase yang sudah ada di folder `codes/`  
+**Output:** `project_overview.md`, `state/knowledge_base/codebase/inventory.md`, `state/context.json`
+
+---
+
+## Kapan Menggunakan Explorer?
+
+Gunakan Explorer (bukan Discovery + Initiator) ketika:
+- Kamu **bergabung ke project yang sudah berjalan** dan perlu memahami kondisinya sebelum mengerjakan fitur baru.
+- Ada **handover codebase** dari tim lain dan tidak ada dokumentasi overview.
+- Kamu ingin **memverifikasi** apakah `project_overview.md` yang ada masih akurat dengan kode terkini.
+- Sebelum menjalankan `/build-feature` atau `/start-fix` pada project existing yang belum punya state.
+
+---
+
+## Alur Kerja
+
+```
+codes/ exists?
+     │
+     ├─ YES → Explorer baca kode → tulis project_overview.md + inventory + context.json
+     │              │
+     │              └─ Human review → lanjut ke /build-feature atau /start-fix
+     │
+     └─ NO  → Arahkan ke /plan-project (project baru, mulai dari Discovery)
+```
+
+---
+
+## Dokumen yang Dihasilkan
+
+| Dokumen | Path | Deskripsi |
+|---------|------|-----------|
+| Project Overview | `project_overview.md` | Tech stack, fitur, design system — disintesis dari kode |
+| Codebase Inventory | `state/knowledge_base/codebase/inventory.md` | Daftar API endpoints, data models, file penting |
+| Context State | `state/context.json` | Status project saat ini untuk kontinuitas antar-session |
+
+---
+
+## Panduan Membaca Kode per Stack
+
+### Node.js / TypeScript (Next.js, Express, NestJS)
+- Root: `package.json`, `tsconfig.json`, `.env.example`
+- Routes: `src/routes/`, `src/app/api/`, `pages/api/`, `src/controllers/`
+- Models: `prisma/schema.prisma`, `src/models/`, `src/entities/`
+- Config: `src/config/`, `next.config.js`, `nest-cli.json`
+
+### Python (FastAPI, Django, Flask)
+- Root: `pyproject.toml`, `requirements.txt`, `setup.py`
+- Routes: `app/routers/`, `app/views.py`, `urls.py`
+- Models: `app/models.py`, `alembic/versions/`
+- Config: `app/config.py`, `settings.py`
+
+### Go
+- Root: `go.mod`, `go.sum`
+- Routes: `internal/handler/`, `internal/api/`, `cmd/`
+- Models: `internal/domain/`, `internal/model/`
+- DB: `internal/repository/`, migration files
+
+### Mobile (Flutter, React Native)
+- Root: `pubspec.yaml` atau `package.json`
+- Screens: `lib/screens/`, `src/screens/`
+- State: `lib/providers/`, `lib/bloc/`, `src/store/`
+- API: `lib/services/`, `src/api/`
+
+---
+
+## Output Quality Rules
+
+1. **Jangan berasumsi** — setiap klaim HARUS dari file yang dibaca. Tandai dengan `[confirmed]`, `[inferred]`, atau `[unknown]`.
+2. **Inventarisasi endpoints lengkap** — jangan skip; ini akan dipakai Analyst untuk API Contract.
+3. **Tandai incomplete features** — gunakan `[~]` untuk partial, `[ ]` untuk planned/TODO.
+4. **Catat technical debt** — tulis di `notes` field `context.json` agar agent berikutnya tahu.
+5. **Jangan timpa state yang masih valid** — jika `state/context.json` sudah ada dan masih relevan, merge informasi baru ke dalamnya.

package/template/.agents/workflows/logger.md

@@ -0,0 +1,117 @@
+# Logger Agent — Workflow Detail
+
+**Role:** Technical Change Recorder & Analyst  
+**Trigger:** Dipanggil kapan saja oleh human — *"catat perubahan ini"*, *"log apa yang baru saja terjadi"*, atau cukup *"logger"*.  
+**Input:** Deskripsi perubahan dari human, dan/atau analisa sesi / kode secara mandiri  
+**Output:** Entry baru di `task/[TASK-ID]/dev_log.md` + baris baru di Status Log task detail file
+
+---
+
+## Kapan Memanggil Logger?
+
+| Situasi | Cara panggil |
+|---------|--------------|
+| Baru selesai fix bug secara manual | *"Logger, catat: fix bug validasi di form login"* |
+| Selesai coding satu sesi, ingin rekap tercatat | *"Logger, analisa apa yang baru saja dikerjakan dan catat"* |
+| Mau pastikan enhancement tercatat sebelum tutup sesi | *"Logger"* (tanpa argumen — logger akan tanya / analisa sendiri) |
+| Ingin log lintas beberapa task | *"Logger, tadi ada 3 perubahan: ..."* |
+
+---
+
+## Tipe Perubahan & Klasifikasinya
+
+```
+Sesuatu yang salah/rusak diperbaiki?
+    └─ YES → fix
+
+Kemampuan baru ditambahkan?
+    └─ YES → enhancement
+
+Kode diubah tanpa ubah perilaku?
+    └─ YES → refactor
+
+Config, dependency, atau dokumentasi?
+    └─ YES → chore
+```
+
+**Aturan tie-breaker:** Jika satu perubahan bisa fix DAN enhancement (mis. memperbaiki cara feature bekerja sambil menambah field baru), buat **dua entry terpisah** — satu fix, satu enhancement.
+
+---
+
+## Struktur Dokumen yang Diisi
+
+### 1. Task Detail File — Status Log
+**Path:** `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`
+
+Logger menambahkan baris baru di tabel Status Log yang sudah ada:
+```markdown
+| [timestamp] | logger | [tipe] | [deskripsi 1 baris] |
+```
+
+### 2. Dev Log File
+**Path:** `task/[TASK-ID]_[nama-task]/dev_log.md`
+
+Logger membuat file ini jika belum ada, atau menambah entry di Revision History:
+```markdown
+## [timestamp] — [tipe]: [judul]
+
+**Type:** fix / enhancement / refactor / chore
+**Changed by:** [human / agent]
+
+### What Changed
+[Narasi singkat]
+
+### Files Affected
+- `path/file` — apa yang berubah
+
+### Notes
+[Catatan teknis jika ada]
+```
+
+### 3. Fallback — Untracked Changes
+Jika tidak ada task yang cocok, tulis ke:
+**Path:** `task/untracked/[YYYY-MM-DD]_untracked_changes.md`
+
+```markdown
+# Untracked Changes — [YYYY-MM-DD]
+
+## [HH:MM] — [tipe]: [judul]
+[Deskripsi perubahan]
+**Suggested Task:** [nama task yang mungkin relevan, atau "belum ada task terdaftar"]
+```
+
+---
+
+## Alur Keputusan Logger
+
+```
+Human panggil logger
+        │
+        ├─ Ada deskripsi eksplisit? ──→ Gunakan sebagai basis
+        │
+        ├─ Tidak ada info? ──────────→ Tanya 1-2 pertanyaan ringkas
+        │
+        └─ Minta analisa mandiri? ───→ Periksa file yang berubah / konteks sesi
+                    │
+                    ▼
+        Klasifikasi tipe perubahan
+                    │
+                    ▼
+        Cari task yang cocok di task_list.md
+                    │
+                    ├─ Ketemu → tulis log di task tersebut
+                    ├─ Lintas task → tulis di semua task relevan
+                    └─ Tidak ketemu → tulis di task/untracked/
+                    │
+                    ▼
+        Konfirmasi ringkasan ke human
+```
+
+---
+
+## Aturan Kualitas Log
+
+1. **Deskripsi konkret** — bukan *"fix bug"* tapi *"fix: email tidak divalidasi saat domain kosong"*
+2. **Satu entry per perubahan logis** — 3 perubahan berbeda = 3 entry
+3. **Tidak mengarang** — jika tidak yakin apa yang berubah, tanya dulu
+4. **Timestamp real** — selalu gunakan waktu saat ini, bukan placeholder

package/template/.claude/settings.local.json

@@ -27,7 +27,9 @@
       "Bash(python3 -c \"import json; json.load\\(open\\('schemas/workspace-registry.json'\\)\\); print\\('registry OK'\\)\")",
       "Bash(python3 -c \"import json; json.load\\(open\\('schemas/workspace-manifest.template.json'\\)\\); print\\('manifest OK'\\)\")",
       "Bash(python3 -c \"import json; json.load\\(open\\('.agents/agents/toolsmith/agent.json'\\)\\); print\\('agent.json OK'\\)\")",
-      "Bash(node scripts/sync-template.mjs)"
+      "Bash(node scripts/sync-template.mjs)",
+      "Bash(cp /Users/admin/Development/vas_vibe/packages/create-vasvibe/template/.claude/agents/explorer.md /Users/admin/Development/vas_vibe/.opencode/agents/explorer.md && cp /Users/admin/Development/vas_vibe/packages/create-vasvibe/template/agent/workflows/explorer.md /Users/admin/Development/vas_vibe/.agents/workflows/explorer.md)",
+      "Bash(cp /Users/admin/Development/vas_vibe/packages/create-vasvibe/template/.claude/agents/logger.md /Users/admin/Development/vas_vibe/.opencode/agents/logger.md && cp /Users/admin/Development/vas_vibe/packages/create-vasvibe/template/agent/workflows/logger.md /Users/admin/Development/vas_vibe/.agents/workflows/logger.md && echo \"done\")"
     ]
   }
 }

package/template/.opencode/agents/explorer.md

@@ -0,0 +1,138 @@
+---
+name: explorer
+description: Codebase Explorer — reads an existing project in the codes/ folder, analyzes its architecture, tech stack, features, and current state, then produces project_overview.md and updates state/. Invoke when onboarding to an existing codebase before starting new development work.
+---
+
+**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/.opencode/agents/logger.md

@@ -0,0 +1,143 @@
+---
+name: logger
+description: Change Logger — records changes that happened during a session into the appropriate task log. Called anytime by the human. Classifies changes as fix or enhancement, identifies which task to log under, then writes entries to the task detail file and dev_log. Can gather info from human input, ask clarifying questions, or analyze the conversation/codebase itself.
+---
+
+**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`