Generation Script: This file is generated from script(s): operations/scripts/generators/governance/reports/generate-repo-governance-status.js.
Purpose: Keep the top-level governance map aligned with the canonical registry and ownerless steady-state architecture.
Run when: Repo-governance registry, validator, helper, operational config taxonomy, or governance paths change.
Important: Do not manually edit this file; run node operations/scripts/generators/governance/reports/generate-repo-governance-status.js --write.

Repo Governance Map

This page is generated from operations/governance/config/repo-governance-surfaces.json and is the live top-level reference for the repo governance control plane. Cutover status: retired. Canonical governance home: operations/governance.

Governed Governance Surfaces

Registered surfaces: 5. Ownerless-ready now: 4.

Surface	Name	Type	Gate	Rollout	Ready	Canonical sources	Derived outputs	Escalation	Notes
`repo-governance-registry`	Repo Governance Registry	`governance-registry`	`pr-changed`	`autofix`	yes	`operations/governance/config/repo-governance-surfaces.json` `operations/governance/config/root-governance.json` `operations/governance/config/generated-artifacts.json` `operations/governance/config/agent-write-governance.json` `operations/governance/config/ownerless-governance-surfaces.json` `operations/governance/config/governance-approval-policy.json` `.github/pull_request_template.md` `operations/scripts/validators/governance/pr/check-governance-approvals.js` `docs-guide/repo-ops/config/repo-config-map.mdx`	`docs-guide/repo-ops/config/repo-governance-map.mdx` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.json` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.md` `workspace/reports/repo-ops/OWNERLESS_REPO_HANDOVER_LATEST.md`	`auto-fix-pr`	Top-level governance index for the ownerless steady-state control plane.
`root-governance`	Root Governance	`root-governance`	`pre-commit`	`autofix`	yes	`operations/governance/config/root-governance.json` `docs-guide/policies/root-allowlist-governance.mdx`	`.allowlist` `docs-guide/repo-ops/config/root-governance-map.mdx` `workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.json` `workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.md`	`auto-fix-pr`	Canonical root-governance manifest under the ownerless steady-state architecture.
`generated-artifact-governance`	Generated Artifact Governance	`generated-artifact-governance`	`pr-changed`	`autofix`	yes	`operations/governance/config/generated-artifacts.json` `docs-guide/policies/generated-artifact-and-hook-governance.mdx`	`docs-index.json` `llms.txt` `sitemap-ai.xml` `docs-guide/repo-ops/config/root-governance-map.mdx` `workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.json` `workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.md` `docs-guide/repo-ops/config/repo-governance-map.mdx` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.json` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.md`	`auto-fix-pr`	Canonical generated-artifact governance manifest under the ownerless steady-state architecture.
`ownerless-governance`	Ownerless Governance	`ownerless-governance`	`pr-changed`	`autofix`	yes	`operations/governance/config/ownerless-governance-surfaces.json` `docs-guide/policies/ownerless-governance.mdx` `operations/governance/config/governance-approval-policy.json`		`auto-fix-pr`	Canonical ownerless-governance manifest under the ownerless steady-state architecture.
`github-workspace-governance`	GitHub Workspace Governance	`github-workspace-governance`	`pr-changed`	`migrating`	no	`operations/governance/config/repo-governance-surfaces.json` `.github/workspace/framework-canonical.md` `.github/workspace/decisions-log.mdx`	`docs-guide/repo-ops/config/repo-governance-map.mdx` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.json` `workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.md`	`human-review-required`	.github/workspace contains classified transitional support, generated reference material, and archived design history; this prevents the whole tree from being treated as canonical runtime governance.

Path Classes

Class	Allowed paths	Notes
`governance-config`	`operations/governance/config/**`	Canonical governance manifests live under operations/governance/config in the target model.
`governance-docs`	`docs-guide/policies/` `docs-guide/repo-ops/`	Policy prose and generated governance reference pages live under docs-guide.
`governance-runtime`	`operations/config/` `tools/lib/governance/` `operations/scripts/` `operations/tests/` `.githooks/` `.github/`	Ownerless runtime and enforcement paths remain active under operations/config, operations/governance, operations/scripts, and operations/tests.
`workspace-report`	`workspace/reports/**`	Tracked governance reports and generated status outputs belong under workspace/reports.
`workspace-local`	`workspace/reports/_local/` `workspace/tmp/`	Local-only diagnostics, captures, and scratch outputs must stay out of repo root and canonical docs paths.

Agent Output Classes

Class	Default destination	Commit policy	Notes
`canonical`	`declared governed surface paths only`	`tracked`	Canonical repo changes must target an admitted governed surface.
`generated`	`manifest-declared generated outputs only`	`tracked`	Generated tracked outputs must be declared by a governance or artifact manifest.
`report`	`workspace/reports/**`	`task_dependent`	Tracked reports are allowed only when the task explicitly calls for a committed report.
`scratch`	`workspace/reports/_local/**`	`untracked`	Default destination for temporary diagnostics and ad hoc working outputs.
`capture`	`workspace/reports/_local/**`	`untracked`	Screenshots, browser captures, and similar agent artifacts must remain local-only by default.
`task-state`	`workspace/thread-outputs/**`	`tracked`	Session and thread state belongs in the governed workspace thread-output tree.
`forbidden`	`repo root or ad hoc top-level paths`	`forbidden`	Agents must not create undeclared top-level files or folders outside admitted governance and workspace paths.

Historical Approval Checkpoints

Checkpoint	Label	Phase	Human approval	Trigger	Required evidence
`design-lock`	Design Lock	`design`	yes	Before registry schema, path classes, and agent-write classes are treated as locked.	`approved operations/governance taxonomy` `approved registry schema` `approved steady-state governance model`
`first-instance-review`	First-Instance Review	`implement`	yes	After the first thin-slice implementation and before repeating the migration pattern across additional surfaces.	`first-slice generator output` `first-slice validator output` `targeted tests passing`
`gate-escalation`	Gate Escalation	`iterate`	yes	Before any governance rule is promoted from advisory or autofix to blocking.	`baseline noise review` `false-positive review` `contributor impact review`
`legacy-retirement`	Legacy Retirement	`cleanup`	yes	Before retiring live bridge-mode governance sources under tools/config/runtime or deleting bridge logic.	`consumer cutover proof` `bridge sync validator pass` `retirement inventory`

Production Approval Policy

Policy element	Value	Notes
`manifest`	`operations/governance/config/governance-approval-policy.json`	Production governance-sensitive PRs require GitHub labels plus PR-body evidence under the Governance Approval section.
`pr_template`	`.github/pull_request_template.md`	Required PR body section and evidence fields for governance-sensitive changes.
`validator`	`operations/scripts/validators/governance/pr/check-governance-approvals.js`	Changed-file PR validator enforcing labels plus PR-body evidence.
`required_labels`	`approval:governance-schema` `approval:governance-gate` `approval:workflow-governance` `approval:governance-retirement`	GitHub labels that act as the authoritative approval signal in CI.

GitHub Workspace Classification

Only explicitly classified .github/workspace items should be treated as live support material. Design and audit trees are reference-only unless later promoted.

Entry	Path	Classification	Runtime role	Future state	Notes
`workspace-framework`	`.github/workspace/framework-canonical.md`	`transitional-runtime`	`workflow-taxonomy-framework`	`promote-or-replace`	Still referenced for workflow taxonomy and naming rules, but not treated as the long-term canonical governance home.
`workspace-decisions-log`	`.github/workspace/decisions-log.mdx`	`transitional-runtime`	`locked-workflow-decisions`	`promote-or-replace`	Operational decisions remain live transitional support until they are promoted into canonical docs or archived.
`workspace-actions-library`	`.github/workspace/actions-library`	`generated-support`	`workflow-reference-library`	`retain-generated-support`	Generated/reference workflow documentation and supporting assets used for workflow governance visibility.
`workspace-outcomes`	`.github/workspace/outcomes.md`	`design-only`	`visual-design-context`	`archive-reference`	Useful design context and maps, but not an active runtime governance source.
`workspace-phase2`	`.github/workspace/phase2`	`design-only`	`pipeline-design-history`	`archive-reference`	Pipeline design and review planning material retained for context, not as canonical runtime governance.
`workspace-design`	`.github/workspace/design`	`design-only`	`concern-design-research`	`archive-reference`	Concern-level design work and research should inform future promotion decisions but does not directly govern runtime behavior.
`workspace-reports-audits`	`.github/workspace/reports-audits`	`historical-audit`	`audit-history`	`archive-reference`	Historical audit packets and dependency analysis remain reference material only.

Canonical Manifests

operations/governance/config/root-governance.json
operations/governance/config/generated-artifacts.json
operations/governance/config/agent-write-governance.json
operations/governance/config/ownerless-governance-surfaces.json
operations/governance/config/governance-approval-policy.json

Canonical Runtime Config

operations/config/content/blueprints/blueprint-mapping.json
operations/config/content/blueprints/blueprint-pages.json
operations/config/content/navigation/navigation-exclusions.json
operations/config/content/reports/v2-internal-report-pages.js
operations/config/README.md
operations/config/workspace/retention/report-retention-policy.json
operations/config/workspace/schemas/cleanup-manifest.schema.json

Active Governance Reports

workspace/reports/repo-ops/OWNERLESS_REPO_HANDOVER_LATEST.md
workspace/reports/repo-ops/REPAIR_REPORT_LATEST.json
workspace/reports/repo-ops/REPAIR_REPORT_LATEST.md
workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.json
workspace/reports/repo-ops/REPO_GOVERNANCE_STATUS_LATEST.md
workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.json
workspace/reports/repo-ops/ROOT_GOVERNANCE_SYNC_LATEST.md
workspace/reports/repo-ops/SCRIPT_INVENTORY_FULL.json
workspace/reports/repo-ops/SCRIPT_INVENTORY_FULL.md

Rollout State Summary

State	Surface count
`autofix`	4
`migrating`	1

Technical References

Compendium

Knowledge Hub

Changelogs

Documentation Guide

Governance Map

Repo Governance Map

Governed Governance Surfaces

Path Classes

Agent Output Classes

Historical Approval Checkpoints

Production Approval Policy

GitHub Workspace Classification

Canonical Manifests

Canonical Runtime Config

Active Governance Reports

Rollout State Summary

​Repo Governance Map

​Governed Governance Surfaces

​Path Classes

​Agent Output Classes

​Historical Approval Checkpoints

​Production Approval Policy

​GitHub Workspace Classification

​Canonical Manifests

​Canonical Runtime Config

​Active Governance Reports

​Rollout State Summary

Repo Governance Map

Governed Governance Surfaces

Path Classes

Agent Output Classes

Historical Approval Checkpoints

Production Approval Policy

GitHub Workspace Classification

Canonical Manifests

Canonical Runtime Config

Active Governance Reports

Rollout State Summary