Rules Reference

Browse the complete collection of 109 VDK Blueprints rules organized by category. Each rule provides specific guidance for AI assistants to follow consistent patterns in your development workflow.

Rule Categories Overview

Core Rules

Essential behavioral patterns that apply to all AI assistant interactions:

00-agent-behavior.mdc

AI Developer Assistant Core Principles

• Core AI assistant persona and response format
• General coding principles and communication guidelines
• Specialized mode management
• Platform compatibility across all assistants

01-code-quality.mdc

Code Quality Standards

• Universal code quality guidelines
• Best practices for maintainable code
• Code review criteria and standards
• Documentation requirements

02-security-practices.mdc

Security Best Practices

• Security-first development approach
• Common vulnerability prevention
• Secure coding patterns
• Authentication and authorization guidelines

03-error-prevention.mdc

Error Prevention Patterns

• Common mistake prevention
• Defensive programming techniques
• Testing and validation strategies
• Error handling best practices

Language Rules

Programming language-specific guidance and patterns:

TypeScript-Modern.mdc

Modern TypeScript Development

• Latest TypeScript features and patterns
• Type safety best practices
• Modern syntax and conventions
• Performance optimizations

TypeScript5.mdc

TypeScript 5 Features

• TypeScript 5 specific capabilities
• New language features
• Migration strategies
• Advanced type patterns

Python3.mdc

Python 3 Best Practices

• Modern Python development
• PEP compliance and conventions
• Package management and virtual environments
• Testing and documentation

Swift.mdc

Swift Development Guidelines

• iOS and macOS development patterns
• SwiftUI best practices
• Concurrency and async patterns
• Performance considerations

CPP20.mdc

Modern C++ Standards

• C++20 features and patterns
• Memory management best practices
• Performance optimization
• Cross-platform development

Kotlin.mdc

Kotlin Development Patterns

• Android development guidelines
• Kotlin-specific language features
• Interoperability with Java
• Coroutines and concurrency

Technology Rules

Framework and tool-specific implementation patterns:

Frontend Technologies

• React19.mdc: Modern React development with React 19 features
• NextJS.mdc: Next.js best practices and patterns
• Astro4.mdc: Astro framework for content-focused sites
• Vue3.mdc: Vue 3 composition API and patterns
• Svelte5.mdc: Svelte 5 reactive programming

Styling & UI

• Tailwind4.mdc: Utility-first CSS with Tailwind CSS 4
• ShadcnUI.mdc: Component library integration
• ShadcnUI-Integration.mdc: Advanced integration patterns

Backend Technologies

• NodeExpress.mdc: Node.js and Express server patterns
• FastAPI.mdc: Python web API development
• GraphQL.mdc: GraphQL API design and implementation

Database & Authentication

• Supabase.mdc: Database, auth, and real-time features
• SwiftData.mdc: Core Data replacement for Swift
• Clerk.mdc: Authentication and user management

Mobile Development

• SwiftUI.mdc: iOS user interface development
• Flutter.mdc: Cross-platform mobile development
• PySideUI.mdc: Python desktop application development

DevOps & Infrastructure

• Docker-Kubernetes.mdc: Containerization and orchestration
• Tauri.mdc: Rust-based desktop applications

AI & Advanced Features

• AI-Workflow-Integration.mdc: AI workflow patterns
• Agentic-AI-Development.mdc: AI agent development
• MCP-Integration.mdc: Model Context Protocol integration
• MCP-Servers.mdc: MCP server development
• Memory-Management.mdc: Memory optimization patterns
• Memory-MCP.mdc: Memory-specific MCP patterns
• Sequential-Thinking.mdc: Sequential reasoning patterns
• Sequential-Thinking-Advanced.mdc: Advanced reasoning techniques

Stack Rules

Complete technology stack combinations:

NextJS-Supabase.mdc

Full-Stack Next.js + Supabase

• Complete web application stack
• Authentication and database integration
• Real-time features and subscriptions
• Deployment and scaling patterns

React-Native-Mobile.mdc

React Native Mobile Development

• Cross-platform mobile development
• Navigation and state management
• Native module integration
• Performance optimization

TRPC-FullStack.mdc

End-to-End Type Safety with TRPC

• Type-safe API development
• Full-stack TypeScript patterns
• Client-server communication
• Error handling and validation

Astro-Content.mdc

Content-Focused Sites with Astro

• Static site generation patterns
• Content management strategies
• Performance optimization
• SEO best practices

