📄 [Docs] PR Assignee·라벨 지정 규칙 명문화 (#1267)

[JEONG-J]

🔗 관련 이슈

Closes #1267

✨ PR 유형

문서 작업. PR 생성 시 Assignee·라벨 지정을 규칙으로 명문화합니다. 코드 변경 없음.

📷 스크린샷 or 영상(UI 변경 시)

해당 없음 (문서 전용).

🛠️ 작업내용

문제

최근 PR 10건 중 3건이 Assignee·라벨 없이 등록됐습니다.

PR	라벨	Assignee
#1266 · #1264 · #1262	:page_facing_up: Docs	JEONG-J
#1260	❌ 없음	❌ 없음
#1259	❌ 없음	❌ 없음
#1258	:wrench: chore	JEONG-J
#1257	❌ 없음	❌ 없음
#1256 · #1255 · #1254	Bug / UI / Refactor	JEONG-J

라벨이 없으면 보드·라벨 필터에서 PR이 새어나가고, Assignee가 없으면 담당자 추적이 끊깁니다.

원인

규칙이 버전 관리되는 문서에 없었습니다.

• 로컬 create-pr 스킬(.claude/skills/create-pr/SKILL.md §7)에는 --assignee "@me" + --label 규칙이 이미 있었습니다.
• 그런데 .claude/ 는 .gitignore:119 에 걸려 있어 팀에 공유되지 않습니다. 게다가 그 스킬을 거치지 않고 gh pr create 를 직접 쓰면 규칙이 적용되지 않습니다.
• 정작 팀이 공유하는 docs/claude/git-workflow.md 의 「PR 규칙」에는 Approve·Squash·attribution 금지만 있고 Assignee·라벨 항목이 없었습니다.

변경

1. docs/claude/git-workflow.md 「PR 규칙」 — 첫 항목으로 추가

• Assignee 기본값 @me, 타인 지정(--assignee <github-login>), 복수 지정(콤마)
• 라벨은 제목의 [Type] 에 대응하는 값 — 같은 문서의 기존 「PR 제목 형식」 표 라벨 열을 재사용하므로 매핑을 새로 만들지 않았습니다
• 복수 라벨은 --label 반복
• 라벨명은 gh label list 출력과 정확히 일치해야 하며, 틀리면 gh pr create 자체가 실패한다는 점 명시
• 누락 시 보정: gh pr edit <번호> --add-assignee "@me" --add-label "..."

2. gh pr create 예시 코드 블록에 플래그 반영

기존 예시가 --title + --body-file 만 보여줘서 그대로 복사하면 규칙을 어기게 돼 있었습니다. 실제로 복사해 쓰는 명령이라 여기가 핵심입니다.

3. CLAUDE.md 절대 규칙 #10에 한 줄

허브 파일만 읽고 작업할 때도 걸리도록.

📋 추후 진행 상황

• 강제하려면 GitHub Actions 로 "PR에 라벨·Assignee 없으면 실패" 체크를 붙이는 방법이 있습니다. 다만 문서 규칙으로 충분한지 한 사이클 지켜본 뒤 판단하는 게 낫다고 봅니다 — 지금 바로 CI를 늘릴 만한 빈도는 아닙니다.
• 과거 누락 3건(✨ [Feat] 명함 신규 화면 — 인앱 QR 스캐너 · 받은 명함 상세 · 편집 · 링크 보안 (#1224) #1260·🐛 [Fix] 명함첩 데이터 정합 — 계정 격리 · 삭제 키 · 빈 프로필 · 카운트 (#1217) #1259·🔧 [Chore] 명함 테스트 공백 보강 — 에코 방지 · 타이브레이크 · 레인징 · 프라이버시 (#1240) #1257)은 이미 머지돼 소급 보정 실익이 없어 손대지 않았습니다. 필요하면 gh pr edit 으로 붙일 수 있습니다.

📌 리뷰 포인트

1. 이 PR 자체가 규칙 준수 예시입니다 — --assignee "@me" --label ":page_facing_up: Docs" 로 생성했습니다.
2. .claude/ gitignore 유지 여부 — 이번 건의 근본 원인은 "규칙이 gitignore된 곳에만 있었다"는 점입니다. 같은 사고가 과거 docs/superpowers/ 에서도 있었고요(CLAUDE.md에 기록됨). 스킬 자체를 버전 관리로 옮길지는 범위가 커서 이 PR에 넣지 않았습니다 — 별도 논의가 필요하면 이슈로 분리하겠습니다.
3. 라벨 매핑을 새로 만들지 않고 기존 표를 참조하게 한 선택이 괜찮은지 (중복 정의를 피했지만 한 번 더 스크롤해야 합니다).

✅ Checklist

• 커밋 메시지 컨벤션에 맞게 작성했습니다
• 유지-보수를 위해 주석처리를 잘 작성하였는가?
  • 문서 PR이라 코드 주석은 해당 없음. 규칙에 "왜"(보드 누락·담당자 추적 끊김)를 함께 적어 나중에 규칙만 보고도 이유를 알 수 있게 했습니다.