Viserys
September 21, 2026 · View on GitHub
.---------------------------------------------------------------.
|'||' '|' '||' .|'''.| '||''''| '||''|. '||' '|' .|'''.| |
| '|. .' || ||.. ' || . || || || | ||.. ' |
| || | || ''|||. ||''| ||''|' || ''|||. |
| ||| || . '|| || || |. || . '|||
| | .||. |'....|' .||.....| .||. '|' .||. |'....|' |
'---------------------------------------------------------------'
Viserys
Engineering workflow pack untuk AI coding agents. Viserys memberi agent proses yang konsisten untuk mendefinisikan masalah, merencanakan pekerjaan, mengimplementasikan perubahan, memverifikasi hasil, melakukan review, dan menyiapkan release.
DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
Core Viserys terdiri dari Markdown dan validator Node.js, tanpa runtime aplikasi atau network dependency. Adapter harness, plugin installation, hooks, browser tooling, dan behavioral evals memiliki prerequisite masing-masing.
Isi repository
- 29 skills — workflow engineering dari requirements sampai shipping.
- 7 specialist personas — planning, review, security, testing, performance, UI, dan dokumentasi.
- 13 command contracts — tersedia untuk Claude Code, Gemini CLI, dan Antigravity.
- 7 shared checklists — definition of done, security, testing, performance, dan orchestration.
- Structural validators dan evals — menjaga skill, command, persona, artifact path, reference, version, dan routing tetap konsisten.
- Optional hooks — automatic context injection untuk lifecycle yang mendukungnya.
Quick start
| Harness | Mulai dari | Status |
|---|---|---|
| OpenCode | Buka repository, tekan Tab, pilih viserys | Project adapter tersedia; root personas tidak otomatis aktif |
| Claude Code | Install plugin dari checkout lokal | Plugin flow paling lengkap dan diuji di CI |
| Gemini CLI | Gunakan adapter di .gemini/commands/ | 13 commands tersedia dan structurally tested; runtime E2E belum diverifikasi |
| Antigravity | Gunakan adapter di commands/ | 13 commands tersedia dan structurally tested; runtime E2E belum diverifikasi |
| OMP | Copy/link skills, agents, dan prompts ke scope OMP | Native compatibility melalui struktur OMP |
| Codex | Gunakan manifest .codex-plugin/plugin.json | Skills-only pada level manifest |
Panduan setup dan batas dukungan: docs/installation.md.
OpenCode project scope
1. Buka root repository ini dari OpenCode.
2. Tekan Tab.
3. Pilih agent viserys.
Claude Code dari checkout lokal
claude plugin validate .
claude plugin marketplace add ./
claude plugin install viserys@viserys --scope user
Cara memakai Viserys
Automatic routing
Minta pekerjaan secara natural. Viserys memilih skill yang cocok dari intent:
Bantu debug test yang gagal dan cari root cause-nya.
Rancang API pagination yang backward-compatible.
Direct skill invocation
Sebut skill bila workflow tertentu wajib digunakan:
Gunakan spec-driven-development untuk mendefinisikan feature ini.
Commands
| Tujuan | Claude Code | Gemini / Antigravity |
|---|---|---|
| Requirements mendalam | /get-prd | /get-prd |
| Database schema | /get-schema | /get-schema |
| Executable task files | /get-tasks | /get-tasks |
| Feature specification | /spec | /spec |
| Implementation plan | /plan | /planning |
| Incremental build | /build | /build |
| Test workflow | /test | /test |
Code review via maester | /review | /review |
| Pre-launch fan-out | /ship | /ship |
| Web performance | /webperf | /webperf |
| UI/design workflow | /get-design | /get-design |
Command behavior dan adapter differences: docs/commands.md.
Workflow yang direkomendasikan
Feature
/spec → /plan → /build → /test → /review → /ship
Aplikasi atau sistem baru
/get-prd → /get-schema → /get-tasks → implementasi → /review → /ship
UI atau redesign
/get-design shape <target>
→ frontend-ui-engineering
→ browser-testing-with-devtools
→ /review
→ /webperf bila relevan
→ /ship
Bug fix
debugging-and-error-recovery
→ test-driven-development
→ /review
Recipes lengkap: docs/workflows.md.
Personas
| Persona | Fokus |
|---|---|
strategist | Full planning, dependency graph, task slicing, acceptance criteria |
maester | Correctness, readability, architecture, security, performance |
kingsguard | Threat modeling dan vulnerability detection |
prover | Test strategy, coverage, dan prove-it pattern |
racer | Core Web Vitals dan web performance |
artisan | Product UI, visual hierarchy, accessibility, responsive behavior |
chronicler | ADR, API docs, migration notes, changelog, release documentation |
/ship selalu menjalankan maester, kingsguard, prover, dan chronicler secara paralel; artisan ditambahkan hanya untuk perubahan UI/web. Persona behavior bergantung pada kemampuan subagent harness. Lihat docs/personas-and-orchestration.md.
Skills
| Phase | Skills |
|---|---|
| DEFINE | get-prd, idea-refine, interview-me, spec-driven-development, constraint-driven-development |
| PLAN | get-schema, get-tasks, planning-and-task-breakdown |
| BUILD | incremental-implementation, test-driven-development, context-engineering, source-driven-development, doubt-driven-development, get-design, frontend-ui-engineering, api-and-interface-design |
| VERIFY | browser-testing-with-devtools, debugging-and-error-recovery |
| REVIEW | code-review-and-quality, code-simplification, security-and-hardening, performance-optimization |
| SHIP | git-workflow-and-versioning, ci-cd-and-automation, deprecation-and-migration, documentation-and-adrs, observability-and-instrumentation, shipping-and-launch |
Trigger, boundary, dan output tiap skill: docs/skills.md.
Repository map
| Path | Isi |
|---|---|
skills/ | 29 workflow skills dan per-skill references |
agents/ | 7 specialist persona prompts |
.claude/commands/ | Claude Code command adapters |
.gemini/commands/ | Gemini CLI command adapters |
commands/ | Antigravity command adapters; juga dideklarasikan oleh manifest Claude |
.opencode/ + opencode.json | OpenCode agent/command adapters dan root project config |
.claude-plugin/ | Claude plugin manifest |
.codex-plugin/ | Codex skills manifest |
docs/ | User, maintainer, dan adapter documentation |
references/ | Shared checklists dan orchestration guidance |
evals/ | Deterministic dan optional behavioral evals |
scripts/ | Structural validators, eval runner, dan tests |
hooks/ | Optional lifecycle hooks |
Validation
node scripts/validate-skills.js
node scripts/validate-commands.js
node scripts/validate-personas.js
node scripts/validate-artifact-paths.js
node scripts/validate-reference-links.js
node scripts/validate-versions.js
node scripts/run-evals.js --min-rank1 95
node --test scripts/*-test.js scripts/lib/*-test.js
CI juga memvalidasi Claude plugin manifest dan installation flow. Detail validation contract: CONTRIBUTING.md.
Community
Butuh bantuan, ingin berdiskusi, atau berbagi pengalaman memakai Viserys? Join Discord Viserys.
Documentation
- Documentation index
- Installation dan support matrix
- Command catalog
- Workflow recipes
- Skill catalog
- Personas dan orchestration
- Hooks
- Skill anatomy
- Eval system
- Contributing
License
Viserys dilisensikan di bawah Apache License 2.0. Copyright 2026 rizqinrr.
Materi get-design mengadaptasi guidance Apache-2.0 dari Impeccable; atribusi upstream dipertahankan pada file adaptasi yang relevan.