CLAUDE.md

Code Style

• Use TypeScript strict mode always
• No any types - ever
• Prefer const over let, never use var
• All functions must have JSDoc comments
• Maximum file length: 200 lines
• Maximum function length: 30 lines

Architecture

• Follow clean architecture principles
• Separate concerns: UI, business logic, data access
• Use dependency injection
• All external calls go through adapters

Testing

• Minimum 90% code coverage
• Unit tests for all business logic
• Integration tests for all API endpoints
• E2E tests for critical user flows
• Test naming: should [expected behavior] when [condition]

Git

• Conventional commits required
• No force pushes to main
• PRs require 2 approvals
• Squash merge only

Error Handling

• Never swallow errors silently
• Use custom error classes
• Log all errors with context
• User-facing errors must be friendly