# Windsurf Mastery

> Windsurf (Codeium) complete guide -- Cascade agentic system, Flows, Memories, Supercomplete, .windsurfrules, context engine, and browser preview.

- Skill: `leolin990405/windsurf-mastery` (Agent Skill)
- Install (CLI): `npx get-skill add leolin990405/windsurf-mastery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/leolin990405/windsurf-mastery/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: LeoLin990405 (https://skillmd.com/u/leolin990405)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/leolin990405/windsurf-mastery

---


# Windsurf (Codeium) Mastery

## Architecture

AI-native IDE distinguished by **Cascade** agentic system and **Flow** context engine.

## Core Components

| Component | Purpose |
|-----------|---------|
| **Cascade** | Agentic AI: plans, executes, iterates on multi-step tasks |
| **Flows** | Iterative AI workflows with approval checkpoints |
| **Supercomplete** | Intent-predicting autocomplete (not just next token) |
| **M-Query** | Proprietary retrieval outperforming cosine similarity RAG |

## Context Assembly Pipeline

Every interaction:
1. Load Rules — global `.windsurfrules` → project-level rules
2. Load Memories — persistent facts from previous sessions
3. Read open files — active file highest weight
4. Codebase retrieval — M-Query pulls relevant snippets
5. Recent actions — file edits, terminal commands, navigation
6. Assemble final prompt — all sources merged and trimmed

## Configuration

### Project Rules

`.windsurfrules` or `.windsurfrules.md`:
```markdown
## Stack
- Frontend: React 19 + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL with Drizzle ORM

## Conventions
- Use functional components with hooks
- All API responses use: { data, error, meta }
- Snake_case for DB columns, camelCase for TypeScript

## Boundaries
- Never modify migration files directly
- Always run tests before suggesting PR
```

### Memories System

| Level | Type | Scope |
|-------|------|-------|
| Global | Auto + Manual | All workspaces |
| Workspace | Auto + Manual | Per-project |
| System | Enterprise | Admin-defined |

Cascade **autonomously** identifies important context to remember.

### Ignore File

`.codeiumignore` — prevents Cascade from viewing/editing files:
```
.env*
secrets/
*.key
node_modules/
dist/
```

### Terminal Config
- **Allow list**: Commands that auto-execute (e.g., `git`)
- **Deny list**: Commands requiring permission (e.g., `rm`)

## Best Practices

1. Use `.windsurfrules` for stack/conventions — avoids re-explaining each session
2. Leverage Memories for persistent architecture knowledge
3. Use `.codeiumignore` for sensitive files and large generated dirs
4. Configure terminal allow/deny for safety vs speed tradeoff
5. Use browser preview element selection for UI bug fixes

## Sources

- [Cascade Docs](https://docs.windsurf.com/windsurf/cascade/cascade)
- [Memories](https://docs.windsurf.com/windsurf/cascade/memories)
- [Terminal Docs](https://docs.windsurf.com/windsurf/terminal)
- [Rules Directory](https://windsurf.com/editor/directory)

