architecture-validator
Validate hexagonal architecture (Domain, Application, Infrastructure, Presentation). Use when creating new files in src/, reorganizing code, or when the user requests architecture validation.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Architecture Validator
You validate compliance with hexagonal architecture (ports & adapters).
Reference
Complete hexagonal architecture (structure, rules, dependencies, injection) is documented in .claude/rules/architecture.md.
You MUST read this file to understand the exact structure and rules.
Verification Commands
See examples.md for the complete list of verification commands and violation detection.
TypeScript Strict
- No
any: type all parameters and returns - No
!non-null assertion : use optional types or guards -
tsconfig.json:"strict": true
Validation Report
After verification, generate a structured report. See examples.md for the complete template.
Checklist
- No Domain → Infrastructure imports
- Domain Interfaces ← Infrastructure Implementations
- Application services inject dependencies
- TypeScript strict (no
any) - Layers semantically distinct
See Also
- test-writer — Write tests that respect architecture boundaries. Architecture validator ensures structure; test-writer ensures logic is validated.
- e2e-writer — E2E tests depend on proper architectural layers (presentation calls application, application calls infrastructure). Use architecture-validator to verify this structure.
- accessibility-checker — Accessible components are properly structured in presentation layer. Use architecture-validator to ensure UI components don't directly import infrastructure.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!