CLAUDE.md

1# ColorAgent Development Guide
2 
3## Commands
4- Tests: 
5  - All tests: `pytest`
6  - Single test: `pytest path/to/test.py::TestClass::test_method`
7  - Frontend: `cd apps/ && pnpm test`
8  - Single frontend test: `cd frontend && pnpm jest <test_file>`
9- Lint: 
10  - Python: `ruff .` 
11  - Frontend: `cd frontend && pnpm format`
12  - TypeScript check: `cd frontend && pnpm typescript:check`
13- Build:
14  - Frontend: `cd frontend && pnpm build`
15  - Start dev: `./bin/start`
16 
17## Code Style
18- Python: Use type hints, follow mypy strict rules
19- Frontend: TypeScript required, explicit return types
20- Imports: Use simple-import-sort
21- CSS: Use utility classes instead of inline styles
22- Error handling: Prefer explicit error handling with typed errors
23- Naming: Use descriptive names, camelCase for JS/TS, snake_case for Python
24- Comments: Leave comments to explain tricky areas of the code or to explain WHY something is there, but don't just leave comments everywhere, the code should be default readable