Cursor rule

1---
2description: "Common patterns: repository, API response, skeleton projects"
3alwaysApply: true
4---
5# Common Patterns
6 
7## Skeleton Projects
8 
9When implementing new functionality:
101. Search for battle-tested skeleton projects
112. Use parallel agents to evaluate options:
12   - Security assessment
13   - Extensibility analysis
14   - Relevance scoring
15   - Implementation planning
163. Clone best match as foundation
174. Iterate within proven structure
18 
19## Design Patterns
20 
21### Repository Pattern
22 
23Encapsulate data access behind a consistent interface:
24- Define standard operations: findAll, findById, create, update, delete
25- Concrete implementations handle storage details (database, API, file, etc.)
26- Business logic depends on the abstract interface, not the storage mechanism
27- Enables easy swapping of data sources and simplifies testing with mocks
28 
29### API Response Format
30 
31Use a consistent envelope for all API responses:
32- Include a success/status indicator
33- Include the data payload (nullable on error)
34- Include an error message field (nullable on success)
35- Include metadata for paginated responses (total, page, limit)
36