Skip to content

chore(repo): main/develop 브랜치 전략 도입 및 문서 재구조화 - #9

Merged
MinsungIM merged 2 commits into
mainfrom
chore/branch-strategy-bootstrap
May 27, 2026
Merged

MinsungIM merged 2 commits into
mainfrom
chore/branch-strategy-bootstrap

Conversation

@MinsungIM

Copy link
Copy Markdown
Contributor

변경 사항

  • main/develop 2브랜치 전략 도입 + CI 게이트(pr-build.yml)
  • main→develop 흡수: sync-develop.yml(매일 자동) + scripts/sync-develop.sh(로컬 수동)
  • 문서 재구조화: CLAUDE.md 허브화(297→82줄) + dev-docs/ 신설(codebase·i18n·notion-sync) + 중복 제거
  • CONTRIBUTING.md·README.md 현행화

동기·맥락

  • main 단독 운영에서 2인 동시 기능개발에 대응. 콘텐츠(Notion 자동 동기화)와 코드 작업을 분리.
  • 문서 중복(브랜치 다이어그램·i18n 3중)·표류(README 구 스캐폴딩) 정리.

검증

  • npm run build 통과 (양쪽 로케일, 경고 0)
  • 문서 링크·앵커 팩트체크 (소스 대조, 깨진 링크 1건 수정)
  • 머지 후: develop 브랜치 생성 + 보호 규칙(PR 필수 + pr-build 통과) 활성화

관련

부트스트랩 PR — 머지 후 `feature/* → develop → main` 플로우 시작

🤖 Generated with Claude Code

- pr-build.yml: main·develop PR 빌드 게이트
- sync-develop.yml + scripts/sync-develop.sh: main→develop 콘텐츠 흡수(자동/수동)
- CLAUDE.md: 허브화(문서 인덱스+핵심 함정+브랜치 요약), 297→82줄
- dev-docs/ 신설: codebase·i18n·notion-sync (CLAUDE 상세 분리)
- CONTRIBUTING.md: 브랜치·한글 파일명·blog·i18n·CI 충돌 정정
- README.md: 구 스캐폴딩 잔재 제거, 현행 구조로 재작성
- 문서 중복 제거(브랜치 다이어그램·i18n 단일 출처화) 및 링크 정합성 정정

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@MinsungIM
MinsungIM marked this pull request as draft May 26, 2026 08:26
전수 팩트체크에서 드러난 '실재하지 않는 파일 참조·정책 불일치'를
바로잡고, CONTRIBUTING을 'Notion=콘텐츠 / GitHub=코드' 이원 경로로
전면 재작성한다.

CONTRIBUTING.md (10개 섹션으로 재편):
- §1 두 기여 경로 신설 — 콘텐츠는 Notion DB, 코드는 develop 플로우
- §2 콘텐츠를 Notion 작성 기준으로 재서술; frontmatter 자동 4개
  (id/title/sidebar_position/slug)·부모 index.md 3개로 정정
  (기존 "5개·description 포함" 오류), 수동 추가는 예외로 명시
- §4 외부 OSS 기여 로깅을 Notion contribute DB로 정정
  (없는 docs/contribute/overview.md 참조 제거)
- §5 릴리즈 노트를 Notion release DB 기준으로 재작성
  (수동 v0.1.0.md·sidebar_position 갱신 룰 → 자동 정렬)
- §6 블로그 규칙은 참고용으로 본문 보존(비활성 명시)
- §8 셀프 리뷰 정책 유지, 체크리스트의 비활성 blog 게이트 제거
- i18n entry point(intro/about/overview)·/about 등 없는 파일 참조 제거

anchor 동반 수정(루트 .md라 onBrokenLinks가 잡지 않아 github-slugger로
슬러그 검증): README·CLAUDE·dev-docs/codebase의 브랜치 링크 §6 → §7

빌드(KR+EN) 통과.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@MinsungIM
MinsungIM marked this pull request as ready for review May 27, 2026 01:39
@MinsungIM
MinsungIM merged commit 468ec58 into main May 27, 2026
1 check passed
@sungbin1015
sungbin1015 deleted the chore/branch-strategy-bootstrap branch May 28, 2026 04:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant