Git/GitHub 워크플로우
Foundation에서 권장하는 Git/GitHub 사용 방법입니다.
📝 초안 (Draft)
이 문서는 검토 중입니다. 내용이 변경될 수 있습니다.
개요
AI 협업 개발에 최적화된 Git 워크플로우를 소개합니다.
브랜치 전략
기본 구조
main (또는 master)
│
├── develop # 개발 통합 브랜치
│ │
│ ├── feature/* # 기능 개발
│ ├── fix/* # 버그 수정
│ └── docs/* # 문서 작업
│
└── release/* # 릴리즈 준비
브랜치 명명 규칙
| 접두사 | 용도 | 예시 |
|---|---|---|
feature/ | 새 기능 | feature/user-auth |
fix/ | 버그 수정 | fix/login-error |
docs/ | 문서 작업 | docs/api-reference |
refactor/ | 리팩토링 | refactor/database-layer |
커밋 컨벤션
Conventional Commits
<type>(<scope>): <description>
[optional body]
[optional footer(s)]
커밋 타입
| 타입 | 설명 |
|---|---|
feat | 새 기능 |
fix | 버그 수정 |
docs | 문서 변경 |
style | 코드 스타일 (포맷팅) |
refactor | 리팩토링 |
test | 테스트 추가/수정 |
chore | 빌드, 설정 변경 |
예시
feat(auth): add JWT token refresh endpoint
fix(api): resolve null pointer in user service
docs(readme): update installation instructions
AI 협업 커밋
Claude Code와 커밋
Claude Code가 커밋을 생성할 때 자동으로 Co-Author가 추가됩니다:
feat(auth): implement password reset flow
- Add password reset request endpoint
- Create email notification service
- Add reset token validation
Co-Authored-By: Claude <[email protected]>
커밋 워크플로우
# 1. 변경사항 확인
git status
git diff
# 2. AI에게 커밋 요청
"변경사항을 커밋해줘"
# 3. AI가 자동으로:
# - 변경사항 분석
# - 적절한 커밋 메시지 생성
# - 커밋 실행
Pull Request 가이드
PR 템플릿
## Summary
<1-3 bullet points>
## Test plan
- [ ] Unit tests added
- [ ] Manual testing completed
🤖 Generated with [Claude Code](https://claude.com/claude-code)
PR 생성 (AI 지원)
# AI에게 PR 생성 요청
"PR을 생성해줘"
# AI가 자동으로:
# - 브랜치 확인
# - 변경사항 분석
# - PR 제목/본문 생성
# - gh pr create 실행
Git 설정
권장 설정
# 사용자 정보
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
# 기본 브랜치
git config --global init.defaultBranch main
# 자동 줄바꿈 설정
git config --global core.autocrlf input # Linux/Mac
git config --global core.autocrlf true # Windows
.gitignore 기본
# 환경 설정
.env
.env.local
# 의존성
node_modules/
vendor/
# 빌드 결과물
/build
/dist
# IDE
.idea/
.vscode/
# OS
.DS_Store
Thumbs.db