[기능] fix: 비개발자 작업 브랜치 접두사를 work/로 변경

[wlrnjs]

Pull Request

PR 종류

• 기능 개발
• 테스트 코드

관련 이슈

• close #이슈번호

작업 내용

• 비개발자가 Claude로 작업을 시작할 때 실행하는 new-preview-worktree.sh가 항상 실패하던 문제를 고쳤습니다.
• 원인은 브랜치 이름 충돌입니다. git은 preview 브랜치가 있으면 preview/<이름> 브랜치를 만들 수 없고, 기본 브랜치가 preview라서 저장소를 받은 모든 사람에게 이 브랜치가 있습니다. 원격에도 preview가 있어 같은 이름으로는 push도 거부됩니다.
• 작업 브랜치 접두사를 work/로 바꾸고, 같은 접두사를 쓰는 세 곳을 함께 고쳤습니다.
  • .claude/scripts/new-preview-worktree.sh: work/<작업-이름> 브랜치를 만듭니다.
  • .claude/hooks/guard-preview-branch.mjs: work/로 시작하는 워크트리에서만 수정, 커밋, push를 허용합니다. 접두사는 BRANCH_PREFIX 상수 하나로 모았습니다.
  • CLAUDE.md: 절대 규칙 2번의 브랜치 설명을 work/로 바꿨습니다.

참고 사항

• 고친 스크립트로 실제 워크트리를 만들어 work/prefix-smoke-test 브랜치가 생기는 것을 확인했습니다.
• 훅은 FI_ADMIN_DEVELOPER를 끈 상태로 실행해 확인했습니다.
  • 통과: work/ 워크트리 안에서 파일 수정, 커밋, push
  • 차단: 다른 브랜치 워크트리, 메인 워킹 디렉토리, preview로의 push, 훅 파일 수정
  • 확인 뒤 테스트 워크트리와 브랜치는 지웠습니다.
• 스크립트 파일 이름은 origin/preview를 바탕으로 만든다는 뜻이라 그대로 두었습니다.
• auto-label.yml의 접두사 매핑에 work가 없어 비개발자 PR에는 라벨이 붙지 않습니다. 기존 preview도 매핑에 없었으므로 이번 변경으로 달라지는 점은 아니며, 필요하면 별도로 추가해야 합니다.

체크리스트

• 기능이 정상 동작하는지 확인
• 로컬 빌드/테스트 통과
• 불필요한 코드/주석 제거

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
admin	Ready	Preview	Oct 4, 2026 9:38am UTC