Cline rules

1# ⚙️ Technical Context
2 
3## SPARC Development Methodology
4 
5The project follows the SPARC methodology for structured development:
6 
71. **Specification**: Define requirements, constraints, and acceptance criteria
82. **Pseudocode**: Develop high-level logic with TDD anchors
93. **Architecture**: Design modular components with clear interfaces
104. **Refinement**: Implement with TDD, debugging, and optimization
115. **Completion**: Integrate, document, test, and verify against criteria
12 
13### Technical Requirements
14- Files must not exceed 500 lines
15- Functions must follow single responsibility principle
16- No hardcoded environment variables or secrets
17- All code must include proper error handling
18- Modular architecture with clear component boundaries
19- Comprehensive test coverage for critical functionality
20 
21## Technology Stack
22 
23### Frontend
24- [Frontend framework/library]
25- [UI component library]
26- [State management solution]
27- [CSS approach/framework]
28- [Build tools]
29 
30### Backend
31- [Backend language/framework]
32- [API architecture]
33- [Database technology]
34- [Authentication system]
35- [Caching strategy]
36 
37### Infrastructure
38- [Hosting platform]
39- [CI/CD pipeline]
40- [Containerization]
41- [Monitoring tools]
42- [Logging system]
43 
44## Development Environment
45 
46### Required Tools
47- [Tool 1 and version]
48- [Tool 2 and version]
49- [Tool 3 and version]
50 
51### Setup Instructions
52```bash
53# Setup commands
54```
55 
56### Local Development Workflow
571. [Step 1]
582. [Step 2]
593. [Step 3]
60 
61## External Dependencies
62 
63### APIs
64- [API 1]: [Purpose and usage]
65- [API 2]: [Purpose and usage]
66 
67### Third-party Services
68- [Service 1]: [Purpose and integration details]
69- [Service 2]: [Purpose and integration details]
70 
71### Libraries and Frameworks
72- [Library 1]: [Purpose and usage]
73- [Library 2]: [Purpose and usage]
74 
75## Technical Constraints
76 
77### Performance Requirements
78- [Requirement 1]
79- [Requirement 2]
80 
81### Security Requirements
82- No hardcoded secrets, credentials, or environment variables
83- All user inputs must be validated and sanitized
84- Proper error handling to prevent information leakage
85- Secure coding practices following OWASP guidelines
86- Regular security audits of dependencies
87 
88### Compatibility Requirements
89- [Requirement 1]
90- [Requirement 2]
91 
92## Technical Debt
93 
94### Known Issues
95- [Issue 1]: [Impact and potential resolution]
96- [Issue 2]: [Impact and potential resolution]
97 
98### Planned Refactoring
99- [Refactoring 1]: [Reason and approach]
100- [Refactoring 2]: [Reason and approach]
101 
102## Testing Strategy
103 
104### SPARC Testing Approach
105- Test-Driven Development (TDD) for all new features
106- Tests written during Pseudocode phase before implementation
107- Comprehensive test coverage for critical functionality
108- Automated testing integrated into CI/CD pipeline
109 
110### Unit Testing
111- Test individual components in isolation
112- Mock dependencies for pure unit testing
113- Aim for >80% code coverage on critical paths
114- Focus on edge cases and error handling
115 
116### Integration Testing
117- Test component interactions and interfaces
118- Verify correct data flow between modules
119- Test API contracts and boundaries
120- Ensure proper error propagation
121 
122### End-to-End Testing
123- [Framework and approach]
124- [Critical user flows to test]
125 
126## Deployment Process
127 
128### Environments
129- Development: [Details]
130- Staging: [Details]
131- Production: [Details]
132 
133### Deployment Steps
1341. [Step 1]
1352. [Step 2]
1363. [Step 3]
137 
138### Rollback Procedure
1391. [Step 1]
1402. [Step 2]
1413. [Step 3]
142 
143## Monitoring and Observability
144 
145### Key Metrics
146- [Metric 1]: [What it measures and thresholds]
147- [Metric 2]: [What it measures and thresholds]
148 
149### Alerting
150- [Alert 1]: [Trigger conditions and response]
151- [Alert 2]: [Trigger conditions and response]
152 
153## Documentation Resources
154 
155### Internal Documentation
156- [Link or location 1]: [Description]
157- [Link or location 2]: [Description]
158 
159### External Documentation
160- [Link 1]: [Description]
161- [Link 2]: [Description]
162