hexagonal-architecture
개발백엔드rrezartprebreza/spring-boot-skills
Spring Boot 프로젝트를 헥사고날(포트와 어댑터) 구조로 나누는 방법을 안내합니다. 도메인 모델과 포트 인터페이스는 프레임워크 없이 순수 자바로 두고, 애플리케이션 계층의 유스케이스 구현과 JPA·웹 어댑터를 분리해 작성하도록 돕습니다. 도메인에 JPA나 Spring 의존성이 섞이지 않게 하는 규칙과 함께, 도메인 객체에 동작을 담는 설계 기준을 제시합니다.
이럴 때 쓰세요 프로젝트가 domain, application, infrastructure 패키지로 나뉘어 있어 도메인 코드에 JPA 어노테이션이 섞이지 않게 정리해야 할 때
설치 전에 확인하세요
GitHub 기록
- 저장소 스타
- 339
- 저장소 업데이트
- 2026.11.04
- 라이선스
- MIT
- SKILL.md 경로
- skills/spring-boot-3/hexagonal-architecture/SKILL.md
- 스크립트 파일
- 있음
AI가 SKILL.md를 읽고 판단
- 코드 실행
- 확인되지 않음
- 네트워크 접속
- 확인되지 않음
- 계정·API 키
- 확인되지 않음
- 난이도
- 고급
- 직군
- 개발자
확인되지 않음은 AI가 SKILL.md에서 찾지 못했다는 뜻입니다. 없다는 보장은 아닙니다.
설치
터미널에 붙여 넣어 실행하세요. macOS와 Linux 기준이며 git이 필요합니다. Windows에서는 PowerShell이 아니라 Git Bash에서 실행하세요. 저장소를 임시로 내려받아 스킬 폴더만 복사합니다.
모든 프로젝트에서 쓰기
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p "$HOME/.claude/skills"/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. "$HOME/.claude/skills"/hexagonal-architecture/
rm -rf "$tmp"현재 프로젝트에서만 쓰기
먼저 터미널에서 프로젝트 폴더로 이동하세요.
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p .claude/skills/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. .claude/skills/hexagonal-architecture/
rm -rf "$tmp"설치한 뒤 Claude Code에서 새 세션을 시작하세요. '이럴 때 쓰세요'에 적힌 일을 요청하면 에이전트가 스킬을 불러옵니다. 스킬은 ~/.claude/skills/hexagonal-architecture에 있습니다. 프로젝트에 설치했다면 .claude/skills/hexagonal-architecture에 있습니다.
모든 프로젝트에서 쓰기
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p "$HOME/.agents/skills"/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. "$HOME/.agents/skills"/hexagonal-architecture/
rm -rf "$tmp"현재 프로젝트에서만 쓰기
먼저 터미널에서 프로젝트 폴더로 이동하세요.
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p .agents/skills/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. .agents/skills/hexagonal-architecture/
rm -rf "$tmp"설치한 뒤 Codex에서 새 세션을 시작하세요. '이럴 때 쓰세요'에 적힌 일을 요청하면 에이전트가 스킬을 불러옵니다. 스킬은 ~/.agents/skills/hexagonal-architecture에 있습니다. 프로젝트에 설치했다면 .agents/skills/hexagonal-architecture에 있습니다.
모든 프로젝트에서 쓰기
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p "$HOME/.cursor/skills"/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. "$HOME/.cursor/skills"/hexagonal-architecture/
rm -rf "$tmp"현재 프로젝트에서만 쓰기
먼저 터미널에서 프로젝트 폴더로 이동하세요.
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git "$tmp"
mkdir -p .cursor/skills/hexagonal-architecture
cp -R "$tmp"/skills/spring-boot-3/hexagonal-architecture/. .cursor/skills/hexagonal-architecture/
rm -rf "$tmp"설치한 뒤 Cursor에서 새 세션을 시작하세요. '이럴 때 쓰세요'에 적힌 일을 요청하면 에이전트가 스킬을 불러옵니다. 스킬은 ~/.cursor/skills/hexagonal-architecture에 있습니다. 프로젝트에 설치했다면 .cursor/skills/hexagonal-architecture에 있습니다.
같은 분류의 스킬
-
개발
REA 분석 도구와 공유 워크플로에서 불필요한 작업을 찾아 줄이는 최적화 절차를 안내합니다. 병목 원인을 측정하고 올바른 소유 지점에서 고친 뒤, 같은 작업을 완료했을 때 결과와 근거가 동일한지 확인하는 방법을 제시합니다. 측정이 필요 없는 단순 정리 작업과 CI 테스트 최적화는 다루지 않습니다.
분석 도구의 응답이 느리거나 메모리를 많이 쓸 때 원인을 찾고 캐시나 조회 구조를 바꿔야 할 때
-
개발
지금 하려는 일을 설명하면 이 저장소의 어떤 스킬이나 작업 흐름이 맞는지 안내하는 라우터입니다. 아이디어를 구현까지 이어지는 기본 흐름과 버그 대응, 코드베이스 정리, 팀 간 전달 같은 갈래를 함께 보여 주어 다음에 호출할 스킬을 정하는 데 도움을 줍니다. 단계마다 대화 컨텍스트를 정리하거나 새 세션으로 넘기는 기준도 알려 줍니다.
아이디어를 실제 코드로 만들려는데 어떤 스킬을 어떤 순서로 써야 할지 모를 때
-
개발
LLM이 코드를 짤 때 자주 하는 실수를 줄이도록 에이전트의 작업 방식을 정해 줍니다. 구현 전에 가정을 밝히고 해석이 갈리면 질문하며, 요청에 필요한 최소한의 코드만 쓰고 관련 없는 부분은 건드리지 않습니다. 또 작업마다 확인 가능한 성공 기준과 단계별 검증 계획을 세워 그 기준을 통과할 때까지 진행하도록 돕습니다.
코드를 새로 쓰거나 리뷰, 리팩터링할 때 과한 구현과 엉뚱한 수정을 피하고 싶을 때
-
개발
지정한 기준점 이후의 변경분을 두 축으로 검토합니다. 하나는 저장소에 문서화된 코딩 표준을 따르는지, 다른 하나는 연결된 이슈나 명세가 요구한 내용을 제대로 구현했는지입니다. 두 검토를 병렬로 진행한 뒤 결과를 나란히 보여 주며, 두 축의 지적을 합쳐 순위를 매기지 않습니다.
브랜치나 PR, 작업 중인 변경을 기준 커밋 이후로 표준 준수와 명세 일치 두 관점에서 점검하고 싶을 때