Surf smarter. Code smoother. Let the vibes guide you.

Vibe Rules Collection is a curated library of .windsurfrules files designed to guide AI coding assistants—especially Codeium's Cascade—to generate code that reflects best practices, idiomatic styles, and architectural clarity.

This repo provides a language- and framework-aware vibe system for smoother developer + AI collaboration.

• Overview
• Purpose
• Usage
• Rule Categories
• Contributing
• Code of Conduct
• License

AI tools accelerate development—but without vibes, they can generate code that’s noisy, offbeat, or even anti-patterned.

Enter Vibe Rules.

Each .windsurfrules file serves as a lightweight blueprint for:

• Language idioms
• Architectural paradigms
• Design system consistency
• DevOps conventions

Think of these files as surfboards: they help your AI ride the right wave.

1. Clone or reference the relevant .windsurfrules files.
2. Integrate with a compatible AI coding assistant (like Cascade in Windsurf IDE).
3. Let your assistant vibe in style.

Configure your project to load rule files automatically or use them contextually via prompts.

• graphql_api_design.windsurfrules
• rest_api_design.windsurfrules

• Clean, Hexagonal, Microservices, MVC, SOA, etc.

• MySQL, PostgreSQL, SQL Server, Oracle PL/SQL, SQLite

• Material, Apple HIG, Ant Design, Fluent UI, Atlassian

• Git workflows, Terraform, Shell, PowerShell

• algorithmic_trading_principles.windsurfrules
• alpaca_python_sdk.windsurfrules
• backtesting_techniques.windsurfrules
• financial_modeling_patterns.windsurfrules

• Express, Flask, Rails, Unity, ASP.NET Core

• Pythonic, Modern C++, Idiomatic Ruby, Modular TypeScript, Rust Clean Arch

• anthropic_python_sdk_guidelines.windsurfrules

• OOP, Functional, Event-Driven, Data-Oriented

• General tuning & SQL optimization

• Linting principles

• OWASP Top 10, Secrets Management, Input Validation

• mutation_testing_principles.windsurfrules
• hypothesis_property_based_testing.windsurfrules
• contract_testing_pact.windsurfrules
• performance_testing_principles.windsurfrules
• chaos_engineering_principles.windsurfrules
• accessibility_testing_a11y.windsurfrules
• context_driven_testing_principles.windsurfrules
• ui_page_object_model.windsurfrules
• ui_screenplay_pattern.windsurfrules
• ui_data_driven_testing.windsurfrules

Pull requests are welcome. Got a vibe you want to share? Submit a .windsurfrules file or open a discussion.

See CONTRIBUTING.md for guidelines.

We vibe respectfully. All interactions are governed by the Code of Conduct.

MIT License 2025 copyleftdev

See LICENSE for full terms.

🌀 Keep the code clean. Ride the right patterns. Respect the vibes. 🌀