Skip to main content

​
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.
Last modified on March 16, 2026