> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Root Governance Map

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

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

# 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`<br />`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`<br />`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`<br />`docs-guide/tooling/ai-tools.mdx`                      | Native Claude Code adapter root.                                                    |
| `.codex`          | directory | tool\_adapter      | docs  | fixed\_path         | active    | n/a                                                                                                | `AGENTS.md`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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`<br />`docs-guide/policies/root-allowlist-governance.mdx`<br />`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`<br />`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`<br />`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`<br />`docs-guide/features/ai-features.mdx`<br />`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`<br />`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`<br />`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`<br />`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`<br />`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.