Back to Home
Reference

Technical Reference

Full architecture documentation, layer specifications, configuration reference, and metrics framework.

This is the technical reference for Visdom Code Review. It covers the full architecture, each layer in detail, configuration options, metrics framework, and reference implementations.

✅ Looking for the guide?

If you're evaluating VCR, start with the role-specific guides: For Leaders, For Platform Engineers, or For Developers.

Architecture

Architecture Overview

Layered Review Agent model, risk-based gating, design decisions, Visdom SDLC integration.

Layers

Layer 0: Context <10s

Deterministic context gathering, repository knowledge layer, TORS input, path classification.
Layer 1: Deterministic <60s

Zero AI. Linters, SAST, secrets, coverage delta, TORS filtering. Cannot be prompt-injected.
Layer 2: AI Quick Scan <2 min

AI Quick Scan, risk classifier, 8 documented risks with evidence and mitigations.
Layer 3: AI Deep Review <10 min

Deep review with Review Lenses, circular test detection, custom lenses.

Output & Scanning

Reporter

PR comment format, inline comments, output channels.

Proactive Scanner

Cron-based repository analysis: convention drift, coverage trends, tech debt, security baseline.

Configuration & Metrics

Configuration

vcr-config.yaml reference, repository structure, GitHub Actions workflow.

Metrics Framework

Per-layer metrics, ITS/CPI/TORS definitions, feedback mechanism.

Evaluation Methodology

Precision, recall, F1, signal-to-noise ratio, ground truth framework. Based on CR-Bench and SNR methodology.

Reference Implementations

Technology-agnostic component table, VirtusLab references, out of scope, open questions.
Architecture