# ⚡ VibesPlug Pro v4.5.0: 176-Skill AI Agent Swarm & SaaT Architecture
**Turn any IDE into an autonomous 176-agent software development studio.**
*Zero AI Slop • Sovereign Anti-Slop Directive • Zero Tech Debt • Pure Production Velocity*
💠 **3D Emblem Philosophy**: **Titanium Neural Plug** (Universal 6-IDE & MCP Connector) • **Obsidian Crystalline Brain** (Deterministic P1–P7 Reasoning) • **8 Orbital Spheres** (8 Specialist Subagents & 176 Domain Skills)
⭐ Star this repo to support the project & help it trend!
[🇬🇧 English](#english) | [🇮🇩 Bahasa Indonesia](#bahasa-indonesia) | [🇨🇳 中文 (Mandarin)](#mandarin) | [🇩🇪 Deutsch (German)](#german) | [🇯🇵 日本語 (Japanese)](#japanese) | [📈 Star History](#star-history)
"` | Ultra-low latency (<2ms) isolated micro-sandbox evaluating AI code with wall-clock timeout kill and zero host access. |
| **P7: Universal SaaT Dispatcher** | `vibes skill exec ` | Turns all 176 declarative skills & 1,000+ code blueprints into deterministic executable tools across 8 domain adapters, 8 multi-skill chains (`vibes skill chain`), and 93%-compressed subagent micro-slices (`.skill-slices.json`). |
| **P8: Schema Drift Healer** | `vibes drift:heal [sql] [ts]` | Detects structural drift between PostgreSQL DDL schemas and TypeScript/Zod/OpenAPI contracts (missing columns, nullability, RLS) and synthesizes a zero-drift healing patch. |
### 🔬 Reverse Engineering & Binary Analysis (REA Suite)
VibesPlug integrates the 5-skill **REA (Reverse Engineer Anything)** ecosystem for evidence-backed binary, firmware, managed/Electron, and runtime inspection:
- `reverse-engineer-anything` — Decompile & analyze native binaries (Ghidra/LLDB), Electron/JS bundles, APK/firmware images, and capture live web `AgentEnv` bundles.
- `rea-tool-design` — Contract-first CLI/MCP tool boundary & `Evidence` span design.
- `rea-analysis-optimization` — Bounded cache keys, latency/CPU/memory profiling, and agent context optimization for binary analysis.
- `rea-ci-tests-audit` — Evidence-backed CI/test-suite drift, fixture, and false-pass auditing.
- `rea-changelog-update` — Pinned Git history contributor attribution & Release Please synchronization.
---
## 🔌 Native Model Context Protocol (MCP v1.x) Server
VibesPlug provides a native standalone MCP server running over standard I/O (JSON-RPC 2.0) and Server-Sent Events (SSE). Connect it to Claude Desktop, Cursor, Antigravity, or Codex via `mcp_config.json`:
```bash
# Start the MCP server manually or via vibes CLI
vibes mcp
# or npm run mcp
```
### Registered Frontier MCP Tools:
1. `vibes_ast_query` — Query AST symbols, inspect function bodies, or compute refactoring blast radius.
2. `vibes_eval_sql` — Evaluate DDL schemas and audit PostgreSQL RLS policies in an in-memory sandbox.
3. `vibes_arbitrate_code` — Score and arbitrate competing code solutions via Process Reward Model (PRM).
4. `vibes_verify_invariants` — Formally prove state machine invariants and generate SMT-LIB 2.0 formulas.
5. `vibes_get_skill` — Fetch instructions and contracts from any of the 176 specialized skills.
6. `vibes_list_skills` — Discover all 176 skills with domain categories, summaries, and tags.
7. `vibes_inject_skill` — Directly inject one or more skills into `.agents/skills/`.
8. `vibes_compile_cache` — Compile and lock deterministic prompt prefix for KV-Cache optimization.
9. `vibes_memory` — Read and write cross-session architectural decisions and emit compact checkpoints.
10. `vibes_swarm` — Generate multi-agent execution plans (Fan-Out/Fan-In, Saga, Critic-Validator).
11. `vibes_eval_sandbox` — Safely execute and verify ephemeral JavaScript/TypeScript code snippets in an isolated micro-sandbox.
12. `vibes_critic_validate` — Autonomous Critic-in-the-Loop review gate verifying code quality and AST invariants.
13. `vibes_visual_audit` — Multimodal visual UI compliance audit for Anti-Slop Pillar 7 rubrics.
14. `vibes_swarm_dispatch` — Concurrently dispatch parallel multi-agent workers with automated skill binding, sandbox verification, and Critic-in-the-Loop auditing.
15. `vibes_finops_report` — Query local FinOps token consumption metrics and estimated prompt caching (KV-Cache) cost savings.
16. `vibes_graph_query` — Query indexed AST symbols and dependency blast radius in `.agents/graph/symbol_graph.json`.
17. `vibes_graph_search` — High-precision local Hybrid GraphRAG search combining BM25, TF-IDF vector, and AST boost.
18. `vibes_pr_review` — Autonomous GitHub PR review bot auditing git diffs against Sovereign Anti-Slop rubrics.
19. `vibes_self_heal` — Autonomous test runner and self-healing failure diagnoser with proposed patch generation.
20. `vibes_registry_search` — Search decentralized community skills registry by keyword or category.
21. `vibes_registry_install` — Install gold-standard verified skills directly from registry into `.agents/skills/`.
22. `vibes_bridge_status` — Inspect Universal Cross-IDE Bridge status across Antigravity, Claude, Cursor, and Codex.
23. `vibes_bridge_sync` — Synchronize rules, skills, and context bundles across all detected AI platforms.
24. `vibes_verify_gate` — Atomic in-memory pre-commit verification gate evaluating candidate code before writing to disk.
25. `vibes_swarm_bus` — Query active swarms, telemetry events, or emit inter-agent broadcast coordination signals.
26. `vibes_package_extension` — Build zero-dependency `.vsix` companion extension archive for VS Code and Cursor.
27. `vibes_learn_skill` — Synthesize complete gold-standard bilingual skills from raw project codebases or repository patterns.
28. `vibes_skill_exec` — Universal Skill-as-a-Tool (SaaT) Dispatcher executing any of the 176 skills (`blueprint`, `slice`, `extract-code`, `audit`, `eval`, `verify`, `generate`, `fuzz`).
29. `vibes_skill_chain` — Execute multi-skill DAG workflows and composite pipelines (`saas-launch-gate`, `ai-agent-hardening`, `fintech-settlement-gate`, `zero-debt-release`).
30. `vibes_batch` — Execute multiple MCP tools concurrently in a single JSON-RPC round-trip (`Promise.allSettled`).
31. `vibes_run_benchmark` — Run performance, KV-Cache, and latency benchmark suite across all engines.
32. `vibes_git_hooks` — Install, inspect, or remove Sovereign Guard Git pre-commit hooks.
33. `vibes_optimize_budget` — Compute dynamic token budget allocations and context window slices.
34. `vibes_skill_drift` — Audit all 176 skills for structural drift, frontmatter compliance, and health scores (`100/100`).
35. `vibes_terminal_monitor` — Real-time system health, memory, and swarm telemetry monitor.
36. `vibes_speculative_consensus` — Parallel multi-draft speculative execution with AST-aware consensus arbitration.
37. `vibes_detect_stack` — Auto-detect project tech stack (`package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`) and recommend matching skills.
38. `vibes_tool_profile` — Dynamically switch active MCP tool exposure profiles (`full`, `core`, `frontend`, `backend`, `security`, `ai-mcp`) to cut schema token overhead by up to 75%.
### ⚡ Vibes Studio Cockpit & Remote MCP (Visual Dashboard)
Vibes-Plug features a zero-dependency local web cockpit with interactive panels, topological DAG workflow designer, and Server-Sent Events (SSE) remote transport:
```bash
# Launch visual web cockpit (opens http://localhost:3888) with 11 interactive tabs & Remote MCP
vibes studio
# Universal Cross-IDE State Bridge: synchronize rules & 176 skills across Antigravity, Claude, Cursor, Codex
vibes bridge [status|sync|bundle]
# Autonomous Skill Synthesizer: synthesize gold-standard bilingual skills from raw codebase patterns
vibes learn [--repo ] [--category ]
# Pre-Disk Verification Gate: validate candidate code in-memory (AST, Anti-Slop, security, sandbox)
vibes verify-gate
# Real-Time Swarm Concurrency Bus: observe active agent swarms and broadcast coordination events
vibes swarm:bus [status|events|broadcast]
# Local Hybrid GraphRAG Search: search codebase symbols via BM25 + Vector Cosine + AST connectivity
vibes graph:search "" [--top-k 5]
# Zero-Dependency VSIX Packager: build companion extension archive for VS Code & Cursor in <50ms
vibes package:vscode
# Interactive Project Scaffolding Wizard (custom stack & tailored skills)
vibes wizard
# Execute and verify code in Ephemeral Micro-Sandbox (<2ms execution, timeout protection)
vibes sandbox "" [--timeout ]
# Dispatch parallel multi-agent workers concurrently with automated skill binding & synthesis
vibes swarm:dispatch "" [--concurrency 3]
# Track token economics, KV-cache efficiency, and estimated financial savings
vibes finops status
# Run Critic-in-the-Loop code / PRD audit
vibes critic
# Run Multimodal Visual UI audit (Pillar 7 Anti-Slop)
vibes visual-audit
# Or run standalone Remote MCP Server for Claude Desktop, Cursor, or remote agents
vibes mcp --transport sse --port 3333
# Autonomous Skill & Codex Evolver: evolve skills & multi-platform codex rules
vibes evolve [--category ] [--from-repo ]
# Autonomous CI Auto-Healer: diagnose stack traces and apply safe remediation
vibes ci:heal [command|logPath] [--dry-run|--apply]
# Standalone Single-Binary Compiler: package zero-dependency executable
vibes package:binary [--platform ] [--arch ]
# Run the complete Sovereign Quality & Anti-Slop Guard (648 files + 51 tests)
vibes guard
```
### 💻 Native VSCode & Cursor IDE Companion Extension
Vibes-Plug includes a native extension package in [`extensions/vscode/`](extensions/vscode/):
- **Status Bar Indicator**: Live status displaying `$(zap) VibesPlug: 176 Skills Active`.
- **Command Palette & Context Menus**: 11 native commands including Studio Cockpit, Scaffolding Wizard, Sovereign Guard, Active Document Critic, Token FinOps Report, Pre-Disk Gate, and Swarm Dispatcher.
- **Packaging & Installation**: Build zero-dependency `.vsix` anytime via `vibes package:vscode` or `npm run package:vscode` in <50ms and install directly into VSCode, Cursor, or Windsurf.
---
## 🇬🇧 English Version
Welcome to **VibesPlug Pro**. Unlike generic prompt libraries, VibesPlug acts as a **Swarm Director**, orchestrating 176 specialized AI subagents. It is strictly engineered to extract maximum reasoning capabilities from ALL Late-2026 Frontier Models across all IDE tiers (xAI Grok 4.7 High Fast / Grok 4.6, Cursor Composer 2.5 Fast, Google Gemini 4 Argon Medium / Gemini 4 Pro / Project Astra, OpenAI GPT-5.6 Sol Medium / GPT-5 / o3, Anthropic Claude Opus 5.5 Medium / Claude Sonnet 5.5 High / Claude Fable 5.1, Muse Wonder High, and DeepSeek-R1 / Pro / V3) with an automated **Availability Fallback Invariant** (gracefully routing unprovisioned Gemini 4 tasks to Gemini 3.8 Flash, and Claude Opus 5.5 to Claude Opus 4.6 without workflow interruption).
### 🚀 Universal Installation Guide (All IDEs & LLMs)
*Supported Platforms: Google Antigravity (AGY), Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline / Roo Code), Kimi, and Kiro.*
#### Method 1: CLI (NPM Installation - Recommended)
The CLI automatically scaffolds the required master rules for your specific IDE.
```bash
npm i -g vibes-plug
vibes-plug init
```
#### Method 2: GitHub Installation (Direct via NPX / Git Clone - Always Latest)
You can install or execute VibesPlug directly from the GitHub repository using any of the following methods:
**Option A: Instant Execution via NPX (No Local Clone Required)**
Run the installer directly from GitHub without cloning the repository:
```bash
# Run installer for all detected IDEs & platforms
npx github:roedyrustam/vibes-plug --all
# Or install globally from GitHub
npm install -g git+https://github.com/roedyrustam/vibes-plug.git
vibes-plug --all
```
**Option B: Clone & Universal Multi-Platform Installer**
Clone the repository and run the built-in installer to auto-configure all your tools:
```bash
git clone https://github.com/roedyrustam/vibes-plug.git
cd vibes-plug
npm install
# Run installer across all detected platforms:
npm run install-all
# (or node scripts/install.js --all)
```
**Option C: Direct Git Clone for Google Antigravity (AGY)**
Google Antigravity natively loads plugins from `~/.gemini/config/plugins/`. Clone directly into your Antigravity plugins directory:
```bash
# macOS & Linux:
git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
# Windows (PowerShell):
git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
```
**Option D: Targeted Per-Project Installation**
From your cloned `vibes-plug` directory, inject rules and skills into any specific project:
```bash
# For Claude Code (global + project):
node scripts/install.js --claude --project /path/to/my-project
# For Cursor IDE (project-specific):
node scripts/install.js --cursor --project /path/to/my-project
# For OpenAI Codex:
node scripts/install.js --codex --project /path/to/my-project
# For Windsurf, Trae, or VSCode (Cline):
cp .windsurfrules /path/to/my-project/
cp .traerules /path/to/my-project/
cp .clinerules /path/to/my-project/
```
**Option E: Staying Updated via GitHub**
To pull the latest skills and superintelligence engine updates:
```bash
cd ~/.gemini/config/plugins/vibes-plug # (or your cloned repository folder)
git pull origin main
npm test
```
#### Method 3: Platform-Specific Manual Configuration (ZIP Archive / Drop-in)
If you download the `.zip` archive, extract it and configure your IDE as follows:
- **Google Antigravity (AGY):** Move the folder to `~/.gemini/config/plugins/vibes-plug`.
- **Claude Code:** Run `vibes-plug --claude` or copy `CLAUDE.md` and `.claude/rules/` to your project root.
- **Cursor IDE:** Run `vibes-plug --cursor --project .` or copy `.cursorrules` and `.cursor/rules/` to your project root.
- **OpenAI Codex CLI:** Run `vibes-plug --codex` or copy `CODEX.md` and `.codex/rules/` to your project root.
- **Windsurf IDE:** Copy `.windsurfrules` to your project root.
- **Trae IDE:** Copy `.traerules` to your project root.
- **VSCode (Cline / Roo):** Copy `.clinerules` to your project root.
- **Kimi / Kiro:** Copy `.kimirules` or `.kirorules` to your project root.
### 💻 How to Use the Plugin & CLI
**1. Zero-Friction Prompting (In-IDE)**
You do *not* need to tag skills manually. Just open your IDE's AI Chat and type your vision:
> *"Build me a multi-tenant SaaS platform with DOKU QRIS and Stripe billing, a Next.js 15 App Router frontend with Tailwind v4, and role-based access control with PostgreSQL RLS."*
The Swarm Director automatically intercepts the request, runs Step 1 Context Discovery, generates `PRD.md` and `ERD.md`, and orchestrates the cooperating skills through the 8-Phase Zero-To-Prod workflow.
**2. Comprehensive CLI Toolkit Reference**
```bash
# Workspace & Skill Management
vibes init # Scaffolds 8-Phase Zero-To-Prod structure (README, PROGRESS, BLUEPRINT, PRD)
vibes bootstrap # Super-scaffolds project + skills (saas | ecommerce | mobile | api | fullstack | spec-api)
vibes wizard # Interactive CLI wizard to scaffold project stack & custom skill bundle
vibes sync # Verifies & synchronizes master trigger across all IDE rules
vibes ui # Interactive terminal TUI to visually select & install skills
vibes studio [--port ] # Launches local web Studio Cockpit dashboard (visual 176-skill explorer)
vibes list [filter] # Lists all 176 skills (optional: keyword filter)
vibes search # Searches 176 skills with relevance ranking
vibes add # Injects a skill from registry into local project (.agents/skills)
vibes remove # Removes an installed skill from local project
vibes skill info # Shows metadata, description, and orchestration connections
vibes skill exec # Universal SaaT Dispatcher (blueprint|slice|extract-code|audit|eval|verify|generate|fuzz)
vibes skill chain # Executes multi-skill pipelines (saas-launch-gate, ai-agent-hardening, fintech-settlement-gate)
vibes skill compile-slices # Compiles 93%-compressed (<350 token) micro-slices into .skill-slices.json
vibes skill matrix # Displays domain capability & executable code-blueprint matrix across all skills
vibes recipe list # Lists curated skill bundles (ai-stack, fullstack-pro, fintech-core, spec-driven-api)
vibes recipe apply # Applies a curated skill recipe to current workspace
vibes docs [markdown|json] # Exports full 176-skill catalog to terminal, CATALOG.md, or CATALOG.json
vibes create-skill # Scaffolds a new skill following the standard specification
vibes create-agent --name # Generates a custom subagent across Antigravity, Cursor, and Claude
vibes create-mcp # Scaffolds a new Model Context Protocol server
# Superintelligence Engines & Verification
vibes guard # Runs full Sovereign Guard CI pipeline (P1–P5 + Anti-Slop + Swarm + Memory)
vibes compile-cache # Compiles deterministic KV-Cache prefix (>1024 tokens) for 75-90% token savings
vibes db:eval [file|--sql] # Simulates & audits SQL DDL migrations in-memory for RLS and schema safety
vibes ast [args] # Queries AST symbols (symbols), inspects bodies (inspect), or computes blast-radius
vibes arbitrate [fileA] [fileB] # Scores & arbitrates competing code drafts using Process Reward Models (PRM)
vibes verify-invariants [file] # Formally proves state machine invariants & generates SMT-LIB 2.0 specs
vibes swarm "" # Executes Autonomous Swarm Director (Fan-Out/Fan-In, Saga, Critic-Validator)
vibes memory # Local episodic project memory & ultra-compact checkpointing (<150 tokens)
vibes mcp # Starts native stdio Model Context Protocol (MCP v1.x) server
# Quality Gates & Diagnostics
vibes anti-slop # Runs Sovereign Anti-Slop scanner (detects placeholders & empty stubs)
vibes anti-slop --strict # Strict CI mode: fails build on any warning
vibes anti-slop --fix # Automatically removes syntax-narrating redundant comments
vibes audit # Runs zero-tech-debt-auditor for dead code, magic numbers & strict types
vibes critic # Runs deep Critic-in-the-Loop audit on code/PRD before commit
vibes visual-audit # Audits UI code or screenshot image against Pillar 7 & generates vision rubric
vibes doctor # Checks environment health & IDE integration integrity
vibes hooks install # Installs pre-commit Git hook enforcing zero-slop gates
```
### 🛡️ Reusable GitHub Action (CI/CD Quality Gate)
Integrate the Sovereign Anti-Slop Gate and Critic-Validator directly into any repository:
```yaml
name: Sovereign Guard Gate
on: [push, pull_request]
jobs:
guard:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: roedyrustam/vibes-plug/.github/actions/vibes-guard@main
with:
strict: 'true'
```
---
## 🇮🇩 Versi Bahasa Indonesia
Selamat datang di **VibesPlug Pro**. Berbeda dengan kumpulan prompt biasa, VibesPlug bertindak sebagai **Swarm Director (Sutradara Utama)** yang mengorkestrasi 176 sub-agen AI spesialis. Sistem ini direkayasa secara ketat untuk mengekstrak penalaran maksimum dari SEMUA Model Frontier Terkini Akhir-2026 di seluruh tier IDE (xAI Grok 4.7 High Fast / Grok 4.6, Cursor Composer 2.5 Fast, Google Gemini 4 Argon Medium / Gemini 4 Pro / Project Astra, OpenAI GPT-5.6 Sol Medium / GPT-5 / o3, Anthropic Claude Opus 5.5 Medium / Claude Sonnet 5.5 High / Claude Fable 5.1, Muse Wonder High, dan DeepSeek-R1 / Pro / V3) dengan **Invarian Fallback Ketersediaan** otomatis (mengalihkan tugas Gemini 4 yang belum tersedia/mengalami batas kuota ke Gemini 3.8 Flash, dan Claude Opus 5.5 ke Claude Opus 4.6 tanpa menghentikan alur kerja).
### 🚀 Panduan Instalasi Universal (Semua IDE & LLM)
*Platform Didukung: Google Antigravity (AGY), Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline / Roo Code), Kimi, dan Kiro.*
#### Metode 1: CLI (Instalasi NPM - Rekomendasi Instan)
CLI akan otomatis mengonfigurasi aturan utama (*master rules*) sesuai dengan IDE yang Anda gunakan.
```bash
npm i -g vibes-plug
vibes-plug init
```
#### Metode 2: Instalasi via GitHub (Direct NPX / Git Clone - Selalu Versi Terbaru)
Anda dapat memasang atau mengeksekusi VibesPlug langsung dari repositori GitHub dengan beberapa opsi berikut:
**Opsi A: Eksekusi Langsung via NPX (Tanpa Perlu Clone)**
Jalankan skrip installer langsung dari repositori GitHub tanpa meng-clone repo ke komputer Anda:
```bash
# Jalankan installer untuk seluruh platform IDE yang terdeteksi
npx github:roedyrustam/vibes-plug --all
# Atau pasang secara global langsung dari URL GitHub
npm install -g git+https://github.com/roedyrustam/vibes-plug.git
vibes-plug --all
```
**Opsi B: Git Clone & Multi-Platform Universal Installer**
Clone repositori dan gunakan installer otomatis bawaan untuk mendeteksi serta mengonfigurasi seluruh IDE Anda:
```bash
git clone https://github.com/roedyrustam/vibes-plug.git
cd vibes-plug
npm install
# Pasang ke semua platform yang terpasang di komputer Anda:
npm run install-all
# (atau jalankan node scripts/install.js --all)
```
**Opsi C: Git Clone Langsung untuk Google Antigravity (AGY)**
Google Antigravity memuat plugin secara otomatis dari folder `~/.gemini/config/plugins/`. Anda dapat langsung meng-clone ke direktori plugin tersebut:
```bash
# macOS & Linux:
git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
# Windows (PowerShell):
git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
```
**Opsi D: Pemasangan Spesifik per Proyek**
Dari direktori `vibes-plug` yang sudah di-clone, Anda dapat menyuntikkan rules dan skills ke folder proyek tertentu:
```bash
# Untuk Claude Code (global + proyek spesifik):
node scripts/install.js --claude --project /path/ke/proyek-anda
# Untuk Cursor IDE (proyek spesifik):
node scripts/install.js --cursor --project /path/ke/proyek-anda
# Untuk OpenAI Codex:
node scripts/install.js --codex --project /path/ke/proyek-anda
# Untuk Windsurf, Trae, atau VSCode (Cline):
cp .windsurfrules /path/ke/proyek-anda/
cp .traerules /path/ke/proyek-anda/
cp .clinerules /path/ke/proyek-anda/
```
**Opsi E: Pembaruan Rutin via GitHub**
Untuk mendapatkan update 176 skill dan engine terbaru:
```bash
cd ~/.gemini/config/plugins/vibes-plug # (atau folder hasil clone Anda)
git pull origin main
npm test
```
#### Metode 3: Konfigurasi Manual Berdasarkan Platform (Arsip ZIP / Salin File)
Jika Anda mengunduh arsip `.zip`, ekstrak dan konfigurasikan IDE Anda sebagai berikut:
- **Google Antigravity (AGY):** Pindahkan folder ke `~/.gemini/config/plugins/vibes-plug`.
- **Claude Code:** Jalankan `vibes-plug --claude` atau salin `CLAUDE.md` dan `.claude/rules/` ke root proyek.
- **Cursor IDE:** Jalankan `vibes-plug --cursor --project .` atau salin `.cursorrules` dan `.cursor/rules/` ke root proyek.
- **OpenAI Codex CLI:** Jalankan `vibes-plug --codex` atau salin `CODEX.md` dan `.codex/rules/` ke root proyek.
- **Windsurf IDE:** Salin `.windsurfrules` ke root proyek Anda.
- **Trae IDE:** Salin `.traerules` ke root proyek Anda.
- **VSCode (Cline / Roo):** Salin `.clinerules` ke root proyek Anda.
- **Kimi / Kiro:** Salin `.kimirules` atau `.kirorules` ke root proyek Anda.
### 💻 Cara Penggunaan Plugin & CLI
**1. Prompting Bebas Hambatan (Di dalam IDE)**
Anda *tidak* perlu memanggil nama skill secara manual. Cukup buka Chat AI di IDE Anda dan ketik visi aplikasi Anda:
> *"Buatkan saya platform SaaS multi-tenant dengan sistem pembayaran DOKU Checkout dan QRIS SNAP BI, frontend Next.js 15 App Router dengan Tailwind v4, serta otentikasi role-based dengan RLS PostgreSQL."*
Swarm Director akan otomatis mencegat permintaan, menjalankan Tahap 1 Penemuan Konteks, membuat dokumen `PRD.md` dan `ERD.md`, serta mengorkestrasikan skill-skill yang bekerja sama melalui alur kerja 8-Fase Zero-To-Prod.
**2. Panduan Lengkap Perintah CLI Toolkit**
```bash
# Manajemen Workspace & Skill
vibes init # Men-scaffold struktur Zero-To-Prod 8-Fase (README, PROGRESS, BLUEPRINT, PRD)
vibes bootstrap # Super-scaffold proyek + skill (saas | ecommerce | mobile | api | fullstack | spec-api)
vibes sync # Verifikasi & sinkronisasi aturan pemicu utama di semua IDE
vibes ui # TUI terminal interaktif untuk memilih dan memasang skill secara visual
vibes studio [--port ] # Membuka dashboard web lokal Studio Cockpit (eksplorasi visual 176 skill)
vibes list [filter] # Menampilkan daftar 176 skill (opsional: filter kata kunci)
vibes search # Mencari 176 skill berdasarkan relevansi kata kunci
vibes add # Menyuntikkan skill dari repositori ke proyek lokal (.agents/skills)
vibes remove # Menghapus skill yang terpasang dari proyek lokal
vibes skill info # Menampilkan metadata, deskripsi, dan relasi orkestrasi skill
vibes skill exec # Universal SaaT Dispatcher (blueprint|slice|extract-code|audit|eval|verify|generate|fuzz)
vibes skill chain # Mengeksekusi pipeline multi-skill (saas-launch-gate, ai-agent-hardening, fintech-settlement-gate)
vibes skill compile-slices # Mengompilasi micro-slice terkompresi 93% (<350 token) ke .skill-slices.json
vibes skill matrix # Menampilkan matriks kapabilitas domain & 1.000+ blueprint kode eksekusi
vibes recipe list # Menampilkan daftar paket resep skill (ai-stack, fullstack-pro, fintech-core, spec-driven-api)
vibes recipe apply # Menerapkan paket resep skill ke workspace proyek saat ini
vibes docs [markdown|json] # Mengekspor katalog 176 skill ke terminal, CATALOG.md, atau CATALOG.json
vibes create-skill # Membuat boilerplate skill baru sesuai standar spesifikasi
vibes create-agent --name # Menghasilkan custom subagent lintas Antigravity, Cursor, dan Claude
vibes create-mcp # Men-scaffold server Model Context Protocol baru
# Engine Superintelligence & Verifikasi Formal
vibes guard # Menjalankan seluruh pipeline CI Sovereign Guard (P1–P5 + Anti-Slop + Swarm)
vibes compile-cache # Mengompilasi prefix KV-Cache deterministik (>1024 token) hemat biaya 75-90%
vibes db:eval [file|--sql] # Simulasi & audit migrasi SQL DDL di memori untuk proteksi RLS
vibes ast [args] # Kueri bedah simbol AST (symbols), isolasi fungsi (inspect), atau blast-radius
vibes arbitrate [fileA] [fileB] # Menilai & mengarbitrasi draf kode kompetitif dengan Process Reward Model (PRM)
vibes verify-invariants [file] # Membuktikan formal invarian state machine & menghasilkan spesifikasi SMT-LIB 2.0
vibes swarm "" # Menjalankan Swarm Director otonom (Fan-Out/Fan-In, Saga, Critic-Validator)
vibes memory # Memori episodik proyek & pembuatan checkpoint ultra-ringkas (<150 token)
vibes mcp # Memulai server native Model Context Protocol (MCP v1.x) melalui stdio
# Gerbang Kualitas & Diagnostik
vibes anti-slop # Menjalankan scanner Sovereign Anti-Slop (deteksi placeholder & stub kosong)
vibes anti-slop --strict # Mode CI ketat: setiap peringatan slop membatalkan build
vibes anti-slop --fix # Menghapus otomatis komentar narasi sintaksis yang redundan
vibes audit # Menjalankan zero-tech-debt-auditor untuk kode mati & penegakan tipe ketat
vibes doctor # Memeriksa kesehatan lingkungan dan integrasi seluruh IDE
vibes hooks install # Memasang Git pre-commit hook untuk menegakkan gerbang anti-slop
```
---
## 🇨🇳 中文版 (Mandarin)
欢迎来到 **VibesPlug Pro**。VibesPlug 充当 **集群指挥官 (Swarm Director)**,编排 176 个专业的 AI 子代理。它经过严格工程化设计,旨在从所有前沿模型 (Gemini 4 Pro、Claude 5、GPT-5.6/O3、OpenAI Codex 和 DeepSeek) 中提取最大的推理能力。
### 🚀 通用安装指南 (所有 IDE 和 LLM)
*支持的平台: Google Antigravity, Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline), Kimi, Kiro。*
#### 方法 1: CLI (NPM 安装 - 推荐)
```bash
npm i -g vibes-plug
vibes-plug init
```
#### 方法 2: 通过 GitHub 安装 (Git Clone / NPX 直接运行 - 始终获取最新版)
您可以直接从 GitHub 仓库安装或运行 VibesPlug:
**选项 A: 通过 NPX 直接从 GitHub 运行 (无需克隆)**
```bash
# 运行安装程序至所有检测到的 IDE
npx github:roedyrustam/vibes-plug --all
# 或直接通过 Git URL 全局安装
npm install -g git+https://github.com/roedyrustam/vibes-plug.git
vibes-plug --all
```
**选项 B: 克隆并运行多平台安装程序**
```bash
git clone https://github.com/roedyrustam/vibes-plug.git
cd vibes-plug
npm install
npm run install-all
```
**选项 C: 直接克隆至 Google Antigravity (AGY)**
```bash
# macOS / Linux
git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
# Windows (PowerShell)
git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
```
**选项 D: 针对特定项目的注入安装**
```bash
# Claude Code:
node scripts/install.js --claude --project /path/to/project
# Cursor IDE:
node scripts/install.js --cursor --project /path/to/project
# OpenAI Codex:
node scripts/install.js --codex --project /path/to/project
```
**选项 E: 通过 GitHub 保持最新**
```bash
cd ~/.gemini/config/plugins/vibes-plug
git pull origin main
npm test
```
#### 方法 3: 平台专属配置
- **Antigravity (Google):** 移至 `~/.gemini/config/plugins/vibes-plug`,规则位于 `rules/AGENTS.md`,MCP 服务配置在 `mcp_config.json`。
- **Claude Code:** 运行 `vibes-plug --claude` 或将 `CLAUDE.md` 与 `.claude/rules/` 复制到项目根目录。
- **Cursor IDE:** 运行 `vibes-plug --cursor --project .` 或将 `.cursorrules` 与 `.cursor/rules/` 复制到项目根目录。
- **OpenAI Codex:** 运行 `vibes-plug --codex` 或将 `CODEX.md` 与 `.codex/rules/` 复制到项目根目录。
- **Windsurf / Trae / VSCode (Cline):** 复制对应的 `.windsurfrules`、`.traerules` 或 `.clinerules` 到项目根目录。
### 💻 核心 CLI 命令
- `vibes init ` — 初始化 8 阶段端到端项目架构。
- `vibes ui` — 终端交互式 TUI 界面,可视化选择与安装技能。
- `vibes studio [--port ]` — 启动本地 Web Studio 驾驶舱仪表板 (176 个技能可视化探索、子代理集群与 P1-P5 引擎)。
- `vibes recipe list` — 列出预置技能配方套件 (ai-stack, fullstack-pro, fintech-core, spec-driven-api)。
- `vibes docs [markdown|json]` — 导出 176 个技能的完整目录至终端、`CATALOG.md` 或 `CATALOG.json`。
- `vibes guard` — 运行完整的 Sovereign Guard CI 生产就绪验证流水线 (P1–P5 + Anti-Slop)。
- `vibes compile-cache` — 编译并锁定确定性 KV-Cache 前缀 (>1024 tokens),降低 75-90% 代币开销。
- `vibes db:eval` — 在内存沙箱中模拟和审计 SQL DDL 迁移及 RLS 策略。
- `vibes ast ` — 精确查询 AST 代码符号并计算重构影响范围 (blast-radius)。
- `vibes arbitrate` — 使用过程奖励模型 (PRM) 评分并仲裁竞品代码草稿。
- `vibes verify-invariants` — 形式化验证状态机并生成用于 Z3 的 SMT-LIB 2.0 规格。
- `vibes swarm ""` — 启动自主多代理集群协同 (Fan-Out/Fan-In, Saga, Critic-Validator)。
- `vibes memory` — 本地跨会话情节记忆与超紧凑检查点 (<150 tokens)。
- `vibes mcp` — 在 stdio 上启动原生 Model Context Protocol (MCP v1.x) 8 项前沿工具服务。
- `vibes anti-slop` — 运行零废话代码扫描器,消除未实现的代码桩与占位符。
---
## 🇩🇪 Deutsche Version (German)
Willkommen bei **VibesPlug Pro**. VibesPlug fungiert als **Swarm Director** und orchestriert 176 spezialisierte KI-Subagenten. Es wurde streng dafür entwickelt, maximale Schlussfolgerungsfähigkeiten aus ALLEN Frontier-Modellen (Gemini 4 Pro, Claude 5, GPT-5.6/O3, OpenAI Codex und DeepSeek) zu extrahieren.
### 🚀 Universelle Installationsanleitung (Alle IDEs & LLMs)
*Unterstützte Plattformen: Antigravity, Claude Code, Cursor, OpenAI Codex, Windsurf, Trae, VSCode (Cline), Kimi, Kiro.*
#### Methode 1: CLI (NPM-Installation - Empfohlen)
```bash
npm i -g vibes-plug
vibes-plug init
```
#### Methode 2: GitHub-Installation (Git Clone / Direkt per NPX - Immer aktuell)
Sie können VibesPlug direkt aus dem GitHub-Repository ausführen oder installieren:
**Option A: Direkte Ausführung via NPX (Kein Klonen erforderlich)**
```bash
# Installer direkt von GitHub ausführen
npx github:roedyrustam/vibes-plug --all
# Oder global via Git URL installieren
npm install -g git+https://github.com/roedyrustam/vibes-plug.git
vibes-plug --all
```
**Option B: Git Clone & Universeller Installer**
```bash
git clone https://github.com/roedyrustam/vibes-plug.git
cd vibes-plug
npm install
npm run install-all
```
**Option C: Direktes Klonen für Google Antigravity (AGY)**
```bash
# macOS & Linux:
git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
# Windows (PowerShell):
git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
```
**Option D: Gezielte Installation pro Projekt**
```bash
# Claude Code:
node scripts/install.js --claude --project /pfad/zum/projekt
# Cursor IDE:
node scripts/install.js --cursor --project /pfad/zum/projekt
# OpenAI Codex:
node scripts/install.js --codex --project /pfad/zum/projekt
```
**Option E: Aktualisierung via GitHub**
```bash
cd ~/.gemini/config/plugins/vibes-plug
git pull origin main
npm test
```
#### Methode 3: Plattformspezifische manuelle Konfiguration
- **Antigravity (Google):** Nativ installiert in `~/.gemini/config/plugins/vibes-plug` mit Regeln in `rules/AGENTS.md` und MCP-Server in `mcp_config.json`.
- **Claude Code:** `vibes-plug --claude` ausführen oder `CLAUDE.md` & `.claude/rules/` kopieren.
- **Cursor IDE:** `vibes-plug --cursor --project .` ausführen oder `.cursorrules` & `.cursor/rules/` kopieren.
- **OpenAI Codex:** `vibes-plug --codex` ausführen oder `CODEX.md` & `.codex/rules/` kopieren.
- **Windsurf / Trae / Cline:** Entsprechende `.windsurfrules`, `.traerules` oder `.clinerules` in das Stammverzeichnis kopieren.
### 💻 Wichtigste CLI-Befehle
- `vibes init ` — Initialisiert die 8-Phasen-Zero-To-Prod-Architektur.
- `vibes ui` — Interaktives Terminal-TUI zur visuellen Auswahl und Installation von Skills.
- `vibes studio [--port ]` — Startet das lokale Web-Studio-Dashboard (visueller 176-Skill-Explorer, Subagenten-Swarm und P1–P5 Cockpit).
- `vibes recipe list` — Listet kuratierte Skill-Pakete auf (ai-stack, fullstack-pro, fintech-core, spec-driven-api).
- `vibes docs [markdown|json]` — Exportiert den vollständigen 176-Skill-Katalog ins Terminal, als `CATALOG.md` oder `CATALOG.json`.
- `vibes guard` — Führt die vollständige Sovereign Guard CI-Validierung aus (P1–P5 + Anti-Slop).
- `vibes compile-cache` — Kompiliert deterministische KV-Cache-Präfixe (>1024 Tokens) für 75–90% Kostensenkung.
- `vibes db:eval` — Simuliert und prüft SQL-DDL-Migrationen im Speicher auf RLS-Sicherheit.
- `vibes ast ` — Führt AST-Symbolabfragen durch und berechnet den Refactoring-Blast-Radius.
- `vibes arbitrate` — Bewertet konkurrierende Code-Entwürfe mittels Process Reward Models (PRM).
- `vibes verify-invariants` — Mathematischer Beweis von Zustandsübergängen & SMT-LIB 2.0 Generierung für Z3.
- `vibes swarm ""` — Führt den autonomen Swarm Director aus (Fan-Out/Fan-In, Saga, Critic-Validator).
- `vibes memory` — Lokales episodisches Gedächtnis und ultrakompakte Checkpoints (<150 Tokens).
- `vibes mcp` — Startet den nativen Model Context Protocol (MCP v1.x) Server über stdio.
- `vibes anti-slop` — Erkennt und eliminiert unfertigen Code, `// TODO` und leere Stubs.
---
## 🇯🇵 日本語版 (Japanese)
**VibesPlug Pro** へようこそ。VibesPlug は **スウォームディレクター (Swarm Director)** として機能し、176 の専門的な AI サブエージェントをオーケストレーションします。すべての最先端モデル (Gemini 4 Pro、Claude 5、GPT-5.6/O3、OpenAI Codex、DeepSeek) から最大の推論能力を引き出すように厳密に設計されています。
### 🚀 ユニバーサルインストールガイド (すべての IDE と LLM)
*サポートされているプラットフォーム: Google Antigravity, Claude Code, Cursor, OpenAI Codex, Windsurf, Trae, VSCode (Cline), Kimi, Kiro。*
#### 方法 1: CLI (NPM インストール - 推奨)
```bash
npm i -g vibes-plug
vibes-plug init
```
#### 方法 2: GitHub 経由のインストール (Git Clone / NPX 直接実行 - 常に最新版)
GitHub リポジトリから直接 VibesPlug を実行またはインストールできます。
**オプション A: NPX を使用した直接実行 (クローン不要)**
```bash
# 検出されたすべての IDE にインストーラーを実行
npx github:roedyrustam/vibes-plug --all
# または GitHub の Git URL からグローバルにインストール
npm install -g git+https://github.com/roedyrustam/vibes-plug.git
vibes-plug --all
```
**オプション B: Git クローンとユニバーサルインストーラー**
```bash
git clone https://github.com/roedyrustam/vibes-plug.git
cd vibes-plug
npm install
npm run install-all
```
**オプション C: Google Antigravity への直接クローン**
```bash
# macOS & Linux:
git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
# Windows (PowerShell):
git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
```
**オプション D: プロジェクト別のターゲットインストール**
```bash
# Claude Code:
node scripts/install.js --claude --project /path/to/project
# Cursor IDE:
node scripts/install.js --cursor --project /path/to/project
# OpenAI Codex:
node scripts/install.js --codex --project /path/to/project
```
**オプション E: GitHub 経由での最新版への更新**
```bash
cd ~/.gemini/config/plugins/vibes-plug
git pull origin main
npm test
```
#### 方法 3: プラットフォーム別手動インストール
- **Antigravity (Google):** `~/.gemini/config/plugins/vibes-plug` にネイティブ配置、ルールは `rules/AGENTS.md`、MCP サーバーは `mcp_config.json`。
- **Claude Code:** `vibes-plug --claude` を実行、または `CLAUDE.md` と `.claude/rules/` をプロジェクトルートにコピー。
- **Cursor IDE:** `vibes-plug --cursor --project .` を実行、または `.cursorrules` と `.cursor/rules/` をプロジェクトルートにコピー。
- **OpenAI Codex:** `vibes-plug --codex` を実行、または `CODEX.md` と `.codex/rules/` をプロジェクトルートにコピー。
- **Windsurf / Trae / Cline:** それぞれのルールファイルをプロジェクトルートにコピー。
### 💻 主な CLI コマンド
- `vibes init ` — 8フェーズ Zero-To-Prod 開発プロジェクトを初期化。
- `vibes ui` — スキルを視覚的に選択してインストールするインタラクティブなターミナル TUI。
- `vibes studio [--port ]` — ローカル Web Studio コックピットダッシュボードを起動 (176スキルの視覚的探索、サブエージェント、P1-P5)。
- `vibes recipe list` — キュレーションされたスキルレシピ一覧 (ai-stack, fullstack-pro, fintech-core, spec-driven-api)。
- `vibes docs [markdown|json]` — 176のスキル全カタログをターミナル、`CATALOG.md`、または `CATALOG.json` に出力。
- `vibes guard` — 完全な Sovereign Guard CI パイプラインを実行 (P1–P5 + Anti-Slop)。
- `vibes compile-cache` — 決定論的 KV-Cache プレフィックス (>1024 トークン) をコンパイルし、コストを 75-90% 削減。
- `vibes db:eval` — インメモリで SQL DDL マイグレーションをシミュレーションし、RLS ポリシーを監査。
- `vibes ast ` — AST シンボルを外科的に検索し、依存関係の影響範囲 (blast-radius) を計算。
- `vibes arbitrate` — Process Reward Model (PRM) を用いて競合するコードドラフトを評価・仲裁。
- `vibes verify-invariants` — 状態遷移の不変条件を形式的に証明し、Z3 用の SMT-LIB 2.0 仕様を生成。
- `vibes swarm ""` — 自律型スウォームディレクターを実行 (Fan-Out/Fan-In, Saga, Critic-Validator)。
- `vibes memory` — クロスセッションのエピソード記憶と超コンパクトなチェックポイント (<150 トークン)。
- `vibes mcp` — stdio 経由で 8 つの高度なツールを備えたネイティブ MCP (v1.x) サーバーを起動。
- `vibes anti-slop` — 未完成のコード、不要なコメント、プレースホルダーを検出・排除。
---
## 📈 Star History & Growth
Support open-source AI innovation! Drop a ⭐ star on this repo to help it reach more developers worldwide.
---
## 🤝 Community & Contributing
Contributions are warmly welcome! Whether you are:
- Submitting a new AI domain skill
- Reporting a bug or edge-case
- Improving multilingual prompts & docs
Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
### 🏷️ GitHub Topics & Ecosystem Taxonomy
`ai-agents` • `multi-agent-swarm` • `mcp-server` • `model-context-protocol` • `skill-as-a-tool` • `claude-code` • `cursor-rules` • `antigravity` • `openai-codex` • `vibe-coding` • `agentic-ai` • `reverse-engineering` • `ghidra` • `binary-analysis` • `rea` • `fullstack` • `nextjs15` • `react19` • `tailwindcss-v4` • `zero-to-prod`
## 📄 License
Distributed under the [MIT License](LICENSE). Built for the global developer ecosystem.
---
Engineered by Roedy Rustam & Open-Source Contributors. Empowered by Frontier AI with Human Reasoning.