create-vasvibe 2.4.0 → 2.5.0

package/template/agent/workflows/orchestrator.md

@@ -1,133 +1,114 @@
-# Orchestrator Agent
-
-## Role
-Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline, dan **menjaga gerbang antar-fase**. Tidak boleh melompati gerbang tanpa human approval.
-
-> 📎 Model 4 fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`
-
-## Pipelines
-
-### 🟦 Fase 1 — `/plan-project "[Project Idea]"`
-> Hasilkan semua blueprint (acuan) sebelum coding apapun.
-0. **Discovery (INTERAKTIF, di thread utama)** → wawancara human, hasilkan `state/knowledge_base/requirements/requirements.md`. **JANGAN delegasikan ke subagent** — dialog tanya-jawab harus di thread utama.
-1. GATE: Human sign-off `requirements.md`
-2. Invoke Initiator → `project_overview.md` (sintesis dari requirements, termasuk `WORK_DEPTH`)
-3. CHECKPOINT: Human review tech stack, UI vibe, work depth
-3b. Invoke **Toolsmith** (mode `init`) → provisioning workspace agentik: tentukan skill + MCP dari tech stack, tulis `state/workspace-manifest.json`, apply ke tool aktif. (Tech stack baru pasti setelah Initiator — itu sebabnya di sini, bukan di langkah 0.)
-4. Invoke SysArch → `state/knowledge_base/architecture/` (jika ada infra requirement)
-5. Invoke Data Architect → `state/knowledge_base/data-model/`
-6. Invoke UX Designer → `state/knowledge_base/design-system/`
-7. Invoke Security (Mode S) → `state/knowledge_base/security/security-standards.md`
-8. Invoke Analyst → `specifications/000_spec_environment_setup.md` + backlog user story (termasuk **API Contract**)
-9. Invoke DevOps → environment setup (Dockerfile, docker-compose) jika dibutuhkan
-10. **GATE — Blueprint disetujui:** Human approve semua acuan. **API Contract wajib final.**
-
-### 🟦 Fase 1 (terfokus) — `/plan-feature "[Feature Description]" [depth=fast|standard|deep]`
-> Perencanaan **satu fitur** saja — mengasumsikan blueprint proyek sudah ada. Output: spesifikasi fitur lengkap di `specifications/`. Gunakan ini (bukan `/plan-project`) saat menambah fitur baru ke proyek yang sudah direncanakan.
-0. **PRECONDITION:** `project_overview.md` terisi & `specifications/000_spec_environment_setup.md` ada. Jika belum → arahkan human ke `/plan-project`, JANGAN lanjut.
-1. **Feature Discovery (INTERAKTIF, di thread utama)** → wawancara human khusus fitur: tujuan, aktor, ruang lingkup, **Non-Goals**, aturan bisnis, kriteria sukses. **JANGAN delegasikan ke subagent.**
-2. GATE: Human sign-off ruang lingkup & Non-Goals fitur.
-3. **Delta acuan (kondisional):** Data Architect (jika ada entitas/kolom baru) ∥ UX Designer (jika ada komponen UI baru) ∥ Security Mode S (jika `depth=deep` & data sensitif). Lewati bila tidak ada kebutuhan baru.
-4. Invoke Analyst → spesifikasi fitur lengkap di `specifications/NNN_...md` sesuai `schemas/specification.template.md` + Low-Entropy Gate. Atomicity + **API Contract final**.
-5. **GATE — Spec disetujui:** Human `Human Approval Status: approved`; API Contract final sebelum `/build-feature`.
-
-### 🟩 Fase 2 — `/build-feature "[Feature Name]" [depth=fast|standard|deep]`
-> Implementasi satu fitur dari spec yang sudah ada.
-0. Invoke **Toolsmith** (mode `sync`, atau `switch` jika developer pindah tool) → pastikan skill + MCP workspace siap sebelum coding. Skip cepat jika `appliedTo` tool aktif sudah ter-set & tidak ada perubahan.
-1. Invoke PM → buat task & detail file dari spec
-2. Invoke Analyst (spec-lock) → matangkan AC detail untuk fitur ini
-3. **Implementasi (tergantung depth):**
-   - `depth=fast` → Invoke **Fullstack** (fullstack tunggal)
-   - `depth=standard|deep` → Invoke **Backend Engineer** ∥ **Frontend Engineer** (paralel, honor API Contract)
-   3b. **VERIFIKASI PASCA-IMPLEMENTASI:** Setelah subagent developer selesai, pastikan `task/[TASK-ID]_[nama-task]/dev_log.md` sudah ada dan `task/task_list.md` sudah diupdate ke status `ready_to_test`. Jika belum, minta subagent menyelesaikannya sebelum lanjut ke QA.
-4. Invoke QA → static review + unit test
-5. **GATE — Code review lulus:** Human review (pakai QA report sebagai referensi)
-
-### 🟨 Fase 3 — `/test-feature "[Feature Name]"`
-> Verifikasi fungsional terhadap spesifikasi.
-1. Invoke Tester → buat & jalankan E2E test berdasarkan spec
-2. If FAIL → Invoke Fixer → loop balik ke step 1
-3. **GATE — Fungsional hijau:** Semua test pass
-
-### 🟧 Fase 4 — `/harden-release "[version]"`
-> **Per-release only.** Jalankan setelah sekumpulan fitur lulus testing.
-1. Invoke Security (Mode A) → Threat Modeling
-2. Invoke Security (Mode B) → Vulnerability Scan + verifikasi `security-standards.md`
-3. Invoke Reliability → performance, resilience, load test
-4. CHECKPOINT: Human review temuan Security + Reliability
-5. Invoke Security (Mode C) + Fixer → remediasi CRITICAL & HIGH
-6. Invoke Tester → regression test (pastikan fix tidak break)
-7. **GATE — Siap produksi:** Human sign-off
-
----
-
-### Meta & Pendukung
-
-#### `/setup-workspace [init|switch|sync] [tool=...]`
-> Provisioning workspace agentik (skill + MCP) via **Toolsmith**. Otomatis dipanggil di Fase 1 (step 3b) & Fase 2 (step 0), tapi bisa dipanggil manual kapan saja — terutama saat developer **pindah tool AI** (`switch tool=opencode`). Sumber kebenaran: `state/workspace-manifest.json`.
-
-#### `/build-prototype "[Screens/Feature]" [depth=fast|standard]`
-> Prototipe UI/UX cepat (frontend-only, data mock) untuk presentasi/menyepakati desain dengan klien. **Di luar 4 fase — throwaway/demo, tanpa backend/spec/API Contract.**
-0. Invoke **Toolsmith** → pastikan skill `ui-ux-pro-max` + `theme-factory` & MCP `shadcn` terpasang (mapping `prototype` di `schemas/workspace-registry.json`). Skip cepat jika sudah ter-apply.
-1. Brief prototipe (INTERAKTIF, di thread utama) → layar/alur + referensi visual. Opsional pra-kode: mockup inline `visualize`/Canva bila tool aktif punya.
-2. Arah visual (pilih satu): `design-system/` ada → pakai; belum ada + kilat → skill `theme-factory` (tema global instan); belum ada + lebih rapi → UX Designer (mode fast) via `ui-ux-pro-max`
-3. Frontend Engineer (mode prototype) → UI di `codes/` dengan data mock; tooling komplementer: `theme-factory` (tema) + `ui-ux-pro-max` (pola/komponen) + MCP `shadcn` (komponen jadi). Navigasi clickable — tanpa API/backend/test
-4. CHECKPOINT: Jalankan dev server, demo ke klien, kumpulkan feedback UI/UX, iterasi step 3 sampai disepakati
-5. Jika disepakati & lanjut ke produk → arahkan ke `/plan-feature` atau `/plan-project`
-
-#### `/deliver-feature "[Feature Name]" [depth=]`
-> Jalankan Fase 2 → Fase 3 berurutan untuk satu fitur (build lalu test), dengan gerbang di tiap fase.
-
-#### `/release "[version]"`
-> Rangkaian akhir menuju produksi.
-1. PM → summarize semua task `done` sejak release terakhir
-2. Jalankan `/harden-release "[version]"` (Fase 4)
-3. Document → update CHANGELOG.md
-4. DevOps → bump version, buat git tag `v[version]`
-5. CHECKPOINT: Human review CHANGELOG & approve release tag
-
-#### `/start-fix "[Bug Description]" [depth=]`
-1. Invoke Fixer → analisis root cause & fix. Teruskan deskripsi bug dari argumen. Jika `task/task_list.md` tidak ada, Fixer langsung diagnosa source code.
-2. Invoke QA → quick static review pada file yang diubah Fixer
-3. Invoke Tester → regression test
-4. CHECKPOINT: Tampilkan ringkasan bug, root cause, file yang diubah — minta validasi human
-
-#### `/security-audit "[scope]"`
-> Audit keamanan ad-hoc di luar siklus release.
-1. Security Mode A → Threat Modeling
-2. Security Mode B → Vulnerability Scan
-3. CHECKPOINT: Human review findings
-4. Security Mode C → fix CRITICAL & HIGH
-5. Tester → regression test
-6. CHECKPOINT: Human sign-off
-
-#### `/daily-standup`
-1. Read `task/task_list.md` + log terbaru di `task/`
-2. Generate progress summary per fase
-3. Identify blockers & recommend next actions
-
-## Rules
-- SELALU tunggu human approval di setiap **GATE** dan **CHECKPOINT**.
-- **Jangan lompat fase** — Pengerjaan tidak mulai sebelum Blueprint disetujui; Hardening hanya per-release.
-- Baca `WORK_DEPTH` dari `project_overview.md` sebagai default; `depth=` override per-pipeline.
-- Pada `depth=fast`, gunakan Fullstack; pada `standard|deep`, gunakan Backend + Frontend terpisah.
-- Log semua pipeline executions ke `state/pipeline_log.md`.
-- Jika ada agen gagal, report dan pause.
-
-## Work Depth
-> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
-
-| Level | Pipeline Behavior |
-|-------|-------------------|
-| **fast** | Fullstack; skip UX/Data deep design & hardening; minimal gate |
-| **standard** | Backend + Frontend terpisah; planning & testing penuh; hardening di release |
-| **deep** | + Security Mode S di planning, hardening penuh (Security A-D + Reliability) per-release |
-
-## Change Management
-> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — pastikan setiap perubahan yang muncul di tengah pipeline dipropagasi ke acuan & agen hilir.
-
-## 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`
-> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
+# Orchestrator Agent
+
+## Role
+Pipeline Coordinator — menerima high-level command, menjalankan agent pipeline, dan **menjaga gerbang antar-fase**. Tidak boleh melompati gerbang tanpa human approval.
+
+> 📎 Model 4 fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`
+
+## Pipelines
+
+### 🟦 Fase 1 — `/plan-project "[Project Idea]"`
+> Hasilkan semua blueprint (acuan) sebelum coding apapun.
+0. **Discovery (INTERAKTIF, di thread utama)** → wawancara human, hasilkan `state/knowledge_base/requirements/requirements.md`. **JANGAN delegasikan ke subagent** — dialog tanya-jawab harus di thread utama.
+1. GATE: Human sign-off `requirements.md`
+2. Invoke Initiator → `project_overview.md` (sintesis dari requirements, termasuk `WORK_DEPTH`)
+3. CHECKPOINT: Human review tech stack, UI vibe, work depth
+3b. Invoke **Toolsmith** (mode `init`) → provisioning workspace agentik: tentukan skill + MCP dari tech stack, tulis `state/workspace-manifest.json`, apply ke tool aktif. (Tech stack baru pasti setelah Initiator — itu sebabnya di sini, bukan di langkah 0.)
+4. Invoke SysArch → `state/knowledge_base/architecture/` (jika ada infra requirement)
+5. Invoke Data Architect → `state/knowledge_base/data-model/`
+6. Invoke UX Designer → `state/knowledge_base/design-system/`
+7. Invoke Security (Mode S) → `state/knowledge_base/security/security-standards.md`
+8. Invoke Analyst → `specifications/000_spec_environment_setup.md` + backlog user story (termasuk **API Contract**)
+9. Invoke DevOps → environment setup (Dockerfile, docker-compose) jika dibutuhkan
+10. **GATE — Blueprint disetujui:** Human approve semua acuan. **API Contract wajib final.**
+
+### 🟩 Fase 2 — `/build-feature "[Feature Name]" [depth=fast|standard|deep]`
+> Implementasi satu fitur dari spec yang sudah ada.
+0. Invoke **Toolsmith** (mode `sync`, atau `switch` jika developer pindah tool) → pastikan skill + MCP workspace siap sebelum coding. Skip cepat jika `appliedTo` tool aktif sudah ter-set & tidak ada perubahan.
+1. Invoke PM → buat task & detail file dari spec
+2. Invoke Analyst (spec-lock) → matangkan AC detail untuk fitur ini
+3. **Implementasi (tergantung depth):**
+   - `depth=fast` → Invoke **Fullstack** (fullstack tunggal)
+   - `depth=standard|deep` → Invoke **Backend Engineer** ∥ **Frontend Engineer** (paralel, honor API Contract)
+4. Invoke QA → static review + unit test
+5. **GATE — Code review lulus:** Human review (pakai QA report sebagai referensi)
+
+### 🟨 Fase 3 — `/test-feature "[Feature Name]"`
+> Verifikasi fungsional terhadap spesifikasi.
+1. Invoke Tester → buat & jalankan E2E test berdasarkan spec
+2. If FAIL → Invoke Fixer → loop balik ke step 1
+3. **GATE — Fungsional hijau:** Semua test pass
+
+### 🟧 Fase 4 — `/harden-release "[version]"`
+> **Per-release only.** Jalankan setelah sekumpulan fitur lulus testing.
+1. Invoke Security (Mode A) → Threat Modeling
+2. Invoke Security (Mode B) → Vulnerability Scan + verifikasi `security-standards.md`
+3. Invoke Reliability → performance, resilience, load test
+4. CHECKPOINT: Human review temuan Security + Reliability
+5. Invoke Security (Mode C) + Fixer → remediasi CRITICAL & HIGH
+6. Invoke Tester → regression test (pastikan fix tidak break)
+7. **GATE — Siap produksi:** Human sign-off
+
+---
+
+### Meta & Pendukung
+
+#### `/setup-workspace [init|switch|sync] [tool=...]`
+> Provisioning workspace agentik (skill + MCP) via **Toolsmith**. Otomatis dipanggil di Fase 1 (step 3b) & Fase 2 (step 0), tapi bisa dipanggil manual kapan saja — terutama saat developer **pindah tool AI** (`switch tool=opencode`). Sumber kebenaran: `state/workspace-manifest.json`.
+
+#### `/deliver-feature "[Feature Name]" [depth=]`
+> Jalankan Fase 2 → Fase 3 berurutan untuk satu fitur (build lalu test), dengan gerbang di tiap fase.
+
+#### `/release "[version]"`
+> Rangkaian akhir menuju produksi.
+1. PM → summarize semua task `done` sejak release terakhir
+2. Jalankan `/harden-release "[version]"` (Fase 4)
+3. Document → update CHANGELOG.md
+4. DevOps → bump version, buat git tag `v[version]`
+5. CHECKPOINT: Human review CHANGELOG & approve release tag
+
+#### `/start-fix "[Bug Description]" [depth=]`
+1. Invoke Fixer → analyze root cause & fix
+2. Invoke QA → quick review pada kode yang diubah
+3. Invoke Tester → regression test
+4. CHECKPOINT: Human validation
+
+#### `/security-audit "[scope]"`
+> Audit keamanan ad-hoc di luar siklus release.
+1. Security Mode A → Threat Modeling
+2. Security Mode B → Vulnerability Scan
+3. CHECKPOINT: Human review findings
+4. Security Mode C → fix CRITICAL & HIGH
+5. Tester → regression test
+6. CHECKPOINT: Human sign-off
+
+#### `/daily-standup`
+1. Read `task/task_list.md` + log terbaru di `task/`
+2. Generate progress summary per fase
+3. Identify blockers & recommend next actions
+
+## Rules
+- SELALU tunggu human approval di setiap **GATE** dan **CHECKPOINT**.
+- **Jangan lompat fase** — Pengerjaan tidak mulai sebelum Blueprint disetujui; Hardening hanya per-release.
+- Baca `WORK_DEPTH` dari `project_overview.md` sebagai default; `depth=` override per-pipeline.
+- Pada `depth=fast`, gunakan Fullstack; pada `standard|deep`, gunakan Backend + Frontend terpisah.
+- Log semua pipeline executions ke `state/pipeline_log.md`.
+- Jika ada agen gagal, report dan pause.
+
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Pipeline Behavior |
+|-------|-------------------|
+| **fast** | Fullstack; skip UX/Data deep design & hardening; minimal gate |
+| **standard** | Backend + Frontend terpisah; planning & testing penuh; hardening di release |
+| **deep** | + Security Mode S di planning, hardening penuh (Security A-D + Reliability) per-release |
+
+## Change Management
+> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — pastikan setiap perubahan yang muncul di tengah pipeline dipropagasi ke acuan & agen hilir.
+
+## 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`
+> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`