docs(adrs): ratify cache ownership [ADR-1043]

Story 1043Epic 9253 files · +177/−0

PR #129 · pramaan-io/pramaan-docs · merged 2026-06-05

How it flows

sequenceDiagram
  autonumber
  participant user as User
  participant rsc as RSC Server
  participant client as Client (TanStack)
  user->>rsc: GET /dashboard
  rsc->>rsc: prefetch + render
  rsc->>client: HTML + data
  client->>client: opt-in: hydrate
  client->>rsc: mutate → invalidate
  rsc->>client: fresh payload

What this decision prevents

RSC owns freshness by default
Client cache joins only on opt-in
No-spinner SSR via RSC prefetch
Tier 2 header invalidation stays deferred
Per-surface opt-in still needs team discipline

Files changed (3)

File±
docs/decisions/adrs/ADR-095-tanstack-cache-ownership-rsc-first-hybrid.md ★+134
docs/decisions/adrs/ADR-REGISTRY.md ★+1
docs/decisions/adrs/adr-registry.json ★+42