Cline rules

1# Development Guidelines
2 
3## Technology Stack
4This repository is pre-configured for **Node.js/Next.js development** with AI integrations.
5 
6### When Source Code is Added
7Follow these patterns based on existing repository guidelines:
8 
9```bash
10# Always verify package.json exists first
11test -f package.json && echo "Node.js project detected" || echo "No package.json found"
12 
13# Install dependencies with appropriate timeout
14npm install  # Allow 10+ minutes for completion
15 
16# Build with extended timeout for AI projects
17npm run build  # Allow 60+ minutes - AI projects can have complex builds
18 
19# Run tests with adequate time
20npm test  # Allow 30+ minutes for comprehensive test suites
21```
22# Build with reasonable timeout for most projects
23npm run build  # Allow 15-30 minutes for most Node.js/Next.js builds with AI integrations
24 
25# Run tests with adequate time
26npm test  # Allow 30+ minutes for comprehensive test suites
27## AI Integration Best Practices
28 
29### Preferred AI Dependencies
30When adding AI functionality, use these established packages:
31- `openai` - Official OpenAI API client
32- `@langchain/core` - LangChain framework for AI workflows
33- `@vercel/ai` - Vercel AI SDK for streaming and UI integration
34- `@huggingface/inference` - Hugging Face API client
35- `@anthropic-ai/sdk` - Anthropic Claude API client
36 
37### Code Organization
38- Place AI client configurations in `src/lib/` directory
39- Create reusable AI components in `src/components/ai/`
40- Implement API routes for AI services in `src/app/api/` (Next.js App Router)
41- Define TypeScript types for AI responses in `src/types/`
42 
43### Error Handling Pattern
44```javascript
45// Implement comprehensive error handling for AI services
46try {
47  const response = await aiClient.chat.completions.create({
48    model: "gpt-4",
49    messages: [{ role: "user", content: prompt }]
50  });
51  return response.choices[0].message.content;
52} catch (error) {
53  if (error.code === 'rate_limit_exceeded') {
54    throw new AIRateLimitError('Rate limit exceeded, please try again later');
55  }
56  if (error.code === 'insufficient_quota') {
57    throw new AIQuotaError('API quota exceeded');
58  }
59  throw new AIServiceError(`AI service failed: ${error.message}`);
60}
61```
62 
63## File Structure Standards
64Follow the established minimal structure and expand thoughtfully:
65 
66```
67.
68├── .clinerules/              # Cline AI rules (this directory)
69├── .github/                  # GitHub workflows and Copilot instructions
70├── .kiro/steering/           # Kiro AI steering files
71├── .cursorrules              # Cursor AI development rules
72├── CLAUDE.md                 # Claude AI specific configuration
73├── GEMINI.md                 # Gemini CLI configuration
74├── AGENT.md                  # Universal AI agent instructions
75├── package.json              # Dependencies and scripts (when added)
76├── src/                      # Source code (when added)
77│   ├── lib/                  # AI clients and utilities
78│   ├── components/           # React components including AI components
79│   ├── app/                  # Next.js App Router (pages and API routes)
80│   └── types/                # TypeScript definitions
81└── public/                   # Static assets
82```
83 
84## Development Workflow
851. **Before Changes**: Check repository state and existing patterns
862. **During Development**: Follow TypeScript best practices and AI patterns
873. **Testing**: Include AI service mocks and error scenario testing
884. **Documentation**: Update relevant AI configuration files as needed