Skip to main content

​
AI Features

This repo has AI capabilities at three levels: reader-facing assistants, contributor-facing agent tooling, and automated pipelines that keep content fresh without human intervention. For governance and registry details, see docs-guide/tooling/ai-tools.mdx.

​
AI Assistants for Readers

​
Mintlify AI Assistant

Built into docs.livepeer.org. Uses agentic RAG with tool-calling to answer questions from the published docs. No configuration required. Conversation analytics are available in the Mintlify dashboard and surface unanswered questions as content gap signals.

​
llms.txt

This repo governs llms.txt as a committed AI-first public root artifact. It is generated from the repo docs navigation by operations/scripts/generators/ai/llm/generate-llms-files.js. llms-full.txt is retired and not part of the active root contract.

​
MCP Server

Mintlify provides an auto-syncing MCP server that lets Claude, Cursor, and Windsurf query the published docs in real time:

​
Agent Adapters

AGENTS.md is the baseline instruction set. Every AI agent reads it first, then loads its native adapter for tool-specific rules.

​
Codex Branch Contract

AI agent implementation branches use codex/<issue-id>-<slug> naming. These branches are hook-enforced with:
  • Task contract file: .codex/task-contract.yaml
  • Pre-push validation: contract + scope + non-fast-forward block
  • PR body generation: node operations/scripts/dispatch/ai/codex/create-codex-pr.js --create
Full policy: docs-guide/policies/agent-governance-framework.mdx

​
AI Skills

28 skills provide structured workflows for both humans and agents. Invoke with /skill-name in Claude Code or follow the SKILL.md instructions directly.

​
Co-work and Process (9 skills)

​
Content Pipeline (4 skills)

​
Audit and Governance (8 skills)

​
Review and Specialised (7 skills)

​
Skill Chaining

Skills chain in a standard workflow: /thread (anchor) then /pm (plan) then /research (investigate) then /design (architect) then /build (execute) then /iterate (review).

​
Portable Templates

10 portable skill templates live in ai-tools/ai-skills/templates/. These can be synced to Codex or other environments:

​
AI-Powered Pipelines

​
Glossary Companion Generation

Extracts glossary data from SearchTable components in MDX pages and writes companion JSON files for AI and crawler discoverability.
  • Generator: operations/scripts/generators/content/reference/generate-glossary-companions.js
  • CI generate: .github/workflows/generate-ai-companions.yml (push to deploy branch)
  • CI check: .github/workflows/check-ai-companions.yml (PR gate)

​
Content Health Automation

Weekly scheduled workflow (content-health.yml) scans for stale pages, broken links, and content drift. Outputs reports to workspace/reports/.

​
Language Translation

Translation pipeline for multi-locale content. Frontmatter taxonomy validator at tools/lib/docs/frontmatter-taxonomy.js enforces valid locale values.

​
Contributing AI Tools

​
Write a new skill

  1. Copy a template from ai-tools/ai-skills/templates/
  2. Create ai-tools/ai-skills/your-skill/SKILL.md
  3. Follow the SKILL.md format: metadata block, when to use, steps, principles
  4. Register in ai-tools/registry/ai-tools-registry.json
  5. Run the validator: node operations/scripts/validators/governance/compliance/validate-ai-tools-registry.js --check

​
Add rules

Rules live in ai-tools/ai-rules/:
  • best-practices.md - general AI agent best practices
  • HUMAN-OVERRIDE-POLICY.md - when humans can override AI safety rules
  • ROLLBACK-GUIDE.md - how to roll back AI-generated changes
  • rules/ - granular rule files

​
Agent packs

Pre-packaged agent configurations in ai-tools/agent-packs/ for Claude, Codex, Cursor, Windsurf, and portable skills. Generated from templates and registry data.
Last modified on May 31, 2026