ffxi-complete/.cursor/rules/code-guidelines.mdc at main · noranda/ffxi-complete · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
---
description: "Main code guidelines with fragment references for FFXI Complete project"
globs:
  - "**/*.ts"
  - "**/*.tsx"
  - "**/*.js"
  - "**/*.jsx"
---

# FFXI Complete - Code Guidelines

## 🏆 CRITICAL: READ GOLDEN RULES FIRST

**BEFORE DOING ANYTHING ELSE, read [@golden-rules](mdc:golden-rules.mdc) - These define
the fundamental principles that must be followed in every interaction.**

## 🎭 Persona: The FFXI Completionist

Building for dedicated FFXI players who want comprehensive progress tracking with clean,
intuitive interfaces that prioritize data accuracy and simplicity over complexity.

## 📚 Rule Fragments

Read fragments in order for complete guidelines:

### 🎓 Foundation & Context

1. **@foundation/learning-focused-development** - Educational backend approach
2. **@foundation/development-environment** - IDE, tools, local setup
3. **@foundation/architecture-principles** - Core tech stack principles
4. **@foundation/project-structure** - File organization, co-located testing

### ⚙️ Code Standards & Practices

1. **@code-standards/typescript-patterns** - TypeScript config, type patterns, shared component types
2. **@code-standards/component-patterns** - Export strategies, styling with tailwind-variants
3. **@code-standards/code-documentation** - JSDoc standards, inline commenting
4. **@code-standards/code-quality** - Error handling, testing, performance, code review standards

### 💾 Backend & Data Management

1. **@backend/data-management** - Schema design, validation
2. **@backend/supabase-patterns** - Supabase best practices
3. **@backend/security-considerations** - Auth, data protection, privacy

### 🔍 Testing & Quality Assurance

1. **@testing/tdd-principles** - TDD methodology, minimal implementation
2. **@testing/testing-strategy** - Unit, integration, E2E approaches
3. **@testing/test-organization** - Test structure, **tests** folders
4. **@testing/quality-assurance** - Code quality, accessibility standards

### 🎨 Design & User Experience

1. **@design/ui-ux-guidelines** - Design principles, responsive patterns

### 🚀 Process & Optimization

1. **@process/git-workflow** - Branch naming, commits, code review
2. **@process/performance-guidelines** - Frontend/database optimization
3. **@process/documentation** - Code and user docs requirements
4. **@process/future-considerations** - Scalability, monitoring planning
5. **@process/rule-management** - Cursor rules organization
6. **@workflows/check-status** - Quality verification workflow system
7. **@process/code-guidelines-assessment** - Systematic evaluation methodology