mixpanel-react-native/claude/updates/cursor-rules-audit-2025-05-30.md

Official React Native Tracking Library for Mixpanel Analytics

# Cursor Rules Audit Report - 2025-05-30

## Rules Effectiveness Summary

### Always Rules Status
- Total size: ~450 lines of 500 limit
- Rules needing update: 2
- Rules to remove: 0
- Space for new rules: ~50 lines available

### Component Rules Coverage
| Component Type | Has Rules | Patterns Covered | Gaps Identified |
|----------------|-----------|------------------|-----------------|
| Native Modules | ✓ | 8/9 patterns | Gzip compression parameter |
| JavaScript Implementation | ✓ | 6/7 patterns | Identity queue management |
| Storage Operations | ✓ | 9/10 patterns | Module resolution pattern |
| Network Operations | ✓ | 5/5 patterns | All covered |
| Testing | ✓ | 4/4 patterns | All covered |

### Recommended Changes

#### High Priority Updates

1. **Rule**: `always/error-handling.mdc`
   - **Issue**: UUID generation pattern has evolved to use expo-crypto
   - **Action**: Update fallback pattern example
   - **Impact**: Affects device ID generation in Expo environments

2. **Rule**: `components/storage-operations.mdc`
   - **Issue**: Storage module resolution needs update for ES6/CommonJS handling
   - **Action**: Update AsyncStorageAdapter constructor pattern
   - **Impact**: Affects storage initialization reliability

3. **Rule**: `components/javascript-implementation.mdc`
   - **Issue**: Missing identity queue management pattern
   - **Action**: Add identifyUserQueue pattern
   - **Impact**: Affects user identification flow

#### New Rules Needed

1. **Pattern**: Conditional property inclusion
   - **Category**: Always rule (universal pattern)
   - **Prevents**: Sending null values to API
   - **Size estimate**: ~30 lines

2. **Pattern**: Gzip compression support
   - **Category**: Component rule (native modules)
   - **Prevents**: Missing compression parameter
   - **Size estimate**: ~20 lines

#### Rules to Update (Minor)

1. **Rule**: `always/core-conventions.mdc`
   - **Issue**: Import formatting now uses consistent spacing
   - **Action**: Update import examples
   - **Impact**: Code consistency

#### Rules to Deprecate
- None identified - all existing rules remain relevant

## Pattern Evolution Summary

### Mature Patterns (Ready for Rules)
- Conditional property inclusion using spread operator
- UUID generation with expo-crypto fallback
- Storage module resolution for ES6/CommonJS

### Growing Patterns (Monitor for Future)
- Identity queue management improvements
- Token-specific storage initialization

### Deprecated Patterns
- None identified in this update cycle

## Risk Assessment
- **Low Risk**: All changes are backward compatible
- **Medium Risk**: Storage module resolution change affects initialization
- **No Breaking Changes**: All patterns maintain existing behavior

## Recommendation Priority
1. Update storage module resolution (prevents initialization failures)
2. Add UUID generation fallback pattern (improves Expo support)
3. Add conditional property pattern (prevents API issues)
4. Update import formatting (consistency)
5. Document gzip compression (new feature awareness)