Skip to content

ADR-0002 — Three packages under orms/ / frameworks/ parent folders

Status: accepted

Context

v6 ships @kavo/core, @kavo/typeorm, @kavo/nest — nothing else. But the architecture claims ORM/framework independence, and a flat layout would make a future second adapter an awkward restructuring.

Decision

Adapters live under packages/orms/<name>, framework bindings under packages/frameworks/<name>; workspace globs (orms/*, frameworks/*) already match future additions. No speculative packages are created — the parent folders are the only future-proofing.

Consequences

  • Adding a Prisma or Express package later is additive: new folder, new reference, zero moves.
  • Slightly deeper paths (packages/orms/typeorm) — trivial.
  • Every package must earn its place; v6's answer is exactly three.