hexagonal-architecture SKILL.md skillA

hexagonal-architecture from hashgraph-online/awesome-codex-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hashgraph-online/awesome-codex-plugins/hexagonal-architecture@git:20260512.6523792

Pins git:20260512.6523792 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hashgraph-online/awesome-codex-plugins
Path
plugins/Colin4k1024/tsp/skills/hexagonal-architecture/SKILL.md
Versions recorded
1
Latest version
git:20260512.6523792, committed May 12, 2026
Size
11,425 bytes
Repository stars
1,501
License
Apache-2.0

Design, implement, and refactor Ports & Adapters systems with clear domain boundaries, dependency inversion, and testable use-case orchestration across TypeScript, Java, Kotlin, and Go services.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Hexagonal Architecture

Hexagonal architecture (Ports and Adapters) keeps business logic independent from frameworks, transport, and persistence details. The core app depends on abstract ports, and adapters implement those ports at the edges.

## When to Use

- Building new features where long-term maintainability and testability matter.
- Refactoring layered or framework-heavy code where domain logic is mixed with I/O concerns.
- Supporting multiple interfaces for the same use case (HTTP, CLI, queue workers, cron jobs).
- Replacing infrastructure (database, external APIs, message bus) without rewriting business rules.

Use this skill when the request involves boundaries, domain-centric design, refactoring tightly coupled services, or decoupling application logic from specific libraries.

## Core Concepts

- **Domain model**: Business rules and entities/value objects. No framework imports.
- **Use cases (application layer)**: Orchestrate domain behavior and workflow steps.
- **Inbound ports**: Contracts describing what the application can do (commands/queries/use-case interfaces).
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hashgraph-online/awesome-codex-plugins/hexagonal-architecture@sha256:aebd20d983a894af

The line at the top of this page pins the label git:20260512.6523792, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_d34c3sw2bwz4vcdq.svg)](https://markdownregistry.com/a/art_d34c3sw2bwz4vcdq)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 12, 2026.

versioncommittedcommitsizeaudit
git:20260512.6523792 latest2026-05-12 6523792 11,425 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11425 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hashgraph-online/awesome-codex-plugins · 1,501 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_d34c3sw2bwz4vcdq
GET https://markdownregistry.com/api/v1/resolve?ref=hashgraph-online/awesome-codex-plugins/hexagonal-architecture
GET https://markdownregistry.com/api/v1/blob/aebd20d983a894af4407da9bcfe95cab3bfd5243d0f60d5e32be60c46f9fd30e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hashgraph-online/awesome-codex-plugins

AGENTS.md AGENTS.md file
hashgraph-online/awesome-codex-plugins · AGENTS.md
git:20261103.f1993d0 · audit A · 1,501 stars
ontoly-software-graph SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/0xsarwagya/ontoly-codex-plugin/skills/ontoly-software-graph/SKILL.md · Use Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files…
git:20260714.2040a1b · audit A · 1,501 stars
agent-debug-fixer SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-debug-fixer/SKILL.md · 中文调试修复技能。用于报错、测试失败、页面异常、功能不符合预期、需要定位根因并做最小修复时。触发语包括"进入调试模式""帮我修问题""报错了""测试失败""页面坏了""找根因"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-drift-auditor SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-drift-auditor/SKILL.md · 中文漂移审计技能。用于项目或学习过程变乱、上下文漂移、任务分叉、多个方案冲突、命名不一致、Codex 可能顺手改多了时。触发语包括"漂移检查""感觉跑偏了""项目变乱了""检查是否失控""分叉太多""上下文漂移"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-learning-coach SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-learning-coach/SKILL.md · 中文学习教练技能。用于学习编程、英语、设计、产品、AI、数学或任何技能时,先诊断水平,再用讲解、练习、反馈、复习的循环推进。触发语包括"进入学习模式""我想学""带我练""帮我制定学习计划""像教练一样教我"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-newbie-guide SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-newbie-guide/SKILL.md · 中文新手引导技能。用于用户有模糊目标、不会拆任务、不知道如何开始使用 Codex、希望像游戏新手教程一样被一步步引导时。触发语包括"启动新手引导""我有个模糊目标""我不知道怎么开始""帮我把想法变成任务""像小白一样带我做"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-phase-closeout SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-phase-closeout/SKILL.md · 中文阶段收尾技能。用于完成一个阶段、准备开新对话、需要更新状态快照、冻结模块、整理已完成任务和下一步任务时。触发语包括"阶段收尾""帮我收工""准备开新对话""更新快照""冻结阶段""总结当前状态"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-project-master SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-project-master/SKILL.md · 中文项目总控技能。用于产品开发、软件项目、长期计划、任务拆分、阶段规划、项目真相源维护、多个任务防分叉管理。触发语包括"进入总控模式""帮我规划项目""拆任务""建立 PROJECT.md""管理任务队列""产品开发任务"。
git:20260615.9a28338 · audit A · 1,501 stars
computefirst SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/321zz321/computefirst-skill/skills/computefirst/SKILL.md · Use ComputeFirst for exact or deterministic computation when model-side arithmetic or manual transformation risks being…
git:20261103.4c2b322 · audit A · 1,501 stars
task-planner SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/6Delta9/task-scheduler-codex-plugin/skills/task-planner/SKILL.md · Turn a list of goals, tasks, deadlines, and working constraints into a practical schedule with next actions and…
git:20260403.40685f9 · audit A · 1,501 stars
use-burpsuite-mcp-bridge SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/6jeffr3y/burpsuite-mcp-bridge/skills/use-burpsuite-mcp-bridge/SKILL.md · Operate BurpSuite MCP Bridge for professional, authorized web testing. Use when Codex needs to inspect Burp…
git:20260907.d3020b7 · audit A · 1,501 stars
clueless-blindspots SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/ADanMan/clueless/skills/clueless-blindspots/SKILL.md · Use when the user asks what they are not seeing, what they forgot, what could go wrong, or what an expert would say…
git:20261008.7e29e5a · audit A · 1,501 stars

Every file in hashgraph-online/awesome-codex-plugins

Other files named hexagonal-architecture

hexagonal-architecture SKILL.md skill
rrezartprebreza/spring-boot-skills · skills/spring-boot-3/hexagonal-architecture/SKILL.md · Use when the project follows hexagonal (ports & adapters) architecture. Prevents domain code from depending on Spring…
git:20261017.a317397 · audit A · 338 stars
hexagonal-architecture SKILL.md skill
amey-thakur/ai-skills · skills/architecture/hexagonal-architecture/SKILL.md · Isolate domain logic behind ports it owns while frameworks, databases, and transports live in adapters that plug into…
git:20260718.ea9bc00 · audit A · 13 stars
hexagonal-architecture SKILL.md skill
atnexuslab/tightship · content/skills/hexagonal-architecture/SKILL.md
git:20261015.8e86e2c · audit C · 6 stars

Browse by kind, by grade A, or by owner.