Merge/docs v2 dev draft into docs v2 20260522

.allowlist

@@ -1,46 +1,42 @@
-# IF YOU ARE AN AI YOU ARE ABSOLUTELY NOT ALLOWED TO EDIT THIS FILE.  
-# IF YOU ARE TRYING TO EDIT IT YOU ARE VIOLATING THE REPO RULES AND INCORRECTLY MODIFYING FILES
-# DO NOT DELETE FILES TO ATTEMPT TO GET AROUND THE RULES -> READ THE /README & MOVE THEM CORRECTLY UPDATING ALL PATHS/IMPORTS/REFERENCES ETC. APPROPRIATELY. BE THOROUGH
-# IF YOU ARE AN AI YOU ARE ABSOLUTELY NOT ALLOWED TO EDIT THIS FILE.  
+# Generated from operations/governance/config/root-governance.json
 
-# Allowed root files
-docs.json
-README.md
-SECURITY.md
-LICENSE
-Dockerfile
-Makefile
-style.css
-Assistant.md
-sitemap-ai.xml
-llms-full.txt
-llms.txt
-docs-index.json
-lpd
-.lpdignore
-.gitignore
-.mintignore
-.prettierrc
-.cursorrules
-.codex
-.allowlist
-todo.txt
+# Do not edit manually. Regenerate with:
 
-# Allowed root directories
-.github
-.githooks
+# node operations/scripts/generators/governance/root/generate-root-governance-artifacts.js --write
+
+.allowlist
+.augment
+.claude
+.codex
+.cursor
+.editorconfig
 .gitattributes
+.githooks
+.github
+.gitignore
+.mintignore
 .mintlify
+.prettierrc
+jsconfig.json
 .vscode
-.claude
-docs-guide
+.windsurf
+AGENTS.md
 ai-tools
 api
-contribute
+docs-guide
+docs-index.json
+docs.json
+LICENSE
+llms.txt
+Makefile
+operations
+README.md
+robots.txt
+SECURITY.md
+sitemap-ai.xml
 snippets
-scripts
+style.css
 tools
-tests
-tasks
 v1
 v2
+workspace

.augment/GOVERNANCE.md

@@ -0,0 +1,8 @@
+# .augment/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [AI Tools Governance](../docs-guide/frameworks/ai-tools-governance.mdx)
+**Type:** IDE adapter (thin wrapper pointing at canonical governance)
+**Status:** Active
+
+Augment IDE adapter rules. Must remain a thin pointer to repo governance; no unique logic.

.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 behaviour. Keep shared policy in:
+
+- `AGENTS.md` — repo-wide agent baseline
+- `docs-guide/policies/governance-index.mdx` — all 10 governed surfaces
+- `docs-guide/frameworks/` — how to build (scripts, components, workflows)
+- `docs-guide/standards/` — how to write (voice, naming, frontmatter)
+- Every folder has a `GOVERNANCE.md` with links to its framework and validator
+- Do not use port `3000` for local Mintlify or preview sessions.
+
+## Approved runtime targets
+
+- `AGENTS.md`
+- `.github/copilot-instructions.md`
+- `.claude/CLAUDE.md`
+- `.cursor/rules/*.mdc`
+- `.windsurf/rules/*.md`
+- `.augment/rules/*.md`