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

.github/workflows/pr-build.yml

@@ -0,0 +1,37 @@
+name: PR Build Check
+
+# main·develop 으로 향하는 모든 PR에서 프로덕션 빌드를 강제한다.
+# onBrokenLinks: 'throw' 이므로 깨진 내부 링크·MDX 오류가 여기서 차단된다.
+# (배포는 하지 않는다 — 배포는 main push 시 deploy.yml 이 담당)
+#
+# ⚠️ 이 파일만으로는 머지 게이트가 되지 않는다. GitHub
+#    Settings → Branches → Branch protection rules 에서 main·develop 에
+#    "Require status checks to pass" 로 이 체크를 required 로 추가해야 강제된다.
+on:
+  pull_request:
+    branches: [main, develop]
+
+# 같은 PR에 새 푸시가 오면 진행 중인 빌드는 취소하고 최신 1개만 유지
+concurrency:
+  group: pr-build-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build (all locales)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build (production, all locales)
+        run: npm run build

.github/workflows/sync-develop.yml

@@ -0,0 +1,33 @@
+name: Sync main → develop
+
+# 서버 crontab(2분 주기 Notion 동기화)이 main 에 쌓는 콘텐츠
+# (docs/ · docs_en/ · static/img/)를 develop 으로 정기 흡수한다.
+# develop 이 오래된 문서를 들고 있지 않도록 유지하는 역방향 흐름.
+#
+# 충돌이 나면 job 이 실패한다 = 알림. 자동 우회(-X ours/theirs 등)는
+# 쓰지 않는다 — 콘텐츠 손실을 막기 위해 수동 개입을 강제한다.
+on:
+  schedule:
+    - cron: '0 18 * * *'   # 매일 UTC 18:00 = KST 03:00
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout develop (full history)
+        uses: actions/checkout@v4
+        with:
+          ref: develop
+          fetch-depth: 0
+
+      - name: Merge main into develop
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git fetch origin main
+          git merge origin/main --no-edit
+          git push origin develop