Skip to main content

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.

​
Canonical Repo Folder Structure

Source of truth for locked decisions on repo root folder layout and per-folder structure. This framework is LOCKED. No structural changes to root-level folders without a policy update.
Other active plans that own or affect specific folders. Coordinate with these before making structural changes.
PlanFolder(s) owned
SCRIPT-GOVERNANCEoperations/scripts/
AI-TOOLS-GOVERNANCEai-tools/
COMPONENT-GOVERNANCEsnippets/components/
CONTENT-WRITINGv2/ page content
DOCUMENTATIONdocs-guide/
SNIPPETSsnippets/ template structure
TOOLINGtools/ CLI and dev tooling
OSS-OWNERLESS-REPO-GOVERNANCEOwnerless folder governance

​
Target Root Structure

/
  .claude/                  AI adapter: Claude
  .codex/                   AI adapter: Codex
  .cursor/                  AI adapter: Cursor
  .windsurf/                AI adapter: Windsurf
  .augment/                 AI adapter: Augment
  .github/                  CI/CD workflows
  .githooks/                Local git hooks
  .vscode/                  Editor settings
  .mintlify/                Mintlify platform config

  ai-tools/                 AI rules, skills, agent packs
  api/                      OpenAPI specs only
  docs-guide/               Contributor and authoring guide
  operations/               Scripts and tests
  snippets/                 Shared MDX components, assets, data
  tools/                    Dev tooling (CLI, lib, vscode, config)
  v1/                       v1 content pages (frozen)
  v2/                       v2 content pages
  workspace/                Planning workspace

  docs.json                 Mintlify nav config
  style.css                 Mintlify global styles
  AGENTS.md                 Agent baseline
  README.md                 Repo readme

​
Key Subfolder Structures

​
docs-guide/

docs-guide/
  catalog/                  Auto-generated catalogues only; never edit manually
  contributing/             Contributor guides and onboarding
  decisions/                Unified decision registry index
  features/                 Feature and system overviews
  frameworks/               Decision models and taxonomies
  policies/                 Enforceable governance rules
  repo-ops/                 Config files, enforcement maps
  standards/                Authoring, voice, naming, frontmatter standards
  tooling/                  Tool references and AI tooling guides
  canonical/                Platform constraints (Mintlify)

​
v2/

v2/
  about/
  community/
  developers/
  gateways/
  home/
  internal/                 Internal-only pages
  lpt/
  orchestrators/
  resources/
  solutions/
  templates/                Shared MDX templates
Per-section _workspace/ approved subdirs: notes/, plans/, research/, reviews/, drafts/, handoff/, archive/, deprecated/, context-data/, staging/.

​
snippets/

snippets/
  assets/                   Images, SVGs, brand assets, OG images
  components/               JSX component library
  composables/              Layer 3 MDX content architecture
  data/                     Structured JSON/JS data
  templates/                Page templates
  guide.mdx                 Canonical snippets manual

​
operations/

operations/
  scripts/                  Operational script library (~120 scripts)
    audits/
    generators/
    validators/
    remediators/
    dispatch/
    automations/
    config/                 Shared configuration and utility libraries
  tests/                    Test suites
  governance/               Governance config and enforcement

​
Pending Decisions

ItemDecision needed
v2/templates/Stay or move to snippets/templates/?
snippets/composables/Integrate into pages or archive?
docs-guide/frameworks/ vs policies/Keep as separate sections (current)
Pre-commit gate for loose v2/ section-root filesBuild now or defer?
Last modified on April 8, 2026