merge: sync docs-v2-dev into docs-v2

.allowlist

@@ -1,51 +1,39 @@
-# Machine-readable repo-root allowlist.
-# Root entries only. Comments must use #. No nested paths.
+# Generated from operations/governance/config/root-governance.json
+# Do not edit manually. Regenerate with:
+# node operations/scripts/generators/governance/root/generate-root-governance-artifacts.js --write
 
-# Core repo files
-.gitignore
 .allowlist
-README.md
-LICENSE
-
-# Platform and governance roots
-.github
-.githooks
-.gitattributes
+.augment
+.claude
 .codex
-AGENTS.md
-
-# Mintlify runtime roots
-docs.json
-style.css
-.mintignore
-snippets
-v1
-v2
-
-# Tooling and workspace roots
-.vscode
+.cursor
 .editorconfig
+.gitattributes
+.githooks
+.github
+.gitignore
+.mintignore
+.mintlify
 .prettierrc
-lpd
-.lpdignore
-tools
-docs-guide
-operations
-tasks
-tests
+.vscode
+.windsurf
+AGENTS.md
 ai-tools
 api
-
-# Native agent adapters
-.claude
-.cursor
-.windsurf
-
-# Other governed root entries
-Dockerfile
-Makefile
-sitemap-ai.xml
-llms.txt
+docs-guide
 docs-index.json
-contribute
+docs.json
+LICENSE
+llms.txt
+Makefile
+operations
+README.md
+robots.txt
 SECURITY.md
+sitemap-ai.xml
+snippets
+style.css
+tools
+v1
+v2
+workspace

.augment/rules/git-safety.md

@@ -0,0 +1,35 @@
+---
+type: always_apply
+---
+
+# Git Safety Rules
+
+## Critical git boundaries
+
+- **NEVER** run `git commit` without explicit user permission
+- **NEVER** run `git push` without explicit user permission
+- **NEVER** run `git reset` (soft/hard/mixed) without explicit user permission
+- **DEFAULT:** do not use `--no-verify` to bypass hooks
+- **EXCEPTION:** only when explicitly instructed by a human in-thread, `git commit --no-verify` is allowed with audit metadata per `ai-tools/ai-rules/HUMAN-OVERRIDE-POLICY.md`
+- **NEVER** use port `3000` for local Mintlify, preview, or browser-validation sessions; choose a non-3000 port explicitly
+- **NEVER** modify git history or remote state
+- **ALWAYS** ask before ANY git operation that could lose work
+
+## Incident log — learn from these failures
+
+**2026-01-06 00:52 UTC**: AI assistant performed unauthorized `git reset --hard HEAD~1`
+- Destroyed hours of user work across 11 files
+- Violated explicit "NEVER commit/push without permission" rule
+- Required emergency recovery from VSCode Augment checkpoints
+- **THIS MUST NEVER HAPPEN AGAIN**
+
+## User rules (follow always)
+
+1. Never make code edits without permission that cannot be reverted
+2. Don't ask for read/grep/view command permissions — just do it
+3. Before implementing fixes — explain the issue and proposed solution first
+4. Don't repeat past errors — if something failed, try a different approach
+5. Keep context minimal — only load files needed for the task
+6. Always have a backup before risky changes
+7. Easily reversible code changes — OK to make without asking
+8. Never make irreversible changes — always ensure changes can be undone

.augment/rules/no-deletions.md

@@ -0,0 +1,30 @@
+---
+type: always_apply
+---
+
+# No Deletions Rule
+
+## AIs must never delete files
+
+- **NEVER** delete files — always move files to correct locations instead
+- **NEVER** use `git rm` — use `git mv` to move files
+- **NEVER** use `rm -rf` on tracked files — move files instead
+- **ALWAYS** move files to correct locations per the migration plan
+- **ALWAYS** preserve content — no content should be lost
+
+## Why this rule exists
+
+File deletions cause data loss. The repository has lost 223+ files due to deletions instead of moves. Deletions are irreversible.
+
+## What to do instead
+
+- **Moving files:** `git mv old/path new/path`
+- **If a file shouldn't exist:** document why, then the human can decide
+
+## Human override
+
+Humans can use `git commit -m "..." --trailer "allow-deletions=true"` if deletion is truly necessary. AIs must never use this override.
+
+## Enforcement
+
+A pre-commit hook blocks all deletions unless the human override trailer is present. AIs must never set this flag.

.augment/rules/repo-governance.md

@@ -0,0 +1,25 @@
+---
+type: always_apply
+---
+
+# Livepeer Docs — Augment Adapter
+
+Read `AGENTS.md` first for repo-wide rules.
+
+Use this file only for Augment-specific adapter behavior. Keep shared policy in:
+
+- `AGENTS.md`
+- `docs-guide/policies/agent-governance-framework.mdx`
+- `docs-guide/policies/root-allowlist-governance.mdx`
+- `docs-guide/canonical/collation-data/Mintlify/mintlify-repo-best-practices.md`
+- Treat the Mintlify canonical reference above as the source of truth for preview behavior, MDX constraints, and repo authoring rules.
+- Do not use port `3000` for local Mintlify or preview sessions; choose a non-3000 port explicitly.
+
+## Approved runtime targets
+
+- `AGENTS.md`
+- `.github/copilot-instructions.md`
+- `.claude/CLAUDE.md`
+- `.cursor/rules/*.mdc`
+- `.windsurf/rules/*.md`
+- `.augment/rules/*.md`