> ## Documentation Index
> Fetch the complete documentation index at: https://na-36-changelog-go-livepeer-2026-05-18.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf setup

Configure Windsurf's Cascade AI assistant with the approved repo governance layout for Livepeer Docs.

## Canonical Repo Governance

* Repo-wide baseline: `AGENTS.md`
* Native Windsurf adapter: `.windsurf/rules/*.md`
* Canonical governance docs:
  * `docs-guide/policies/agent-governance-framework.mdx`
  * `docs-guide/policies/root-allowlist-governance.mdx`

Use Windsurf rule files for Windsurf-specific adapter guidance only. Shared repo policy should stay in `AGENTS.md`.

## Prerequisites

* Windsurf editor installed
* Access to your documentation repository

## Workspace Rules

Create the Windsurf rules directory in your documentation repository root:

```bash icon="terminal" theme={null}
mkdir -p .windsurf/rules
```

Then add one or more Markdown rule files under `.windsurf/rules/`.

## Rule Content Guidelines

* Read `AGENTS.md` first for repo-wide rules.
* Keep `.windsurf/rules/*.md` focused on Windsurf-specific adapter behavior.
* Link back to the canonical governance docs instead of duplicating the full repo contract.
* Use additional rule files only when a separate Windsurf-specific concern needs its own scope.

## Minimal Starter

Create a rule file such as `.windsurf/rules/repo-governance.md` with a minimal adapter:

```markdown theme={null}
Read `AGENTS.md` first for repo-wide rules.

Use this file only for Windsurf-specific adapter guidance.

Canonical governance:
- `docs-guide/policies/agent-governance-framework.mdx`
- `docs-guide/policies/root-allowlist-governance.mdx`
```