implement-hexagonal-adapter
OfficialCreate hexagonal adapters for Firefly services.
Authorfireflyframework
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Streamlines building maintainable, testable adapters by enforcing a hexagonal-architecture pattern where ports define contracts and adapters implement them against concrete technologies in the Firefly Framework.
Core Features & Use Cases
- Port-first design: Define reactive port interfaces and ensure adapters translate between domain DTOs and technology SDKs.
- Auto-configuration & feature flags: Use Spring configuration to activate the right adapter and gracefully degrade with NoOp fallbacks when a provider is unavailable.
- Isolated testing guidance: Provide isolated tests for adapters, with stub and NoOp strategies to verify wiring, error handling, and diagnostics.
- Real-world patterns: Includes examples for common modules (IDP, ECM) and guidance for port discovery, adapter registry, and selector patterns.
Quick Start
Configure a concrete adapter (eg Stripe or Azure Blob) and enable it via firefly configuration to see automatic activation.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: implement-hexagonal-adapter Download link: https://github.com/fireflyframework/fireflyframework-claude-skills/archive/main.zip#implement-hexagonal-adapter Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.