Name: go-standard
Author: ggombee

Go 표준 라이브러리 컨벤션

프로젝트 구조

cmd/
└── server/
    └── main.go      # 진입점
internal/            # 외부 노출 불가 패키지
├── handler/         # HTTP 핸들러
├── service/         # 비즈니스 로직
├── repository/      # 데이터 접근 레이어
└── model/           # 도메인 모델
pkg/                 # 외부 공유 가능 패키지
go.mod
go.sum

네이밍 규칙

패키지명: 소문자 단어 (예: handler, repository)
파일명: snake_case.go
exported: PascalCase, unexported: camelCase
인터페이스: 동작 기반 이름 (예: UserStore, Notifier)
에러 변수: Err 접두사 (예: ErrNotFound)

에러 처리

fmt.Errorf("...: %w", err) 로 에러 래핑
errors.Is / errors.As 로 타입 확인
핸들러에서만 HTTP 상태로 변환, 내부 레이어는 순수 에러 반환
sentinel 에러는 패키지 레벨에 var ErrXxx = errors.New(...) 정의

테스트

testing 표준 패키지 + testify/assert 조합
인터페이스 기반 mock (mockery 또는 수동 mock)
테이블 기반 테스트(t.Run) 적극 활용
통합 테스트는 _integration_test.go 파일로 분리, -tags integration 빌드 태그 사용

go-standard

Como adicionar

Cole no README do seu repo

Skills relacionadas

claude-api

skill-creator

claude-code-plugin-release

claude-mem

Receba novas skills de Desenvolvimento toda segunda

Go 표준 라이브러리 컨벤션

프로젝트 구조

네이밍 규칙

에러 처리

테스트