.---------------------------------------------------------------.
|'||' '|' '||' .|'''.| '||''''| '||''|. '||' '|' .|'''.| |
| '|. .' || ||.. ' || . || || || | ||.. ' |
...
Viserys
Agent Skills
Showcase Web
License
Tests Passing
AI 코딩 에이전트를 위한 엔지니어링 워크플로우 팩입니다. Viserys는 AI에게 구조화된 소프트웨어 공학 프로세스를 제공하여, 명세 없이 임의적인 '느낌에 의존한 코딩(vibe coding)'을 하거나 작업 분해(task decomposition)가 없거나 시각적 표준이 없는 상태로 진행하는 것을 방지합니다.
INTERVIEW & SPEC (get-prd) ──→ VERTICAL TASK SLICES (get-tasks) ──→ BESPOKE UI SPEC (get-design)
핵심 Viserys는 순수 Markdown과 Node.js 검증기(validator)로 구성되어 있으며, 애플리케이션 런타임이나 네트워크 의존성이 없습니다. Claude Code, Cursor, Windsurf, OpenCode, Gemini CLI, Antigravity와 즉시 사용 가능합니다 (out-of-the-box).
빠른 설치 방법 (Quick Install)
1. 범용 설치 (Universal Install) (npx skills)
Vercel / Agent Skills 생태계의 skill 패키지 관리자를 사용하여 Viserys를 사용하려는 에이전트(Claude Code, Cursor, Windsurf, Codex 등)에 추가할 수 있습니다:
npx skills add rizqinrr/viserys-agent
...
2. OpenCode 프로젝트 범위 (OpenCode Project Scope)
OpenCode에서 이 리포지토리를 직접 여세요:
1. OpenCode에서 리포지토리 폴더를 엽니다.
2. Tab 키를 누릅니다.
3. viserys 에이전트를 선택합니다.
3. Claude Code 플러그인 (Claude Code Plugin)
로컬 레포지토리를 체크아웃하여 직접 설치하세요:
claude plugin validate .
claude plugin marketplace add ./
claude plugin install viserys@viserys --scope user
3가지 핵심 기둥 (3 Core Pillars)
Viserys는 표준화된 결과물을 도출하는 세 가지 고성능 엔지니어링 워크플로우에 중점을 둡니다:
get-prd (docs/PRD.md) ──→ get-tasks (tasks/<name>/plan.md) ──→ get-design (docs/design.md)
| 스킬 (Skill) | 결과물 (Deliverable) | 사용 시점 (Kapan Digunakan) |
|---|
get-prd | docs/PRD.md | 새로운 이니셔티브, 기능 또는 시스템을 시작할 때. 구조화된 인터뷰(structured interview), 문제 검증(problem validation), 의도 추출(intent extraction), 제약 조건 식별(NFRs/SLAs) 및 핵심 데이터 엔티티 설계를 수행합니다. |
| ... | | |
각 스킬의 상세 트리거, 제약 조건 및 계약: docs/skills.md.
Viserys 사용 방법 (Cara Memakai Viserys)
1. 자연어 의도 (Natural Language Intent) (자동 라우팅)
에이전트에게 자연어로 말을 걸기만 하면, 에이전트는 적절한 스킬을 자동으로 선택합니다:
"새로운 멀티테넌트 인증 기능을 만들고 싶어요. 저를 인터뷰해 주세요."
→ get-prd 호출
"docs/PRD.md에 있는 PRD가 승인되었으니, 서브 에이전트가 실행할 수 있는 작업으로 분해해 주세요."
→ get-tasks 호출
"이 모니터링 대시보드 인터페이스를 설계해 주세요. 일반적인 AI 결과물처럼 보이지 않게 해주세요."
→ get-design 호출
2. 직접 슬래시 명령어 (Direct Slash Commands)
Claude Code, Gemini CLI 및 Antigravity에 사용할 수 있는 슬래시 명령어가 제공됩니다:
| 명령어 | 설명 | 목표 결과물 (Target Deliverable) |
|---|
/get-prd | 구조화된 인터뷰 및 심층 사양 작성 | docs/PRD.md |
| ... | | |
명령어 계약 상세: docs/commands.md.
생태계 및 지원 구성 요소 (Ekosistem & Komponen Pendukung)
3가지 핵심 스킬 외에도, Viserys는 다음과 같은 지원 엔지니어링 구성 요소를 포함합니다:
- 7개의 전문 페르소나 (
agents/) — 서브 에이전트용 전문가 프롬프트 페르소나 (strategist, maester, kingsguard, prover, racer, artisan, chronicler).
- 7개의 공유 체크리스트 (
references/) — 보안(security), 테스트(testing), Core Web Vitals, 완료 정의(definition of done) 및 오케스트레이션용 즉시 사용 가능한 체크리스트.
- 구조적 검증기 및 평가 도구 (
scripts/, evals/) — 라우팅 일관성, 프론트매터 형식, 버전 관리 및 rank-1 트리거를 검증하기 위한 자동화된 테스트 스위트.
Harness 지원 매트릭스 (Matriks Dukungan Harness)
| 플랫폼 / 에이전트 | 통합 방법 | 상태 |
|---|
| Claude Code | 로컬 플러그인 또는 npx skills add | 완벽하게 지원되며 CI에서 테스트됨 |
| ... | | |
전체 설치 가이드: docs/installation.md. | | |
저장소 맵 (Repository Map)
| 경로 (Path) | 내용 (Isi) |
|---|
skills/ | 3가지 핵심 워크플로우 스킬 (get-prd, get-tasks, get-design) 및 각 스킬 참조 |
| ... | |
검증 (Validation)
저장소의 모든 변경 사항은 결정론적(deterministic) 검증기(validator)에 의해 관리됩니다:
node scripts/validate-skills.js
node scripts/validate-commands.js
...
라이선스 (License)
Viserys는 Apache License 2.0 하에 라이선스가 부여되었습니다. Copyright 2026 rizqinrr. get-design 자료는 Impeccable의 Apache-2.0 가이드를 각색한 것이며, 상위 출처(upstream)에 대한 출처 표기는 관련 적응 파일에 유지됩니다.
