Backend Development Guidelines
Use this skill for backend and API work across web/, worker/, and packages/shared/.
When to Apply
- Creating or modifying tRPC routers and procedures
- Creating or modifying public API endpoints
- Creating or modifying queue processors, producers, or queue-backed workflows
- Building or refactoring backend services and repositories
- Working on backend auth, middleware, validation, or observability
- Updating Prisma or ClickHouse access patterns
- Adding or fixing backend tests
How to Read This Skill
- Start with AGENTS.md when the task spans multiple backend areas or you need the end-to-end checklists.
- Read only the specific reference file that matches the work when the scope is narrower.
Reference Map
| Topic | Read this when | File |
|---|---|---|
| Architecture and package boundaries | You need the web/worker/shared split, request flow, or queue lifecycle | references/architecture-overview.md |
| Routing and controllers | You are writing tRPC procedures, public API routes, or queue entrypoints | references/routing-and-controllers.md |
| Middleware and auth | You are changing request auth, permissions, or middleware composition | references/middleware-guide.md |
| Services and repositories | You are placing business logic, repository code, or DI patterns | references/services-and-repositories.md |
| Database access | You are touching Prisma, ClickHouse, tenant filters, or query patterns | references/database-patterns.md |
| Configuration | You are adding env vars, startup config, or runtime toggles | references/configuration.md |
| Testing | You are adding or updating backend tests | references/testing-guide.md |
Full Compiled Guide
Read AGENTS.md for the complete backend guide with checklists, directory conventions, imports, architecture, and cross-cutting practices.