VisualQ

Project quality gates

Opt-in merge and release blocking rules per pillar — configure thresholds in project settings.

Quality gates are opt-in. Until you configure them under Project settings → Quality gates, VisualQ does not block PR merges, release status, or CI runs based on project policy.

Where to configure

  1. Open a project in VisualQ
  2. Go to Settings → Quality gates
  3. Click Add gate on each active pillar you want to enforce
  4. Enter explicit thresholds (required fields — no implicit defaults)
  5. Save

Only enabled quality modules for the project can receive gates. Disabled modules show a link to Quality modules.

What gates affect

SurfaceBehavior without gatesWith configured gates
Project overview Release gateClear (no automatic blockers)Blocked when a configured pillar exceeds its threshold
MCP / CI gate_pr_qualityblockMerge: false (unless MCP overrides)Evaluates configured pillars only
CI perf/a11y budgetsWorkflow inputs onlyInjects budgets from perf/a11y gate config when CI omits them

MCP override

gate_pr_quality accepts optional inputs (includeVrt, includeFrt, includeA11y, includeHealth, threshold, a11yBudgets) that override the saved project policy for that invocation.

Without project gates and without explicit MCP includes, nothing is checked.

Global options (when ≥1 pillar gate)

  • Threshold modebalanced or strict (passed to blocker identification)
  • Coverage warning — optional PR-only warn when rolling health coverage is below your percent (does not block merge by itself)

On this page