Root Governance Map

Generated live inventory and taxonomy map for the governed repo root.

Generation Script: This file is generated from script(s): operations/scripts/generators/governance/root/generate-root-governance-artifacts.js.
Purpose: Keep the live root inventory and placement matrix aligned with the canonical root-governance manifest.
Run when: Root-governance manifest, docs, validator, or root inventory expectations change.
Important: Do not manually edit this file; run node operations/scripts/generators/governance/root/generate-root-governance-artifacts.js --write.

Root Governance Map

This page is generated from operations/governance/config/root-governance.json and is the live reference for what may exist at repo root.

Governed Root Inventory

Active governed root entries: 35.

Path	Type	Class	Owner	Root basis	Lifecycle	Generator	Doc refs	Notes
.allowlist	file	platform_contract	docs	repo_entrypoint	active	node operations/scripts/generators/governance/root/generate-root-governance-artifacts.js --write	docs-guide/policies/root-allowlist-governance.mdx docs-guide/repo-ops/config/root-governance-map.mdx	Generated projection consumed by the root-structure pre-commit gate.
.augment	directory	tool_adapter	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx docs-guide/tooling/ai-tools.mdx	Native Augment adapter root.
.claude	directory	tool_adapter	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx docs-guide/tooling/ai-tools.mdx	Native Claude Code adapter root.
.codex	directory	tool_adapter	docs	fixed_path	active	n/a	AGENTS.md docs-guide/policies/agent-governance-framework.mdx	Codex task-contract and local lock root.
.cursor	directory	tool_adapter	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx docs-guide/tooling/ai-tools.mdx	Native Cursor adapter root.
.editorconfig	file	docs_runtime	docs	fixed_path	active	n/a	README.md	Standard repo editor config lives at root for tool discovery.
.gitattributes	file	docs_runtime	docs	fixed_path	active	n/a	README.md	Git attributes are fixed-path root config.
.githooks	directory	docs_runtime	docs	repo_entrypoint	active	n/a	README.md docs-guide/policies/root-allowlist-governance.mdx	Repo hook root remains rooted because the hook installer and git config expect it.
.github	directory	platform_contract	docs	fixed_path	active	n/a	README.md docs-guide/policies/agent-governance-framework.mdx	GitHub workflows, issue templates, and Copilot adapter require the fixed root path.
.gitignore	file	docs_runtime	docs	fixed_path	active	n/a	README.md docs-guide/policies/root-allowlist-governance.mdx	Root ignore policy governs local-only outputs.
.mintignore	file	platform_contract	docs	fixed_path	active	n/a	README.md docs-guide/repo-ops/config/repo-config-map.mdx	Mintlify build exclusion file is root-discovered.
.mintlify	directory	platform_contract	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx docs-guide/tooling/ai-tools.mdx	Mintlify runtime directory remains rooted for the assistant contract.
.prettierrc	file	docs_runtime	docs	fixed_path	active	n/a	README.md	Formatter config is fixed-path root config.
.vscode	directory	docs_runtime	docs	tool_discovery	active	n/a	README.md	Editor workspace settings remain in the conventional root directory.
.windsurf	directory	tool_adapter	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx docs-guide/tooling/ai-tools.mdx	Native Windsurf adapter root.
AGENTS.md	file	platform_contract	docs	fixed_path	active	n/a	docs-guide/policies/agent-governance-framework.mdx README.md	Canonical repo-wide agent baseline.
LICENSE	file	platform_contract	docs	fixed_path	active	n/a	README.md	Repository license stays at root.
Makefile	file	docs_runtime	docs	repo_entrypoint	active	n/a	README.md	Convenience entrypoint retained at root.
README.md	file	repo_entrypoint	docs	repo_entrypoint	active	n/a	docs-guide/repo-ops/config/root-governance-map.mdx	Repo entrypoint for humans and agents.
SECURITY.md	file	platform_contract	docs	fixed_path	active	n/a	README.md	Security disclosure file remains rooted.
ai-tools	directory	subsystem_root	docs	approved_subsystem	active	n/a	docs-guide/tooling/ai-tools.mdx docs-guide/policies/root-allowlist-governance.mdx README.md	Approved root AI-first subsystem. Governance must preserve it at root in this pass.
api	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md	API spec root.
docs-guide	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md	Canonical internal docs tree.
docs-index.json	file	public_artifact	docs	public_url	active	node operations/scripts/generators/content/catalogs/generate-docs-index.js --write	README.md docs-guide/repo-ops/config/root-governance-map.mdx	Ratified AI-first public root artifact.
docs.json	file	platform_contract	docs	fixed_path	active	n/a	README.md docs-guide/repo-ops/config/repo-config-map.mdx	Mintlify routing and navigation source of truth.
llms.txt	file	public_artifact	docs	public_url	active	node operations/scripts/generators/ai/llm/generate-llms-files.js --write	README.md docs-guide/features/ai-features.mdx docs-guide/repo-ops/config/root-governance-map.mdx	Ratified AI-first public root artifact. llms-full.txt is retired.
operations	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md	Governed scripts, validators, and tests root.
robots.txt	file	platform_contract	docs	public_url	active	n/a	README.md	Public crawler contract stays at root.
sitemap-ai.xml	file	public_artifact	docs	public_url	active	node operations/scripts/generators/content/seo/generate-ai-sitemap.js --write	README.md docs-guide/repo-ops/config/root-governance-map.mdx	Ratified AI-first public root artifact.
snippets	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md snippets/snippets-registry.mdx	Component, snippet, and snippet governance root.
style.css	file	platform_contract	docs	fixed_path	active	n/a	README.md	Mintlify style entrypoint remains rooted.
tools	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md docs-guide/tooling/lpd-cli.mdx	CLI, config, and shared library root.
v1	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md	Frozen legacy docs tree.
v2	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md	Active published docs tree.
workspace	directory	subsystem_root	docs	repo_entrypoint	active	n/a	README.md docs-guide/policies/root-allowlist-governance.mdx	Governed AI working directory for plans and reports.

