메뉴
TypeScript, Java, Kotlin, Go 서비스 전반에서 명확한 도메인 경계, 의존성 역전 및 테스트 가능한 유스케이스 오케스트레이션을 갖춘 포트 및 어댑터(Ports & Adapters) 시스템을 설계, 구현 및 리팩터링합니다.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/SAM42-Lab/everything-claude-code-kr --skill hexagonal-architecture명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
캡처, 진단, 억제된 복구 및 인트로스펙션 보고서를 사용하여 AI 에이전트 실패에 대한 구조화된 셀프 디버깅 워크플로우를 수행합니다.
기술, 명령어, 규칙, 훅 및 기타 요소를 DAILY 대 LIBRARY 버킷으로 분류하여 특정 저장소에 대한 증거 기반의 ECC 설치 계획을 수립합니다. 전체 번들을 로드하는 대신 프로젝트에 실제로 필요한 것만 ECC를 트리밍해야 할 때 사용하세요.
리소스 명명, 상태 코드, 페이지네이션, 필터링, 에러 응답, 버전 관리 및 프로덕션 API를 위한 속도 제한을 포함한 REST API 설계 패턴.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | hexagonal-architecture |
| description | TypeScript, Java, Kotlin, Go 서비스 전반에서 명확한 도메인 경계, 의존성 역전 및 테스트 가능한 유스케이스 오케스트레이션을 갖춘 포트 및 어댑터(Ports & Adapters) 시스템을 설계, 구현 및 리팩터링합니다. |
| origin | ECC |
헥사고날 아키텍처(포트 및 어댑터)는 비즈니스 로직을 프레임워크, 전송 방식, 지속성 세부 사항으로부터 독립적으로 유지합니다. 핵심 애플리케이션은 추상적인 포트에 의존하고, 어댑터는 가장자리에서 이러한 포트를 구현합니다.
요청에 경계 설정, 도메인 중심 설계, 밀접하게 결합된 서비스 리팩터링 또는 특정 라이브러리로부터 애플리케이션 로직 분리가 포함된 경우 이 스킬을 사용하십시오.
아웃바운드 포트 인터페이스는 일반적으로 애플리케이션 계층에 위치하며(추상화가 진정으로 도메인 수준인 경우에만 도메인에 위치), 인프라 어댑터는 이를 구현합니다.
의존성 방향은 항상 내부를 향합니다:
명확한 입력 및 출력 DTO를 사용하여 단일 유스케이스를 정의합니다. 전송 세부 사항(Express req, GraphQL context, 작업 페이로드 래퍼)을 이 경계 외부에 둡니다.
모든 부수 효과를 포트로 식별합니다:
UserRepositoryPort)BillingGatewayPort)LoggerPort, ClockPort)포트는 기술이 아니라 기능을 모델링해야 합니다.
유스케이스 클래스/함수는 생성자/인수를 통해 포트를 받습니다. 애플리케이션 수준의 불변성을 검증하고, 도메인 규칙을 조정하며, 평범한 데이터 구조를 반환합니다.
어댑터를 인스턴스화한 다음 유스케이스에 주입합니다. 숨겨진 서비스 로케이터 동작을 피하기 위해 이 배선을 중앙 집중화합니다.
flowchart LR
Client["클라이언트 (HTTP/CLI/Worker)"] --> InboundAdapter["인바운드 어댑터"]
InboundAdapter -->|"호출"| UseCase["유스케이스 (애플리케이션 계층)"]
UseCase -->|"사용"| OutboundPort["아웃바운드 포트 (인터페이스)"]
OutboundAdapter["아웃바운드 어댑터"] -->|"구현"| OutboundPort
OutboundAdapter --> ExternalSystem["DB/API/큐"]
UseCase --> DomainModel["도메인 모델"]
명확한 경계가 있는 기능 우선 조직을 사용하십시오:
src/
features/
orders/
domain/
Order.ts
OrderPolicy.ts
application/
ports/
inbound/
CreateOrder.ts
outbound/
OrderRepositoryPort.ts
PaymentGatewayPort.ts
use-cases/
CreateOrderUseCase.ts
adapters/
inbound/
http/
createOrderRoute.ts
outbound/
postgres/
PostgresOrderRepository.ts
stripe/
StripePaymentGateway.ts
composition/
ordersContainer.ts
export interface OrderRepositoryPort {
save(order: Order): Promise<void>;
findById(orderId: string): Promise<Order | null>;
}
export interface PaymentGatewayPort {
authorize(input: { orderId: string; amountCents: number }): Promise<{ authorizationId: string }>;
}
type CreateOrderInput = {
orderId: string;
amountCents: number;
};
type CreateOrderOutput = {
orderId: string;
authorizationId: string;
};
export class CreateOrderUseCase {
constructor(
private readonly orderRepository: OrderRepositoryPort,
private readonly paymentGateway: PaymentGatewayPort
) {}
async execute(input: CreateOrderInput): Promise<CreateOrderOutput> {
const order = Order.create({ id: input.orderId, amountCents: input.amountCents });
const auth = await this.paymentGateway.authorize({
orderId: order.id,
amountCents: order.amountCents,
});
// markAuthorized는 새로운 Order 인스턴스를 반환하며, 기존 인스턴스를 직접 수정하지 않습니다.
const authorizedOrder = order.markAuthorized(auth.);
..(authorizedOrder);
{
: order.,
: auth.,
};
}
}
export class PostgresOrderRepository implements OrderRepositoryPort {
constructor(private readonly db: SqlClient) {}
async save(order: Order): Promise<void> {
await this.db.query(
"insert into orders (id, amount_cents, status, authorization_id) values ($1, $2, $3, $4)",
[order.id, order.amountCents, order.status, order.authorizationId]
);
}
async findById(orderId: string): Promise<Order | null> {
const row = await this.db.oneOrNone("select * from orders where id = $1", [orderId]);
return row ? Order.rehydrate(row) : null;
}
}
export const buildCreateOrderUseCase = (deps: { db: SqlClient; stripe: StripeClient }) => {
const orderRepository = new PostgresOrderRepository(deps.db);
const paymentGateway = new StripePaymentGateway(deps.stripe);
return new CreateOrderUseCase(orderRepository, paymentGateway);
};
에코시스템 전반에서 동일한 경계 규칙을 사용하십시오. 구문과 연결 스타일만 변경됩니다.
application/ports/* (인터페이스/타입으로 정의).adapters/inbound/*, adapters/outbound/*.domain, application.port.in, application.port.out, application.usecase, adapter.in, adapter.out.application.port.*에 위치한 인터페이스.@Service는 선택 사항이며 필수는 아님).domain, application.port, application.usecase, adapter).internal/<feature>/domain, application, ports, adapters/inbound, adapters/outbound.New... 생성자가 있는 구조체.cmd/<app>/main.go (또는 전용 배선 패키지)에서 연결하고 생성자를 명시적으로 유지하십시오.req, res 또는 큐 메타데이터를 직접 읽는 경우.