CLAUDE.md

1# Trigger.dev SDK
2 
3`@trigger.dev/sdk` - the main customer-facing SDK for writing background tasks.
4 
5## Import Rules
6 
7Always import from `@trigger.dev/sdk`. Never use `@trigger.dev/sdk/v3` (deprecated path alias).
8 
9## Key Exports
10 
11- `task` - Define a background task
12- `schedules.task` - Define a scheduled (cron) task
13- `batch` - Batch trigger operations
14- `runs` - Run management and polling
15- `wait` - Wait for events, delays, or other tasks
16- `retry` - Retry utilities
17- `queue` - Queue configuration
18- `metadata` - Run metadata access
19- `logger` - Structured logging
20 
21## When Adding Features
22 
231. Implement the feature in the SDK
242. Test with the `hello-world` project in the [`triggerdotdev/references`](https://github.com/triggerdotdev/references) repo
253. Docs updates (`docs/`) are usually done in a separate PR
26 
27Do NOT update `rules/` or `.claude/skills/trigger-dev-tasks/` unless explicitly asked. These are maintained in separate dedicated passes.
28