VibeCheck

Competence-aware guardrails for AI-assisted coding

$ pip install vibecheck-hoohacks
🧠

Knowledge Gate

Automatically evaluates code change complexity against your demonstrated competence level.

🎯

Targeted Q&A

Generates questions that probe understanding of why code works, not just what it does.

📈

Competence Tracking

Persistent YAML model tracks your skills across Python concepts and patterns.

🔄

Scaffolding

3-level difficulty adaptation from conceptual questions to direct hints.

How It Works

1

Intercept

Claude Code calls a tool. VibeCheck intercepts before the change is applied.

2

Evaluate

The knowledge gate assesses complexity against your competence model.

3

Question

Complex changes trigger an interactive Q&A that tests your understanding.

4

Learn

Your competence model updates based on your demonstrated knowledge.