ci(repo): main 브랜치 기준 통일

품질 gate의 push 대상을 main으로 전환하고, 기본 브랜치 전환 결정을 ADR로 기록했습니다.

Author: dev-wooyeon

.github/workflows/quality.yml

@@ -4,7 +4,7 @@ on:
   pull_request:
   push:
     branches:
-      - master
+      - main
 
 concurrency:
   group: quality-${{ github.workflow }}-${{ github.ref }}

docs/README.md

@@ -1,6 +1,6 @@
 # 문서 인덱스
 
-Last updated: 2026-07-20
+Last updated: 2026-07-22
 
 이 인덱스는 현재 코드베이스와 함께 유지해야 하는 문서만 추적한다. 계속
 업데이트할 문서가 아니라면 삭제하거나, 오래 남겨야 하는 결정만 ADR로 옮긴다.
@@ -44,6 +44,7 @@ Last updated: 2026-07-20
 - `docs/adr/0043-include-one-evidence-backed-personal-project-in-resume.md`
 - `docs/adr/0044-link-direct-project-retrospectives-from-resume.md`
 - `docs/adr/0045-use-team-context-in-resume-company-column.md`
+- `docs/adr/0046-use-main-as-the-primary-branch.md`
 - `docs/blog-quality-guide.md`
 - `docs/content-publication-candidates.md`
 - `docs/database/db-schema.md`

docs/adr/0046-use-main-as-the-primary-branch.md

@@ -0,0 +1,32 @@
+# 0046. 저장소의 주 브랜치를 main으로 통일한다
+
+Date: 2026-07-22
+Status: Accepted
+
+## 배경
+
+원격 기본 브랜치는 `master`였고 로컬 `main`은 `origin/master`를 추적했다.
+이 상태에서는 브랜치 이름과 CI push 대상이 달라 새 작업의 기준을 혼동하기 쉽다.
+
+## 결정
+
+- GitHub 기본 브랜치와 `origin/HEAD`를 `main`으로 전환한다.
+- 로컬 `main`은 `origin/main`을 추적한다.
+- 품질 gate는 pull request와 `main` push에서 실행한다.
+- 기존 `master`는 외부 참조를 확인하는 전환 기간 동안 유지한다.
+
+## 결과
+
+- 새 작업, CI, 원격 기본 브랜치가 모두 `main`을 기준으로 한다.
+- `master`를 즉시 삭제하지 않아 기존 clone, 링크, 자동화의 중단을 피한다.
+- 전환 기간이 끝나면 참조를 확인한 뒤 `master` 제거 여부를 별도로 결정한다.
+
+## 검토한 대안
+
+- `master`를 계속 사용: 현 상태를 유지하지만 로컬 `main`과의 혼동을 남긴다.
+- 로컬 브랜치만 이름 변경: 원격 기본 브랜치와 CI 대상이 달라 문제가 지속된다.
+- `master`를 즉시 삭제: 정리는 빠르지만 남은 외부 참조를 즉시 깨뜨릴 수 있다.
+
+## Related History
+
+- `9d7c0a9`: 품질 gate를 GitHub Actions에 추가

docs/adr/README.md

@@ -1,6 +1,6 @@
 # Architecture Decision Records
 
-Last updated: 2026-07-20
+Last updated: 2026-07-22
 
 이 디렉터리는 커밋 히스토리에서 복원한 아키텍처 의사결정을 기록한다.
 ADR은 AI 협업 가이드와 별개의 문서다. 사람이 결정했든 AI가 초안을
@@ -63,6 +63,7 @@ ADR은 AI 협업 가이드와 별개의 문서다. 사람이 결정했든 AI가
 | [0043](0043-include-one-evidence-backed-personal-project-in-resume.md)               | Accepted   | Resume에는 증거가 있는 개인 프로젝트 하나만 제공한다         |
 | [0044](0044-link-direct-project-retrospectives-from-resume.md)                        | Accepted   | Resume 프로젝트에는 직접 대응하는 회고글만 연결한다          |
 | [0045](0045-use-team-context-in-resume-company-column.md)                             | Accepted   | Resume 회사 열에는 팀 맥락만 표시한다                        |
+| [0046](0046-use-main-as-the-primary-branch.md)                                        | Accepted   | 저장소의 주 브랜치를 main으로 통일한다                      |
 
 ## 작성 조건