AgentSkillsCN

go-project-layout

在新建 Go 项目或调整项目结构时，采用 Clean Architecture 的文件夹组织方式。

SKILL.md
--- frontmatter
name: go-project-layout
description: Go 프로젝트를 새로 생성하거나 구조를 변경할 때 clean architecture 폴더 구조를 적용합니다.
user-invocable: true
model: haiku
allowed-tools: Read, Grep, Glob

참조 프로젝트 구조

아래는 이 프로젝트에서 사용하는 clean architecture 레이아웃입니다. 새 Go 프로젝트를 생성할 때 이 구조를 따르세요.

!tree project-layout/go-clean-arch-v2 -I vendor -L 3

레이어별 역할

cmd/

  • •애플리케이션 진입점 (main.go)
  • •DI 컨테이너 설정, 서버 시작

domain/

  • •핵심 비즈니스 엔티티 (struct)
  • •리포지토리/유스케이스 인터페이스 정의
  • •에러 타입 정의 (errors.go)
  • •mock 파일은 domain/mocks/에 위치

{도메인명}/ (예: article/, author/)

  • •handler.go: HTTP 핸들러 (Echo 라우팅)
  • •usecase.go: 비즈니스 로직 구현
  • •repository.go: 데이터 접근 구현
  • •*_test.go: 각 파일의 테스트

pkg/

  • •config/: Viper 기반 설정 관리
  • •database/: DB 연결 설정
  • •middleware/: CORS, 인증 등 공통 미들웨어

의존성 방향

code
cmd/ → {도메인}/ → domain/
         ↓
        pkg/
  • •domain 패키지는 외부 의존성 없음 (순수 Go)
  • •도메인별 패키지는 domain 인터페이스를 구현
  • •cmd/는 모든 패키지를 조립하는 역할