Engineering Workflow Pack untuk AI Coding Agents.

Ubah ide fitur menjadi spesifikasi PRD, pecahan task vertikal, dan sistem desain terukur sebelum agent mulai menulis kode.

Lihat Simulasi Alur skills.sh Registry
HOW TO INSTALL Universal CLI
npx skills add rizqinrr/viserys-agent
Alur Pakai 3 Core Skills:
  1. /get-prd Interview & tulis docs/PRD.md
  2. /get-tasks Pecah jadi tasks/<fitur>/plan.md
  3. /get-design Kunci spesifikasi UI di docs/design.md

01 / MASALAH VS SOLUSI

Mengapa Vibe Coding Gagal di Skala Produksi

Meminta AI langsung membuat fitur dari satu kalimat singkat sering berujung pada arsitektur yang salah arah. Viserys mengunci spesifikasi di dalam repositori sebelum implementasi dimulai.

Tanpa Viserys (Vibe Coding)

Eksekusi Tanpa Spesifikasi

  • Asumsi buta pada prompt pertama: Agent langsung membuat puluhan file tanpa menanyakan siapa pengguna utama, batasan performa, atau aturan autentikasi.
  • Task monolitik yang merusak kode: Seluruh fitur dikerjakan dalam satu giliran besar. Saat terjadi error, agent menimpa file yang sudah benar.
  • Tampilan UI generik (AI Slop): Gradien ungu-biru tanpa alasan, kartu fitur seragam, tombol mati yang tidak berfungsi, dan kontras warna yang gagal dibaca.
Dengan Viserys

Alur Rekayasa 3 Tahap

  • Structured Interview (get-prd): Menggali niat asli lewat 1 pertanyaan terfokus per giliran hingga tingkat keyakinan mencapai 85%, lalu mengunci spesifikasi di docs/PRD.md.
  • Vertical Task Slicing (get-tasks): Memecah PRD menjadi tasks/<feature>/plan.md dan task-*.md lengkap dengan urutan dependensi dan perintah tes TDD.
  • Bespoke UI Specification (get-design): Menetapkan sistem token, tipografi, state interaktif lengkap (empty, loading, error), dan kontras WCAG di docs/design.md.

02 / ARSITEKTUR REPOSITORI

Komponen Inti di Dalam Paket

Seluruh alur kerja dikemas dalam Markdown murni tanpa dependensi runtime: 3 core skills, 7 specialist personas, 7 shared checklists, dan validator deterministik.

MODUL 01 / skills/*/SKILL.md 3 Core Skills

Rantai Alur Kerja Utama

Klik salah satu skill untuk melihat kapan skill tersebut dipanggil, mekanisme kerjanya, dan file yang dihasilkan:

Kapan Dipakai: Memulai aplikasi, sistem, atau fitur baru saat belum ada dokumen kebutuhan.
Mekanisme Inti: Design-tree interview satu pertanyaan per giliran, hipotesis eksplisit, pemetaan entitas data, dan NFR.
Deliverable: docs/PRD.md
MODUL 02 / agents/*.md 7 Personas

7 Specialist Personas

Tujuh prompt spesialis untuk mengevaluasi rencana dan kode dari sudut pandang berbeda. Klik untuk melihat fokusnya:

File: agents/strategist.md

Menyusun grafik dependensi penuh, memecah fitur menjadi irisan vertikal, dan menulis kriteria penerimaan yang dapat diuji.

MODUL 03 / references/*.md 7 Checklists

Shared Checklists

Daftar periksa yang dimuat sesuai kebutuhan oleh skill untuk menjaga standar produksi:

  • definition-of-done.md
  • security-checklist.md
  • testing-checklist.md
  • performance-checklist.md
  • subagent-dispatch.md
  • routing.md
  • anti-slop-gate.md
MODUL 04 / scripts/ & evals/ CI Verified

Validator & Trigger Evals

Konsistensi struktur skill, path artefak, dan akurasi routing diuji otomatis dengan Node.js:

62/62 Unit Tests Lulus di scripts/
100% Rank-1 Trigger Accuracy (14/14 kasus)

03 / SIMULASI ALUR KERJA

Simulasi Dialog & Deliverable

Mode:
Artefak docs/PRD.md terverifikasi dan siap digunakan.
DIALOG AGENT & USER Confidence: 90%
Developer

Saya ingin membuat aplikasi pencatat stok gudang untuk kasir toko ritel kecil.

Viserys (get-prd)
HIPOTESIS: Sistem pencatatan stok masuk/keluar satu layar dengan pencarian barcode cepat.
CONFIDENCE AWAL: 35% (Perlu konfirmasi perangkat kasir & koneksi internet).

Pertanyaan 1: Apakah kasir menginput barang menggunakan pemindai barcode USB di komputer kasir atau kamera ponsel di ruang gudang?

Rekomendasi: Komputer kasir dengan pemindai USB karena transaksi berlangsung cepat di meja pembayaran.

Developer

Komputer meja kasir dengan scanner USB, dan harus tetap jalan walau internet toko putus sebentar.

Viserys (get-prd)

Keyakinan naik ke 90%. Mengunci entitas Product, StockEntry, serta syarat antrean lokal (offline queue) ke dalam docs/PRD.md.

DELIVERABLE MARKDOWN docs/PRD.md 
# PRD: Retail Counter Inventory Ledger

## 1. Problem Statement
Kasir toko ritel kecil sering mengalami selisih stok fisik karena pencatatan barang masuk dan keluar terpisah dari meja transaksi dan gagal tersimpan saat koneksi internet tidak stabil.

## 2. Target User & Operating Context
- Pengguna Utama: Kasir toko di meja pembayaran.
- Perangkat: Desktop browser (1280px+) dengan pemindai barcode USB (keyboard wedge).

## 3. Core Data & Entity Model
| Entity | Key Attributes | Relationships |
|---|---|---|
| Product | id (uuid), barcode (unique), name, min_stock | 1-to-many StockEntries |
| StockEntry | id, product_id, delta_qty, reason, synced_at | belongs-to Product |
| LocalQueue | id, payload_json, retry_count, status | 1-to-1 StockEntry |

## 4. Non-Functional Requirements (NFRs)
- Pencarian barcode lokal wajib selesai di bawah 50ms (IndexedDB cache).
- Mutasi stok saat offline disimpan di LocalQueue dan disinkronkan otomatis saat jaringan pulih.

04 / KOMPATIBILITAS AGENT

Berjalan di Berbagai AI Coding Agent

Pilih editor atau CLI yang Anda gunakan untuk melihat cara integrasi Viserys.

Integrasi

Claude Code Plugin & Slash Commands

Mendukung manifest plugin di .claude-plugin/plugin.json, lifecycle hooks, dan slash command langsung seperti /get-prd, /get-tasks, dan /get-design.

Perintah Instalasi
npx skills add rizqinrr/viserys-agent --agent claude-code