> ## Documentation Index > Fetch the complete documentation index at: https://na-36-handover-docs-v2-into-docs-v2-dev-20260518.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Contributor Tools > Contributor-facing tools for setup, local preview, validation, hooks, editor support, scoped docs profiles, and governed page movement. # Contributor Tools Contributor tools should make the correct workflow the easiest workflow: setup, preview, validate, repair, and move pages through repo-backed commands rather than private maintainer knowledge. ## Primary Tools | Tool | Path | Purpose | | ------------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `lpd` CLI | `tools/lpd` | Unified command surface for setup, doctor, dev server, tests, hooks, scripts, repair, AI sitemap, and governed page moves. | | Git hooks | `.githooks/` | Local staged checks, no-deletion checks, pre-push task contracts, browser verification helpers. | | Scoped preview tooling | `tools/dev/preview/` | Mintlify launchers, scoped docs config generation, watcher patches, custom loader. | | Authoring helpers | `tools/dev/authoring/` | Local MDX formatting and callout helpers. | | Editor extensions | `tools/editor-extensions/` | VS Code extensions for authoring tools, component picker, MDX preview, markdown list helpers. | | VS Code workspace config | `.vscode/` | Recommended extensions, settings, tasks, snippets, MCP config. | | Repo libraries | `tools/lib/` | Shared JS modules used by validators, generators, hooks, and governance scripts. | ## `lpd` Workflows | Workflow | Command | | ------------------------- | ------------------------------------------------------------------------------------------------------- | | First-time setup | `bash tools/lpd setup --yes` | | Environment check | `PATH="/opt/homebrew/bin:$PATH" bash tools/lpd doctor --strict` when Homebrew Node is not on shell PATH | | Start docs locally | `lpd dev -- --port ` | | Scoped docs preview | `lpd dev --scoped --scope-version v2 --scope-language en --scope-prefix v2/orchestrators` | | Staged validation | `lpd test --staged` | | CI-like local validation | `lpd ci --skip-browser` | | Generate AI sitemap | `lpd ai-sitemap --write` | | Move a page | `lpd move-page --check` then rerun without `--check` after review | | Repair a governed surface | `lpd repair --surface --staged --write` | ## Environment Notes The non-interactive Codex shell used for this audit did not include `/opt/homebrew/bin` on `PATH`, so `node`, `npm`, and `mintlify` were initially hidden. Discovery found: * Homebrew Node: `/opt/homebrew/bin/node`, version `v22.22.2` * NVM Node: `~/.nvm/versions/node/v22.22.1/bin/node` * Mintlify: `/opt/homebrew/bin/mintlify`, version `4.2.446` * `lpd doctor` passes when `/opt/homebrew/bin` is added to `PATH` Do not report required tools as unavailable until checking version managers, repo wrappers, setup docs, and common install paths. ## Editor Tooling | Surface | Use | | ------------------------------------ | ------------------------------------------------------------------------- | | `.vscode/extensions.json` | Recommended local extensions. | | `.vscode/settings.json` | Workspace settings. | | `.vscode/tasks.json` | Repeatable editor tasks. | | `.vscode/components.code-snippets` | Component snippets. | | `.vscode/templates.code-snippets` | Template snippets. | | `.vscode/mdx.code-snippets` | MDX authoring helpers. | | `tools/editor-extensions/install.sh` | Installs local VS Code extensions and verifies packaged extension parity. | ## Contributor Safety Rules * Install hooks before substantial work: `bash .githooks/install.sh`. * Do not use `--no-verify` unless explicitly authorized by a human override policy. * Do not edit `.allowlist` casually; human commits require the `allowlist-edit=true` trailer. * Do not delete tracked files without the governed deletion approval path. * Do not use port `3000` for direct Mintlify preview or port `3333` via `lpd dev` in agent sessions. * Do not switch branches in the existing worktree. ## Tooling Gaps | Gap | Evidence | Required action | | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | PATH assumptions still leak into commands | `lpd doctor` warned until `/opt/homebrew/bin` was loaded. | Update tooling docs to show PATH discovery/remediation for non-interactive shells. | | Backup artifacts are tracked | `.vscode/livepeer-legacy.code-snippets.bak` and workspace `.bak` files are present. | Classify as compatibility aliases or remove through governed deletion. | | Tool catalogs can drift | `tools/script-index.md` contains legacy-looking script paths. | Regenerate script indexes and verify generated catalogs. | | Node module directories exist under governed roots | `tools/node_modules/` and `operations/tests/node_modules/` are installed dependencies and intentionally ignored by most audits. | Keep selection helpers excluding `node_modules`; do not include them in reports or docs counts. | ## Related * `docs-guide/tooling/lpd-cli.mdx` * `docs-guide/tooling/dev-tools.mdx` * `docs-guide/contributing/contributing.mdx` * `docs-guide/contributing/local-preview.mdx` * `.githooks/README.md`