VibeCode QA¶
Code health scanner for the AI coding era. 34 checks across 7 categories, zero config, a single 0–100 score with a full HTML report — in about five seconds.
That auto-detects your stack (TypeScript/JavaScript, React/Vue/Svelte, Node, or Dart/Flutter), runs every check, prints a scored summary, and writes a multi-page HTML report to .vibe-check/.
What you get¶
-
One score, graded A–F
A weighted composite (0–100) you can track over time, gate CI on, and post to pull requests.
-
34 checks, 7 categories
Foundations, Quality, Testing, Architecture, Security, AI Readiness, and AI Analysis. See them all.
-
Built for AI-assisted code
Confusion Index and Context Locality measure how easily an LLM can understand and safely edit your code.
-
A full HTML report
Architecture diagrams, trend tracking, file hotspots, and a copy-pasteable fix prompt for every issue.
How a scan flows¶
flowchart LR
A[npx @vibecodeqa/cli] --> B[Detect stack<br/>and workspace]
B --> C[Run 34 checks]
C --> D[Weighted score<br/>0–100 · A–F]
D --> E[Terminal summary]
D --> F[HTML report<br/>.vibe-check/]
D --> G[JSON · SARIF · badge]
Next steps¶
- The 34 checks — what each one measures, why it matters, and how to fix it
- Scoring — how the composite score is calculated
- Architecture — how the scanner works under the hood
- CI integration — quality gates, PR comments, GitHub Actions
- CLI reference — every command and flag