VibesPlug Logo # ⚡ 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)

Web Showcase GitHub Stars GitHub Forks NPM Version NPM Downloads License Share on X

⭐ 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)
--- ### 🎬 Swarm Director in Action
VibesPlug Swarm Demo

### ⚡ Universal 1-Line Installers (Zero-Config Global Setup) ```bash # 🐧 Linux / 🍏 macOS / 🪟 WSL (Bash / Zsh): curl -fsSL https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.sh | bash # 🪟 Windows (PowerShell): irm https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.ps1 | iex # 📦 Or via NPX / GitHub: npx vibes-plug init npx github:roedyrustam/vibes-plug --all ``` --- ## 💥 Why VibesPlug? (The Paradigm Shift) | Metric / Capability | Vanilla Vibe Coding (Prompts) | Static IDE Rules (.cursorrules) | ⚡ VibesPlug Pro (Swarm) | | :--- | :--- | :--- | :--- | | **Agent Coordination** | ❌ 1 confused LLM doing everything | ⚠️ Static rules without orchestration | 🤖 **Swarm Director & 176 Specialists** | | **Full-Stack Lifecycle** | ❌ Fragmented & prone to regressions | ⚠️ Ad-hoc guidance | 🚀 **Autonomous 8-Phase Zero-To-Prod** | | **Self-Evolving Skills** | ❌ Stale knowledge | ❌ Manual rule authoring | 🧬 **`vibes evolve` & Multi-Platform Codex Generator** | | **CI Resilience** | ❌ Breaks on node version mismatches | ❌ No auto-remediation | 🩺 **Autonomous CI Auto-Healer (`vibes ci:heal`)** | | **Tech Stack** | ⚠️ Often outputs legacy 2022 patterns | ⚠️ Stale prompts | ⚡ **React 19, Next 15, Tailwind v4, Bun 1.2+** | | **Code Gardening & QA** | ❌ Hallucinated dead code & slop | ❌ No automated debt check | 🧹 **Zero-Tech-Debt Auditor & Red Teaming** | | **Sovereign Anti-Slop** | ❌ Lazy stubs, placeholder stubs, & fluff | ⚠️ Untested static prompts | 🛡️ **Zero-Tolerance Anti-Slop Engine & Scanner** | | **Payment & Micro-Economy** | ❌ Incomplete integrations | ⚠️ Basic docs | 💳 **DOKU Checkout, SNAP BI, Stripe, M2M Agent Wallets** | | **Visual Studio Cockpit** | ❌ None | ❌ None | 🎨 **Interactive 2D Graph (2,435 edges) & Swarm Blackboard** | | **Native MCP Server** | ❌ None | ❌ None | 🔌 **Stdio & SSE MCP v1.x Server with 42 Frontier Tools & Profile Masking** | | **Distribution** | ⚠️ Complex global installs | ⚠️ Manual copying | 📦 **Single-Binary (`vibes package:binary`) & 1-Line Shell Installers** | | **IDE Portability** | ❌ Locked to one interface | ⚠️ Cursor only | 🌐 **Antigravity, Cursor, Claude Code, Codex, Windsurf, Trae** | --- ## 🧩 The 176-Skill Arsenal (Category Breakdown) VibesPlug Pro is powered by **176 specialized AI domain skills**, coordinated autonomously by the master ideation orchestrators (`brainstorming` and `zero-to-prod-orchestrator`). > 📖 **Browse Complete Directory**: View the comprehensive [176-Skill Interactive Catalog (`CATALOG.md`)](CATALOG.md) or explore the interactive live showcase at [**vibes-plug.vercel.app**](https://vibes-plug.vercel.app/) or generate machine-readable indexes anytime via `vibes docs markdown` or `vibes docs json`. | 🎨 **Frontend & Mobile UI/UX** (39 Skills) | ⚙️ **Backend, Systems & API Design** (28 Skills) | | :--- | :--- | | `angular-expert`
`apple-ecosystem-expert`
`astro-framework-expert`
`blockchain-web3-expert`
`browser-extension-mv3-pro`
`design-system-architect`
`desktop-electron-expert`
`ephemeral-generative-ui-architect`
`flutter-dart-expert`
`form-validation-expert`
`global-a11y-i18n-expert`
`glsl-shader-expert`
`hig`
`htmx-hypermedia-expert`
`micro-frontend-architect`
`mobile-expo-expert`
`modern-css-native-expert`
`mpa-orchestrator`
`multimodal-spatial-video-cloner`
`nextjs-app-router-expert`
`performance-web-vitals`
`pwa-offline-first-expert`
`reactive-sync-engine-expert`
`rich-text-editor-expert`
`screenshot-to-code-expert`
`senior-frontend`
`solidjs-expert`
`spa-orchestrator`
`state-management-expert`
`svelte-sveltekit-expert`
`svg-animation-motion-expert`
`tailwind-expert`
`tanstack-query-expert`
`tauri-expert`
`ui-ux-pro-max`
`visual-ui-auditor`
`vue-frontend-expert`
`web-3d-graphics-expert`
`webxr-ar-vr-expert` | `api-design-expert`
`api-gateway-proxy-expert`
`async-queue-temporal-expert`
`autonomous-api-drift-healer`
`bun-runtime-expert`
`cloudflare-workers-expert`
`composable-mach-architect`
`cron-scheduler-expert`
`domain-driven-design-expert`
`ephemeral-wasm-sandbox-executor`
`event-driven-architect`
`fullstack-expert`
`go-programming-expert`
`graphql-apollo-expert`
`js-backend-expert`
`legacy-code-translator`
`living-codebase-ast-graph`
`monorepo-architect`
`mvc-expert`
`openapi-swagger-codegen-expert`
`python-programming-expert`
`rust-programming-expert`
`scalability-clean-code`
`spec-driven-development-expert`
`structured-output-contracts`
`typescript-expert`
`wasm-edge-computing-expert`
`web-game-engine-expert` | | 🤖 **Frontier AI, LLM, MCP & Multi-Agent** (34 Skills) | 💸 **SaaS, FinTech, E-Commerce & Growth** (17 Skills) | | :--- | :--- | | `a2a-agent-protocol-expert`
`adaptive-model-cascade`
`affective-computing-emotion-ai`
`agentic-coding-workflow-expert`
`agentic-memory-architect`
`agentic-micro-economy-architect`
`ai-llm-integration-expert`
`ai-media-generation-expert`
`ai-prompt-engineering-expert`
`ai-safety-governance-expert`
`computer-use-os-agent-expert`
`context-window-engineer`
`deep-research-analyst`
`doku-mcp-server`
`durable-agent-execution-expert`
`frontier-ai-models-expert`
`gemini-agent-booster`
`graph-rag-knowledge-expert`
`kv-cache-prefix-optimizer`
`llm-finops-router`
`llm-observability-expert`
`local-slm-edge-ai-expert`
`mcp-server-architect`
`multi-agent-orchestration`
`parallel-tool-orchestrator`
`pydantic-ai-expert`
`speculative-multi-draft-synthesizer`
`synthetic-data-finetuning-expert`
`test-time-compute-optimizer`
`thinking-budget-orchestrator`
`vector-db-rag-expert`
`vercel-ai-sdk-expert`
`voice-ai-realtime-agent`
`xerj-search-expert` | `agentic-m2m-settlement`
`app-promo-media-expert`
`chatbot-messaging-expert`
`data-telemetry-expert`
`doku-payment-gateway`
`double-entry-ledger-fintech-expert`
`ecommerce-expert`
`email-notification-expert`
`feature-flag-analytics-expert`
`headless-cms-expert`
`n8n-automation-expert`
`payment-gateway-expert`
`saas-architect`
`saas-billing`
`saas-multi-tenant`
`seo`
`wordpress-headless-expert` | | 🛡️ **Testing, Security, Anti-Slop & Reverse Engineering** (31 Skills) | 🚀 **Data, Media, Lifecycle & DevOps Orchestration** (27 Skills) | | :--- | :--- | | `accessibility-testing-expert`
`ai-code-review-autonomous`
`anti-slop`
`app-analyzer-optimizer`
`authentication-identity-expert`
`autonomous-red-teamer`
`autonomous-tdd-debugger`
`biome-linter-formatter-expert`
`coderabbit`
`compliance-gdpr-privacy-expert`
`e2e-testing-expert`
`error-resilience-expert`
`fga-rebac-authorization-expert`
`firebase-security-expert`
`formal-spec-z3-verifier`
`logging-error-tracking-expert`
`mcp-sampling-critic`
`passkeys-webauthn-identity-expert`
`post-quantum-crypto-migrator`
`prompt-injection-firewall`
`property-mutation-testing-expert`
`rate-limit-abuse-prevention`
`rea-analysis-optimization`
`rea-changelog-update`
`rea-ci-tests-audit`
`rea-tool-design`
`reverse-engineer-anything`
`sbom-supply-chain-security-expert`
`supabase-security-expert`
`zero-tech-debt-auditor`
`zero-trust-secret-vault` | `brainstorming`
`browser-automation-expert`
`ci-cd-devops-architect`
`cloud-hosting-expert`
`data-pipeline-etl-expert`
`data-visualization-expert`
`database-orm-expert`
`dependency-upgrade-migrator`
`docker-container-expert`
`documentation-site-expert`
`file-upload-media-expert`
`geospatial-maps-expert`
`github-actions-expert`
`kubernetes-gitops-platform-expert`
`olap-columnar-analytics-expert`
`pdf-document-generation-expert`
`prd-architect`
`proactive-background-watcher`
`production-ready-hardener`
`realtime-collaboration-expert`
`search-engine-expert`
`self-healing-cloud-orchestrator`
`session-memory-manager`
`sse-websocket-streaming-expert`
`web-scraper`
`website-design-cloner`
`zero-to-prod-orchestrator` | --- ## 🤖 Native Specialist Subagents (Antigravity & Swarm Topologies) VibesPlug bundles 9 dedicated specialist subagents residing in `agents/`, ready to execute complex cross-domain tasks autonomously via Fan-Out / Fan-In and Critic-Validator loops: | Specialist Subagent | File | Core Mission & Bound Skills | | :--- | :--- | :--- | | **`swarm-architect`** | [`agents/swarm-architect.md`](agents/swarm-architect.md) | **Discovery, PRD & ERD**: High-level system architecture, PostgreSQL DDL schemas, and DDD bounded contexts. | | **`fullstack-craftsman`** | [`agents/fullstack-craftsman.md`](agents/fullstack-craftsman.md) | **Production Fullstack**: React 19, Next.js 15, Tailwind v4, Hono/Bun/Node backend, and Prisma/Drizzle ORM. | | **`quality-guardian`** | [`agents/quality-guardian.md`](agents/quality-guardian.md) | **Zero-Tolerance Quality Gate**: TDD self-healing, Playwright E2E, adversarial security fuzzing, and Anti-Slop audit. | | **`fintech-payment-sentinel`** | [`agents/fintech-payment-sentinel.md`](agents/fintech-payment-sentinel.md) | **FinTech & Payments**: DOKU Checkout, SNAP BI Direct API, HMAC-SHA512 webhook security, and atomic idempotency. | | **`ai-mcp-engineer`** | [`agents/ai-mcp-engineer.md`](agents/ai-mcp-engineer.md) | **AI & MCP Protocols**: Model Context Protocol (MCP v1.x) servers, A2A agent interoperability, durable workflows, and Gemini booster. | | **`cloud-devops-sre`** | [`agents/cloud-devops-sre.md`](agents/cloud-devops-sre.md) | **Cloud, DevOps & SRE**: Kubernetes GitOps (ArgoCD/Cilium), Docker hardening, CycloneDX SBOM supply chain security, and Zero-Trust secrets. | | **`data-rag-architect`** | [`agents/data-rag-architect.md`](agents/data-rag-architect.md) | **Data, OLAP & RAG**: ClickHouse/DuckDB OLAP analytics, Linear-style reactive sync engines, hybrid Vector/Graph RAG, and OpenFGA/SpiceDB ReBAC. | | **`mobile-spatial-craftsman`** | [`agents/mobile-spatial-craftsman.md`](agents/mobile-spatial-craftsman.md) | **Mobile, Desktop & Spatial**: React Native/Expo, Flutter, Tauri v2, 3D WebGPU/Three.js, TSL/WGSL shaders, and WebXR spatial computing. | | **`reverse-security-auditor`** | [`agents/reverse-security-auditor.md`](agents/reverse-security-auditor.md) | **Reverse Engineering & Binary Audit**: REA/Ghidra/LLDB binary decompilation, Electron/firmware triage, `Evidence` spans, and Z3/SBOM verification. | > 💡 **Custom Agent Generation**: Create tailored subagents for any project across Antigravity (`.agents/agents/`), Cursor (`.cursor/rules/`), and Claude Code (`.claude/rules/`) using `vibes create-agent --name --skills `. --- ## 🧠 Superintelligence Engineering Substrate (P1 – P7 Engines) VibesPlug Pro embeds 7 foundational engineering engines that give AI models sub-millisecond AST precision, deterministic caching, in-memory sandboxing, and mathematical theorem proving: | Engine | Command | Description | | :--- | :--- | :--- | | **P1: Prompt-Cache Compiler** | `vibes compile-cache` | Compiles deterministic prefix instruction set into `.cache-prefix.json` (>1024 tokens) to lock KV-Cache reuse, slashing billing by 75–90% and accelerating TTFT by 10x. | | **P2: In-Memory DB Sandbox** | `vibes db:eval [file\|--sql]` | In-memory SQLite DDL/migration simulation engine to audit RLS policies, catch missing FK indexes, and prevent destructive `DROP TABLE/COLUMN` before production. | | **P3: AST Subgraph Engine** | `vibes ast [args]` | In-memory AST symbol inspection (`symbols`), targeted function isolation (`inspect`), and dependency blast radius calculation without token bloat. | | **P4: Speculative PRM Arbiter**| `vibes arbitrate [draftA] [draftB]`| Heuristic Process Reward Model (PRM) evaluator scoring competing code drafts across Type Safety, Anti-Slop, Error Resilience, and Algorithmic Complexity. | | **P5: Invariant Verifier (SMT)**| `vibes verify-invariants [file]` | Proves state machine transitions (SaaS billing, auth, orders), detects unreachable states and deadlocks, and generates SMT-LIB 2.0 specifications for Z3/CVC5. | | **P6: Ephemeral WASM/VM Sandbox**| `vibes sandbox ""` | 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.