Gold-standard rubrics

The versioned standards VibeCode QA judges your code against — fixed, reviewable ground truth, not a model's memory of a blog post. Every rule has a stable ID (R-<AREA>-n), the reason it exists, a ✓/✗ example, and a machine-readable detection signal.

How it works

Standards are composed per slice, not stamped one-per-stack. VibeCode QA detects what each part of your repo is, then judges it against exactly the right set:

your repo  →  slice it  →  1 archetype  +  N layers  +  cross-cutting  →  judge vs pinned edition

So a monorepo is judged slice-by-slice: a React SPA frontend against react-spa, a Cloudflare Functions API against pages-fullstack, an SDK against library — each with its own rubric. The machine-readable catalog (detection rules + editions) lives at /standards/registry.json.

Archetypes — the app-shape spine, one per slice

StandardWhat it isStatus
react-spaReact, client-rendered, static-hosted. No SSR, no server of its own.v1 · LIVE
pages-fullstackStatic frontend + API co-deployed as Cloudflare Pages Functions.planned
worker-edgeA standalone Cloudflare Worker / Durable Object service.planned
node-serviceA Node HTTP service or CLI. Not shipped to a browser.planned
libraryA published package consumed by other code.planned
react-ssrServer-rendered React (Next.js / React Router / Remix).planned

Layers — capabilities that compose onto an archetype

StandardWhat it isStatus
d1-databaseCloudflare D1: schema, migrations, parameterized queries.planned
mcp-serverModel Context Protocol tools: schemas, scopes, audit.planned
tailwindTailwind v4 CSS-first, tokens in @theme, no runtime CSS-in-JS.planned
tanstack-queryServer-cache for remote data: caching, dedupe, loading/error.planned
zod-validationRuntime schema validation at boundaries.planned

Cross-cutting — apply to every slice

StandardWhat it isStatus
typescriptStrict flags, project references, no-any, typed boundaries.planned
securitySecrets handling, XSS/injection, dependency supply chain.planned
testingRunner choice, behavior-not-implementation, coverage floor, CI.planned
accessibilitySemantics, keyboard, focus, ARIA, contrast.planned
dependenciesLockfile pinning, audit, vetting, no rogue install scripts.planned

Recipes — blessed combos; the seam rules only

StandardWhat it isStatus
react-spa-on-cloudflare-pagesSPA + Functions in one Pages project: same-origin /api/*, _routes.json, secrets in Functions.planned

Editions never rot

A standard is versioned on change, not dated — a new edition is cut only when best practice materially shifts. Each carries a review date so a scan can flag "judged against a standard last verified N months ago." Today: react-spa v1 targets React 19 · Vite 8 · Tailwind 4 · TS 6, reviewed 2026-07.

Run it yourself: npx @vibecodeqa/cli · Machine-readable catalog: registry.json