Danijel Martinek
f77e6ea881
Curated, product-agnostic snapshot of the post-story-04 tree: demo content deleted, auth-only reference feature, web-next shell, all gates green. Product-specific docs, ADRs 027-029, PRDs/epics/archive, editor library traces, and product naming are curated out; generic template repairs (coverage provider devDeps, root test:coverage script, live lint fixes, root-only release-please) are kept. See TEMPLATE.md for provenance, curation list, and usage. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK
36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# ADR-009: Rename `adapters/` to `integrations/`
|
|
|
|
**Status:** Accepted
|
|
**Date:** 2026-05-04
|
|
|
|
## Context
|
|
|
|
The source spec (monorepo-architecture-spec-detailed-v5.md) uses `adapters/cms` and `adapters/api` for Payload and tRPC integration points. Clean Architecture also uses `adapters/` (or `interface-adapters/`) for transport-agnostic controller layer. The name collision is confusing.
|
|
|
|
## Decision
|
|
|
|
Use `integrations/` for role-based plug points (Payload and tRPC). Keep `interface-adapters/` for the Clean Architecture controller layer.
|
|
|
|
**Result:**
|
|
|
|
```
|
|
packages/<feature>/src/
|
|
interface-adapters/controllers/ ← Clean Architecture layer (transport-agnostic)
|
|
integrations/
|
|
cms/ ← Payload collections/globals
|
|
api/ ← tRPC routers
|
|
```
|
|
|
|
## Consequences
|
|
|
|
- No naming collision — intent is unambiguous
|
|
- `integrations/` semantically captures "external system integration" better than `adapters/`
|
|
- Minor deviation from source spec, documented here as deliberate choice
|
|
- All new features follow this naming consistently
|
|
|
|
## Alternatives Considered
|
|
|
|
- Keep `adapters/`: Collision with Clean Architecture terminology is confusing
|
|
- Use `external/`: Less specific; doesn't convey "Payload and tRPC"
|
|
- Rename Clean Architecture layer to `controllers/`: Could work; less standard
|