클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

클린 아키텍처 리뷰어

의존성 규칙을 기준으로 코드 계층·경계·SOLID를 점검하고 구체적인 개선안을 제시하는 아키텍처 설계 스킬.

개발·코딩중급★ 1,984⑂ 198AI 점수 7/10마지막 업데이트: 2026. 8. 10.

무엇을 해주나

  • 의존성 규칙 검사: 소스 의존성이 프레임워크 → 유스케이스 → 엔티티 방향(안쪽)으로만 향하는지 점검하고, 위반 지점과 의존성 역전 방법을 알려줍니다.
  • 계층 배치 판단: 특정 코드가 엔티티/유스케이스/인터페이스 어댑터/프레임워크 중 어디에 속해야 하는지 결정해 줍니다.
  • 7개 항목 진단 + 점수화: "DB 없이 비즈니스 규칙을 테스트할 수 있는가", "컴포넌트 그래프에 순환이 없는가" 등 7개 질문으로 0~10점 밴드를 산출하고 실패한 항목마다 수정안을 제시합니다.
  • 컴포넌트 원칙과 SOLID: REP/CCP/CRP/ADP/SDP/SAP와 SRP·OCP·LSP·ISP·DIP를 코드 예시와 함께 적용합니다.
  • 흔한 실수 카탈로그: ORM이 도메인에 새어 들어오는 문제, 컨트롤러 안의 비즈니스 로직, 프레임워크 우선 설계, 분산 모놀리스 등을 짚어줍니다.

이런 분께 추천

  • 신규 서비스의 폴더 구조와 모듈 경계를 처음 잡는 백엔드/풀스택 개발자
  • 프레임워크·ORM에 강하게 묶인 레거시를 단계적으로 분리하려는 팀
  • 코드 리뷰에서 "이 로직은 어느 계층에 있어야 하나"를 자주 논쟁하는 테크리드
  • 헥사고날(포트&어댑터), 어니언 아키텍처를 실제 코드로 옮기고 싶은 분

활용 예시

  1. "컨트롤러에 결제 로직이 다 들어있어. 유스케이스로 어떻게 뽑아낼까?" → PlaceOrderInteractor와 입력/출력 포트 설계, 컨트롤러는 변환·위임만 하도록 리팩터링 계획 제시.
  2. "우리 프로젝트 아키텍처를 점검해줘" → 7개 진단 질문으로 채점하고, 실패 항목(예: 리포지토리 인터페이스 부재, 순환 의존성)별 수정 순서 제안.
  3. "Postgres에서 다른 저장소로 갈아탈 수 있게 만들고 싶어" → 유스케이스가 정의하는 OrderRepository 인터페이스와 어댑터 계층의 SqlOrderRepository 분리 설계.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/wondelai/skills/HEAD/clean-architecture/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 wondelai/skills 의 clean-architecture 폴더를 내 ~/.claude/skills/clean-architecture/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/wondelai/skills.git /tmp/wondelai-skills && mkdir -p ~/.claude/skills && cp -r /tmp/wondelai-skills/clean-architecture ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 스킬 저장소를 내려받습니다: git clone https://github.com/wondelai/skills.git
  3. Claude Code 스킬 폴더가 없다면 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬 폴더만 복사합니다(참고 문서 references/가 함께 복사되도록 폴더 단위로 복사하세요): cp -r skills/clean-architecture ~/.claude/skills/
  5. ls ~/.claude/skills/clean-architecture 로 SKILL.md와 references/가 있는지 확인합니다.
  6. Claude Code를 다시 실행한 뒤 "이 프로젝트의 아키텍처 계층을 클린 아키텍처 기준으로 점검해줘"처럼 요청하면 스킬이 자동으로 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT