Hexagonal Architecture for TypeScript / Node.js

Ports & Adapters architecture for testable, framework-independent TypeScript backend services.

vs ddd-typescript: This skill focuses on package structure and dependency direction — ports (interfaces), adapters (infrastructure), use cases, and DI wiring. Use ddd-typescript when you need domain modeling — how to design Value Objects, Entities, Aggregates, and Domain Events.

When to Activate

• Structuring a new TypeScript backend service from scratch
• Reviewing whether domain logic has leaked into adapters (or vice versa)
• Deciding where a new class/function belongs in the package hierarchy
• Writing tests: determining what to mock and at which boundary
• Replacing an adapter (e.g., Prisma → raw SQL) without touching domain

Core Principle

Dependency arrows always point inward — toward domain.