fraqtal/agentic-dev
Template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f77e6ea881a8a2a1c63a0aee897e110616e9fae1
agentic-dev/docs/decisions/adr-009-integrations-folder-naming.md
Danijel Martinek f77e6ea881 chore(template): clean-slate template snapshot from bb4a0c7 
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
2026-07-12 20:40:54 +02:00

1.3 KiB
Raw Blame History

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