Arch Review

Review code for hexagonal architecture violations. Use after modifying code in packages/core/src/ Use when this capability is needed.

tomevault-io Updated

File contents

Analyze code changes for hexagonal architecture violations in Kaiord:

Dependency Rules

  • domain/ → CANNOT import from application, ports, adapters, or external libs
  • application/ → Can only import from domain and ports, NEVER from adapters
  • ports/ → Pure interfaces/types only
  • adapters/ → Implements ports, can use external libs (@garmin/fitsdk, fast-xml-parser)

Verification Checklist

  1. Search for illegal imports between layers
  2. Verify no external libs in domain/application
  3. Check that adapters implement port interfaces
  4. Verify use cases use DI via providers.ts

Useful Commands

# Search for adapter imports in application
grep -r "from.*adapters" packages/core/src/application/

# Search for external lib imports in domain
grep -r "from.*@garmin\|fast-xml-parser" packages/core/src/domain/

Report violations with file paths and specific imports.


Converted and distributed by TomeVault — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/pablo-albaladejo--kaiord--arch-review commit 4d3b067d56

Frequently asked questions

npx skillmds@latest add tomevault-io/arch-review