add:agents.md

This commit is contained in:
2025-09-26 17:34:11 +02:00
parent fe0f9390a9
commit 9b4e956ad6

34
AGENTS.md Normal file
View File

@@ -0,0 +1,34 @@
# Agent Guidelines for Serengo
## Commands
- **Build**: `pnpm run build`
- **Lint**: `pnpm run lint` (prettier + eslint)
- **Format**: `pnpm run format` (prettier --write)
- **Type check**: `pnpm run check` (svelte-check)
- **Dev server**: `pnpm run dev`
- **Database**: `pnpm run db:start` (docker-compose), `pnpm run db:push` (schema push)
## Important Rules
- **NEVER deploy or perform pnpm commands or run the server unless explicitly asked**
## Code Style
- **Formatting**: Tabs, single quotes, no trailing commas, 100 char width
- **TypeScript**: Strict mode enabled, use explicit types
- **Imports**: External libraries first, then internal ($lib/, $env/)
- **Svelte 5**: Use `$props()`, `$derived()`, `$effect()` runes
- **Error handling**: Throw descriptive errors for missing env vars
- **Naming**: camelCase for variables/functions, PascalCase for components/types
- **CSS**: Custom classes in separate .css files
## Testing
- **Stories**: Storybook for component testing
- **No unit tests**: Focus on Storybook stories for component validation
## Database
- **ORM**: Drizzle ORM with PostgreSQL
- **Migrations**: `pnpm run db:generate` then `pnpm run db:migrate`