# 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

# Project Instructions

## Overview
This is a TypeScript monorepo using pnpm workspaces.

## Code Style
- Use strict TypeScript with no implicit any
- Prefer functional components with hooks
- All exports should be named (no default exports)

## Architecture
- /packages/core — shared business logic
- /packages/ui — React component library
- /apps/web — Next.js frontend

## Build & Test
Run tests with: pnpm test
Build all packages: pnpm build
All PRs must have >80% coverage on changed files.

## Conventions
- Use conventional commits (feat:, fix:, chore:)
- Prefer composition over inheritance
- See @docs/api-guidelines.md for API design patterns