Cursor rule

1---
2globs:
3  - "**/*"
4---
5 
6# Hermes Project-Wide Rules
7 
8## Monorepo Structure
9 
10This is a pnpm workspace monorepo with two main packages:
11- `packages/hermes-api` - Python FastAPI backend
12- `packages/hermes-app` - TypeScript React frontend
13 
14## General Conventions
15 
16### File Organization
17- Keep package-specific code within respective `packages/` directories
18- Shared documentation goes in `docs/` at root level
19- Docker configuration can be at root or package level
20 
21### Environment Variables
22- Always provide `.env.example` with placeholder values
23- Use `HERMES_` prefix for all environment variables
24- Document all environment variables in `docs/CONFIGURATION.md`
25 
26### Git Commits
27- Use conventional commit format: `type(scope): description`
28- Types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
29- Keep commits atomic and focused
30- Reference issue numbers when applicable
31 
32### Code Quality
33- All code must pass respective linters before commit
34- Write tests for new features
35- Update documentation when changing behavior
36- Follow language-specific style guides (Black for Python, ESLint for TypeScript)
37 
38### Documentation
39- README files should be clear and up-to-date
40 
41## pnpm Workspace Commands
42 
43Run commands from root using:
44```bash
45pnpm --filter hermes-app <command>
46pnpm --filter hermes-api <command>
47```
48 
49Or use the convenience scripts defined in root `package.json`.
50 
51## Tooling
52 
53- hermes-app uses `pnpm` for package management. Do not use `npm`.
54- hermes-api uses `uv` for package management. Do not use `pip`.
55- Use `docker compose` for container orchestration. Do not use `docker-compose`.