## SamCloud Music App - Agent Guidelines

### Build/Lint/Tests
- `npm run lint` - Lint frontend TypeScript
- `npm run test` - Run frontend unit tests
- `docker-compose up -d` - Start all services
- `docker-compose down -v` - Clean shutdown
- `yarn build` - Build frontend
- `python server/app.py` - Run backend

### Code Style Guidelines
- Use TypeScript with strict typing
- Follow Prettier formatting
- Use ES6+ syntax
- Import modules via relative paths
- Use descriptive variable names
- Handle errors with try/catch
- Log errors with console.error()

### Project Structure
- `src/` - Frontend source
- `server/` - Backend code
- `public/` - Static assets
- `setup/` - Environment configs
- `docs/` - Documentation

### Clean Setup Instructions
1. Remove test files in `test_*.py/js`
2. Delete `node_modules/` and `dist/`
3. Remove `src-tauri/` for desktop exclusion
4. Keep only `src/`, `server/`, `public/`, and `package.json`

### Existing Rules
- No Cursor rules found
- No Copilot instructions found

🤖 Generated with [opencode](https://opencode.ai)