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:

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:

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`