E-commerce.mdc

E-commerce Development Patterns

• Online store architecture
• Payment processing integration
• Inventory management
• Security considerations

NextJS-Enterprise.mdc

Enterprise Next.js Applications

• Large-scale application architecture
• Team collaboration patterns
• Performance at scale
• Maintenance and monitoring

Task Rules

Executable development workflows and processes:

AI-Powered Tasks

• AI-Code-Review.mdc: Automated code review processes
• AI-Pair-Programming.mdc: Collaborative AI programming
• AI-Refactoring.mdc: AI-assisted code refactoring
• AI-Session-Handoff.mdc: Session continuity patterns

Architecture & Design

• System-Architecture.mdc: System design patterns
• Architecture-Design-Review.mdc: Architecture review processes
• Component-Interfaces.mdc: Interface design patterns
• Service-Integration.mdc: Service integration strategies

Development Workflows

• Generate-Boilerplate.mdc: Code generation workflows
• Generate-Types.mdc: Type definition generation
• Generate-Config.mdc: Configuration file generation
• Git-Flow.mdc: Git workflow management

Testing & Quality

• Write-Tests.mdc: Test development strategies
• Code-Quality-Review.mdc: Quality assessment processes
• Performance-Issues.mdc: Performance troubleshooting
• Security-Audit.mdc: Security assessment workflows

Documentation

• Technical-Docs.mdc: Technical documentation creation
• API-Docs.mdc: API documentation patterns
• User-Guide.mdc: User documentation strategies
• Generate-Onboarding.mdc: Onboarding documentation

Analysis & Optimization

• Analyze-Dependencies.mdc: Dependency analysis
• Analyze-Coverage.mdc: Test coverage analysis
• Analyze-Logs.mdc: Log analysis patterns
• Optimize-Performance.mdc: Performance optimization

View complete task reference →

Assistant Rules

AI platform-specific configurations and optimizations:

Claude.mdc

Claude Assistant Optimization

• Claude-specific feature utilization
• Tool integration patterns
• Memory management strategies
• Performance optimization

Cursor.mdc

Cursor IDE Integration

• Real-time assistance patterns
• File pattern matching
• Auto-completion optimization
• Workspace configuration

Windsurf.mdc

Windsurf Workflow Patterns

• Memory-optimized instructions
• Workspace awareness features
• Context management strategies
• Performance considerations

GitHub-Copilot.mdc

GitHub Copilot Configuration

• Code suggestion optimization
• Review integration patterns
• Priority management
• Quality assurance

VSCode.mdc

VS Code Extension Integration

• Extension compatibility patterns
• Workspace configuration
• Tool integration strategies
• Performance optimization

JetBrains.mdc

JetBrains IDE Integration

• IntelliJ platform optimization
• Language-specific configurations
• Plugin integration patterns
• Debugging and profiling

Zed.mdc

Zed Editor Patterns

• Performance-focused development
• Collaborative editing features
• Extension integration
• Workflow optimization

Tool Rules

Development tool integration patterns:

Code-Search.mdc

Code Search Optimization

• Efficient code discovery patterns
• Search strategy optimization
• Index management
• Performance considerations

Command-Execution.mdc

Command Line Integration

• Shell command patterns
• Automation strategies
• Error handling
• Security considerations

File-Operations.mdc

File Management Patterns

• File system operations
• Batch processing strategies
• Backup and recovery
• Performance optimization

Usage Examples

Finding the Right Rule

1. By Technology Stack:

   # For React + TypeScript projects
   .ai/rules/languages/typescript-modern.mdc
   .ai/rules/technologies/react19.mdc

2. By Development Task:

   # For code review process
   .ai/rules/tasks/AI-Code-Review.mdc
   .ai/rules/core/01-code-quality.mdc

3. By AI Assistant:

   # For Cursor users
   .ai/rules/assistants/cursor.mdc
   .ai/rules/core/00-agent-behavior.mdc

Integration Priority

Rules are applied with the following priority:

1. Core Rules: Always active (highest priority)
2. Language Rules: Based on detected file types
3. Technology Rules: Based on project dependencies
4. Stack Rules: When multiple technologies match
5. Task Rules: When specific workflows are active
6. Assistant Rules: Platform-specific optimizations

Next Steps

• Platform Integration - Set up rules with your AI assistant
• Writing Rules - Create custom rules
• Examples - See rules in action
• Contributing - Add new rules to the collection