Windsurf rules

1# Windsurf Rules for Megarepo
2 
3This directory contains workspace-level rules for Windsurf AI to follow when working on the megarepo AI setup repository.
4 
5## Rule Files
6 
7### Always On Rules (Applied Continuously)
8- **ai-development-core.md** - Core AI development guidelines and repository context
9- **security-api-keys.md** - Security guidelines and API key management practices
10 
11### Glob Pattern Rules (File-Type Specific)
12- **typescript-javascript.md** - Applied to `**/*.{ts,tsx,js,jsx}` files
13- **documentation-standards.md** - Applied to `**/*.md` files
14 
15### Model Decision Rules (Context-Aware)
16- **testing-ai-components.md** - Applied when working on testing strategies or test files
17 
18### Manual Rules (On-Demand)
19- **ai-optimization.md** - Use `@ai-optimization` for advanced performance optimization
20 
21## Usage
22 
23Windsurf automatically discovers and applies these rules based on their activation modes. The rules complement the existing AI agent configurations in the repository:
24 
25- `.cursorrules` - Cursor AI development rules
26- `CLAUDE.md` - Claude-specific instructions
27- `AGENT.md` - Universal AI agent instructions
28- `.github/copilot-instructions.md` - GitHub Copilot guidelines
29 
30## Rule Design Principles
31 
32- Keep rules simple, concise, and specific to AI development
33- Use XML tags to group related guidelines
34- Format with bullet points and markdown for clarity
35- Focus on AI-specific patterns rather than generic coding advice
36- Maintain consistency with existing repository patterns