Skip to content

AGENTS.md

Latest commit

 

History

History
27 lines (19 loc) · 1.01 KB

AGENTS.md

File metadata and controls

27 lines (19 loc) · 1.01 KB
Raw

Repository Guide

This is a library monorepo for vendor-neutral infrastructure ports and vendor-specific adapters.

Package map

  • packages/core → @codectyl/agnostic-core: ports, shared entities, schemas, and vendor-independent implementations.
  • packages/adapter-supabase → @codectyl/agnostic-adapter-supabase: Supabase-specific implementations.
  • docs/ARCHITECTURE.md: ownership and dependency rules.
  • docs/ROADMAP.md: planned work and status.

Placement rules

Put vendor-neutral interfaces and entities in agnostic-core. Put code that imports a vendor SDK or vendor-specific persistence detail in a named adapter. Adapters may depend on core; core must not depend on adapters.

Use Port for vendor-neutral interfaces and Adapter for concrete classes.

Validation

Run pnpm typecheck and pnpm build from the repository root. Add contract tests when implementing an adapter. Read the architecture document before changing package ownership and the roadmap before starting follow-up work.