Danijel Martinek
76870816d1
Implementation plan for the spec at docs/superpowers/specs/2026-05-11- opentelemetry-migration-design.md. Five phases: - Phase 1: OTel SDK infrastructure (resource builder + Sentry-as-exporter bridge + NodeSDK init helper + ESLint allowlist for OTel SDK packages). No behavior swap yet. - Phase 2 (TDD): OtelTracer impl using @opentelemetry/api; bind-sentry- instrumentation renamed to bind-otel-instrumentation with deprecation alias; delete SentryTracer. - Phase 3 (TDD): OtelLogger impl using @opentelemetry/api-logs; LogRecordProcessor wired into init helper; delete SentryLogger. Breadcrumbs become span events; setUser sets user.id span attribute. - Phase 4 (TDD): New IMetrics interface + Noop/Otel/Recording impls; MetricsProtocol added to bind-protocols; BindContext.metrics? optional field. Sentry metrics exporter deferred (experimental). - Phase 5 (TDD): HTTP/undici/pg auto-instrumentations; PII scrub processors (PiiScrubSpanProcessor + PiiScrubLogRecordProcessor) run FIRST in OTel pipeline; delete sentry/scrub.ts + orphaned init files; core-testing/setup/no-sentry.ts → no-instrumentation.ts (mocks both Sentry and OTel SDK); ADR-017 + ADR-014 status header; doc refreshes. Total: ~30 tasks across 6 phases (including Phase 0 read-first), ~25 expected commits. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Clean Architecture Monorepo Template
Turborepo + pnpm monorepo organized by vertical features. See CLAUDE.md for the full conventions reference and AGENTS.md for the package map.
Quick Start
pnpm install # Install all dependencies
pnpm dev # Start all dev servers
pnpm build # Build all packages
pnpm test # Run all tests
pnpm turbo boundaries # Validate workspace dependency graph
pnpm turbo gen feature # Scaffold a new feature package
docker compose up -d # Start PostgreSQL
Optional packages
The default template includes the must-have core packages and all 5 feature packages. Four core packages are optional and scaffold on demand:
pnpm turbo gen core-package realtime # Socket.IO realtime layer (ADR-016)
pnpm turbo gen core-package events # Cross-feature events + Payload jobs (ADR-015)
pnpm turbo gen core-package trpc # tRPC server setup
pnpm turbo gen core-package ui # Design system
See docs/architecture/template-tiers.md for the full tier list.
Key ports
| Service | Port |
|---|---|
| Next.js | 3000 |
| Payload CMS | 3001 |
| TanStack Start | 3002 |
| PostgreSQL | 5432 |
| Storybook | 6006 |