# Project Guidelines

## Language & Framework
- Kotlin with Spring Boot 3.x
- Gradle with Kotlin DSL
- JDK 21 with virtual threads

## Architecture
- Hexagonal architecture (ports & adapters)
- Domain events for cross-module communication
- CQRS for read-heavy endpoints

## Code Standards
- Follow Kotlin coding conventions
- Use data classes for DTOs
- Prefer sealed classes for domain errors
- Extension functions over utility classes

## Testing
- JUnit 5 with Kotest assertions
- Testcontainers for integration tests
- MockK for mocking (not Mockito)

## Build & Run
- Build: ./gradlew build
- Test: ./gradlew test
- Run: ./gradlew bootRun

---
inclusion: always
---

# Project Standards

## Stack
- TypeScript 5.x with Node.js 22
- AWS CDK v2 for infrastructure
- DynamoDB for data, S3 for assets

## Conventions
- Use ESM imports, not CommonJS
- Lambda handlers export a named `handler` function
- Use middy middleware for cross-cutting concerns
- All API responses follow JSON:API format

## Testing
- Unit tests with vitest
- Integration tests with aws-testing-library
- E2E tests use deployed staging environment