🧭 저장소 사용법

📁 폴더 / 파일 규칙

studies/week-XX/<깃허브ID>/<문제번호>-<문제이름>.md

새 주차가 필요하면 templates/WEEK_TEMPLATE.md를 복사해 studies/week-XX/README.md로 저장하고, docs/PROBLEM_BANK.md에서 문제 4개를 골라 배정하세요.

저장소 루트에서 커밋 템플릿 등록: git config commit.template .gitmessage
브랜치 예시: week01/DevJunz
PR 생성 — 제목은 [W01] DevJunz - SWEA 4문제 형태
- 가능하면 문제를 푼 날(월~목)에 맞춰 그날그날 PR을 올려주세요. 하루에 하나씩 쌓이면 리뷰어가 미리 나눠서 볼 수 있어 편합니다.
- 다만 놓친 날이 있어도 괜찮습니다 — 나중에 몰아서 한 번에 제출해도 됩니다.
PR을 열면 GitHub Actions가 자동으로 리뷰어 1명을 배정합니다 (아래 설명 참고).
금요일까지 배정받은 PR에 리뷰를 남깁니다.

.github/workflows/auto-assign-reviewer.yml이 pull_request: opened 이벤트에 반응합니다.

워크플로우에 하드코딩된 멤버 배열(DevJunz, yeseoLee, Suyoung-Min, clarityth, min9u)에서 PR 작성자의 위치를 찾습니다.
현재 날짜의 ISO 주차 번호를 오프셋으로 사용해 (작성자 위치 + 1 + 주차 번호) % 멤버 수 로 리뷰어를 계산합니다.
계산된 리뷰어를 GitHub PR 리뷰어로 자동 요청합니다.
주차가 바뀌면 오프셋이 바뀌므로 매주 리뷰어 짝이 자동으로 순환합니다. 자기 자신은 절대 배정되지 않도록 안전장치가 들어있습니다.

멤버가 추가/탈퇴하면 워크플로우 파일의 members 배열만 수정하면 됩니다. 별도의 상태 파일이나 수동 개입이 필요 없습니다.

루트 README.md의 "이번 주 문제" 섹션은 사람이 손으로 바꾸지 않습니다.

.github/workflows/update-current-week.yml이 매주 월요일 00:00(KST) 에 실행됩니다.
scripts/update-current-week.js가 오늘 날짜로 몇 주차인지 계산하고, docs/PROBLEM_BANK.md에서 그 주차(배정 주차 열)에 해당하는 문제를 찾아 README를 갱신·커밋·푸시합니다.
해당 주차 문제가 아직 PROBLEM_BANK.md에 배정되지 않았다면 "아직 배정되지 않았습니다" 안내로 대체됩니다.
Actions 탭에서 Update Current Week 워크플로우를 수동 실행(workflow_dispatch)할 수도 있습니다.
README의  ~  사이는 자동 생성 영역이므로 직접 수정해도 다음 실행 때 덮어써집니다.

매주 리뷰가 끝나면 studies/README.md의 체크표를 갱신합니다.