Quality Gates Map

Layered quality gate map aligned to first-principles ownership and runtime budgets.

Canonical Policy

Primary policy source:

• docs-guide/policies/infrastructure-principles.mdx

This page is the operational map. Rule ownership and budgets are canonical in the policy file above.

Gate Layers

1) Pre-commit (Local, Fast, Offline)

Entry:

• .githooks/pre-commit

Responsibilities:

• staged structure and style invariants
• staged unit/static checks (tests/run-all.js --staged --skip-browser)
• staged generated-artifact sync checks
• runtime budget enforcement (<= 60s default)
• staged selection should respect governed non-publishable V2 lanes once they are encoded in .mintignore and shared file-selection helpers

Out of scope:

• browser sweeps
• WCAG crawl/audit flows
• full/broad link sweeps
• codex issue-readiness governance

2) Pre-push (codex/* Governance)

Entry:

• .githooks/pre-push

Responsibilities:

• codex task-contract validation
• codex issue-readiness validation
• lock overlap validation
• stash-policy enforcement
• non-fast-forward push blocking by default

3) PR Changed-File CI (Blocking)

Entries:

• .github/workflows/test-suite.yml
• tests/run-pr-checks.js

Responsibilities:

• blocking changed-file checks for style/MDX/spelling/quality/links/imports
• docs navigation and script-doc checks
• codex contract + PR-body + issue-state checks

4) Full/Broad CI Sweeps (Blocking or Advisory by Workflow)

Primary entries:

• .github/workflows/test-v2-pages.yml
• .github/workflows/openapi-reference-validation.yml
• .github/workflows/v2-external-link-audit.yml
• .github/workflows/broken-links.yml

Responsibilities:

• browser/render integrity across route sets
• OpenAPI reference integrity
• broad link health and scheduled external checks

Blocking Defaults

• P0/P1 checks are blocking where they are owned.
• P2 checks may be blocking or advisory based on rollout state.
• P3 checks are advisory unless explicitly graduated.

Source Files

• .githooks/pre-commit
• .githooks/pre-push
• tests/run-all.js
• tests/run-pr-checks.js
• .github/workflows/test-suite.yml
• .github/workflows/test-v2-pages.yml
• .github/workflows/openapi-reference-validation.yml
• docs-guide/policies/infrastructure-principles.mdx
• docs-guide/policies/v2-folder-governance.mdx

V2 Lane Contract

Mint, tests, and audits should treat _workspace/, x-deprecated/, and v2/x-archived/ as non-publishable lanes unless a tool is explicitly operating in maintainer inventory mode. Transitional legacy buckets such as _contextData, _plans-and-research, x-resources, and section-level review.md remain inventoried until move waves normalize them into the canonical lanes.