backend-dev-guidelines

Comprehensive backend development guide for Langfuse's Next.js 14/tRPC/Express/TypeScript monorepo. Use when creating tRPC routers, public API endpoints, BullMQ queue processors, services, or working with tRPC procedures, Next.js API routes, Prisma database access, ClickHouse analytics queries, Redis queues, OpenTelemetry instrumentation, Zod v4 validation, env.mjs configuration, tenant isolation patterns, or async patterns. Covers layered architecture (tRPC procedures → services, queue processors → services), dual database system (PostgreSQL + ClickHouse), projectId filtering for multi-tenant isolation, traceException error handling, observability patterns, and testing strategies (Jest for web, vitest for worker).

1. Zainstaluj skill backend-dev-guidelines z repozytorium Langfuse — umieść go w katalogu .claude/skills swojego projektu Next.js 14 z tRPC i TypeScript.
2. Skill aktywuje się automatycznie gdy pracujesz nad tRPC routerami, endpointami publicznego API, konsumentami BullMQ, serwisami biznesowymi lub middleware'em — nie wymaga ręcznego uruchamiania.
3. Przy tworzeniu nowej procedury tRPC użyj wytycznych z sekcji "UI: New tRPC Feature Checklist" — zdefiniuj router w features/[feature]/server/*Router.ts, wybierz typ procedury (protected lub public), dodaj autoryzację JWT i sprawdzenie uprawnień dostępu do zasobu.
4. Dla operacji bazodanowych stosuj Prisma do PostgreSQL i ClickHouse do analityki — skill podpowie wzorce dostępu i filtrowanie projectId dla izolacji dzierżawców.
5. Implementuj obserwowalność za pomocą OpenTelemetry, loggera i traceException do obsługi błędów — skill zawiera rekomendowane wzorce instrumentacji.
6. Waliduj dane wejściowe schematami Zod v4 i konfiguruj zmienne środowiska przez env.mjs — skill opisuje strukturę i best practices dla obu.