windsurf-reference-architecture
Implement Windsurf reference architecture with optimal project structure and AI configuration. Use when designing workspace configuration for Windsurf, setting up team standards, or establishing architecture patterns that maximize Cascade effectiveness. Trigger with phrases like "windsurf architecture", "windsurf project structure", "windsurf best practices", "windsurf team setup", "optimize for cascade". '
Profile →npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill windsurf-reference-architecture --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Windsurf Reference Architecture ## Overview Complete project architecture optimized for Windsurf AI. Covers workspace configuration, rules hierarchy, workflow organization, and team standardization patterns that maximize Cascade's effectiveness. ## Prerequisites - Windsurf IDE installed - Team agreement on coding standards - Repository with consistent project structure ## Architecture Diagram ``` ┌──────────────────────────────────────────────────────┐ │ Windsurf Workspace │ │ ┌───────────────┐ ┌────────────────────────────┐ │ │ │ .windsurfrules│ │ .windsurf/ │ │ │ │ (AI context) │ │ ├── rules/ (trigger rules)│ │ │ │ │ │ ├── workflows/ (automation)│ │ │ │ │ │ └── settings.json │ │ │ └───────────────┘ └────────────────────────────┘ │ │ ┌───────────────┐ ┌────────────────────────────┐ │ │ │ .codeiumignore│ │ ~/.codeium/ │ │ │ │ (index rules) │ │ ├── global_rules.md │ │ │ │ │ │ ├── windsurf/memories/ │ │ │ │ │ │ └── windsurf/mcp_config │ │ │ └───────────────┘ └────────────────────────────┘ │ ├──────────────────────────────────────────────────────┤ │ Cascade AI Engine │ │ ┌───────────┐ ┌───────────┐ ┌─────────────────┐ │ │ │ Super- │ │ Cascade │ │ Command │ │ │ │ complete │ │ Write/C
- Overview
- Prerequisites
- Architecture Diagram
- Instructions
- Step 1: Project File Structure
- Step 2: Rules Hierarchy
- Step 3: Team Configuration Template
- Step 4: Monorepo Strategy
- Step 5: Context Pinning Strategy
- Error Handling
- Examples
- Minimal .windsurfrules for Any Project
- Verify Architecture Setup
- Resources
set -euo pipefail echo "=== Windsurf Architecture Check ===" echo "Rules: $([ -f .windsurfrules ] && wc -c < .windsurfrules || echo 'MISSING') chars" echo "Ignore: $([ -f .codeiumignore ] && wc -l < .codeiumignore || echo 'MISSING') patterns" echo "Rules dir: $(ls .windsurf/rules/ 2>/dev/null | wc -l || echo 0) files" echo "Workflows: $(ls .windsurf/workflows/ 2>/dev/null | wc -l || echo 0) files"
What does the windsurf-reference-architecture skill do?
Implement Windsurf reference architecture with optimal project structure and AI configuration. Use when designing workspace configuration for Windsurf, setting up team standards, or establishing architecture patterns that maximize Cascade effectiveness. Trigger with phrases like "windsurf architecture", "windsurf project structure", "windsurf best practices", "windsurf team setup", "optimize for cascade". '
How do I install it?
Run `npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill windsurf-reference-architecture --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jeremylongshore/claude-code-plugins-plus-skills, a repository with 2,630 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.