# Project Conventions

## Language
- TypeScript strict mode, no `any` types
- Prefer const over let, never use var
- Use template literals over string concatenation

## Architecture
- Feature-based folder structure under src/features/
- Each feature exports through an index.ts barrel file
- Shared utilities go in src/lib/

## Error Handling
- Use Result<T, E> pattern for expected failures
- Throw only for programmer errors
- Always log errors with structured context

## Testing
- Colocate tests next to source files (*.test.ts)
- Use factories for test data, not fixtures
- Integration tests in __tests__/ directories

# Agent Instructions

## Project
A Django REST API serving a React frontend.

## Setup
- Python 3.12 with Poetry
- PostgreSQL 15
- Redis for caching and Celery broker

## Key Commands
- poetry run python manage.py runserver
- poetry run pytest
- poetry run mypy .

## Pull Request Guidelines
- Keep PRs focused on a single issue
- Add tests for all new functionality
- Update API docs in docs/api/ if endpoints change
- Run the linter: poetry run ruff check .

## Architecture Notes
- apps/core/ — shared models and utilities
- apps/api/v2/ — current API version
- apps/tasks/ — Celery background tasks