VibeGuard

VibeGuard

[](https://github.com/majiayu000/vibeguard/actions/workflows/ci.yml)

**Stop AI from hallucinating code.**

[Chinese Docs](docs/README_CN.md) | [Rule Reference](docs/rule-reference.md) | [Contributing](CONTRIBUTING.md)

When using Claude Code or Codex, AI frequently invents non-existent APIs, reinvents the wheel, hardcodes fake data, and over-engineers solutions. VibeGuard prevents these problems at the source through **rule injection + real-time interception + static scanning**.

**VibeGuard vs [Everything Claude Code](https://github.com/anthropics/everything-claude-code):** ECC is a general-purpose productivity toolkit. VibeGuard is a specialized **defense system** — native rules, hook-based interception for Claude Code and Codex, churn loop detection, analysis-paralysis protection, and structured event logging. **They're complementary, not competing.** ECC helps AI do more; VibeGuard stops AI from doing the wrong thing.

Inspired by [OpenAI Harness Engineering](https://openai.com/index/harness-engineering/) and [Stripe Minions](https://www.youtube.com/watch?v=bZ0z1ApYjJo). Fully implements all 5 Harness Golden Principles.

The Problem

You:  "Add a login endpoint"
AI:   Creates auth_service.py (duplicate of existing auth.py)
      Imports non-existent library `flask-auth-magic`
      Hardcodes JWT secret as "your-secret-key"
      Adds 200 lines of "improvements" you didn't ask for

**VibeGuard catches all of these automatically, before they reach your codebase.**

Quick Start

git clone https://github.com/majiayu000/vibeguard.git ~/vibeguard
bash ~/vibeguard/setup.sh

Open a new Claude Code or Codex session. Run `bash ~/vibeguard/setup.sh --check` to verify.

Documentation Map

Doc	Purpose
docs/README_CN.md	Chinese overview and setup guide
docs/rule-reference.md	Rule layers, guard coverage, and language-specific checks

...