Placement Matrix

Surface	Allowed paths	Notes
scripts	operations/scripts/**, operations/tests/**, tools/**, .githooks/**	Executable repo automation belongs in governed script roots, not at repo root.
tooling_docs	docs-guide/tooling/**, docs-guide/repo-ops/**, docs-guide/policies/**	Human-facing governance and operational docs stay under docs-guide.
public_root_artifacts	docs-index.json, llms.txt, sitemap-ai.xml, robots.txt	Only explicit public/runtime contracts may remain rooted.
workspace_reports	workspace/reports/**	Audits, trackers, and generated governance reports belong under workspace/reports.
local_browser_outputs	workspace/reports/_local/playwright/**	Local-only browser captures must never write to repo root.

AI-First Public Root Artifacts

Artifact	Public URL	Purpose	Generator
docs-index.json	/docs-index.json	Machine-readable docs inventory for AI and tooling consumers.	node operations/scripts/generators/content/catalogs/generate-docs-index.js --write
llms.txt	/llms.txt	AI-first text index for LLM consumers.	node operations/scripts/generators/ai/llm/generate-llms-files.js --write
sitemap-ai.xml	/sitemap-ai.xml	AI-focused sitemap for discoverability.	node operations/scripts/generators/content/seo/generate-ai-sitemap.js --write

Forbidden Root Artifacts

Path	Reason
.DS_Store	OS noise must be cleaned or ignored, never governed.
.cache	Local caches belong in ignored scratch space, not repo root.
.cursorrules	Retired legacy Cursor surface replaced by .cursor/rules/*.mdc.
.playwright-cli	Browser automation output must live under workspace/reports/_local/playwright/.
repo-catalog.mdx	Root placeholder docs are forbidden; governed references belong under docs-guide.
ASSISTANT.md	Legacy assistant root files are retired from the governed root model.
Assistant.md	Legacy assistant root files are retired from the governed root model.

Local Compatibility Entries

Path	Tracking policy	Notes
.env	untracked_only	Local compatibility env file is tolerated untracked but is never a governed root entry.

Temporary Exceptions

No temporary root exceptions are active.