hecaguilav/symbiosis/hexagonal-architecture-layers-java
Claude Code and agent skill by hecaguilav/symbiosis
- community
Checking that the SKILL.md file is still in the repository.
Hexagonal architecture layering for Java services with strict boundaries. Trigger: When structuring Java apps by Domain/Application/Infrastructure, or refactoring toward clean architecture.
Install
npx vskill@latest install hecaguilav/symbiosis/hexagonal-architecture-layers-javaSKILL.md
The same SKILL.md was published earlier as majiayu000/claude-skill-registry/hexagonal-architecture-layers-java.
When to Use
Load this skill when:
- Designing a new Java service with clean, testable layers
- Refactoring Spring code to isolate the domain from frameworks
- Supporting multiple adapters (REST + messaging, JPA + Mongo)
- Enforcing dependency direction and clear module boundaries
Critical Patterns
Pattern 1: Domain is pure
Domain has no framework annotations, no persistence concerns, and no I/O.
Pattern 2: Application orchestrates
Application defines use cases and ports, calling domain logic and delegating I/O to ports.
Pattern 3: Infrastructure adapts
Infrastructure implements ports and wires adapters (controllers, repositories, clients).
Code Examples
Example 1: Domain model + output port
Example 2: Application use case + input port
Example 3: Infrastructure adapter + wiring
Anti-Patterns
Don't: Put framework annotations in domain
Don't: Call infrastructure directly from domain
Quick Reference
| Task | Pattern | |
|---|---|---|
| Persist domain data | Define output port in application, implement in infrastructure | |
| Expose use case | Define input port and service in application | |
| Keep domain pure | No annotations, no I/O, no framework imports |
Resources
- Hexagonal Architecture: https://alistair.cockburn.us/hexagonal-architecture/
- Clean Architecture: https://www.oreilly.com/library/view/clean-architecture/9780134494272/
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingEcosistema/Habilidades/comunidad/hexagonal-architecture-layers-java/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/hecaguilav/symbiosis/hexagonal-architecture-layers-java)