[CHORE] CLAUDE.md 및 Skills 수정

[chanwonlee]

관련 Issue (필수)

• close [CHORE] CLAUDE.md 및 Skills 수정 #239

주요 변경 사항 (필수)

• CLAUDE.md 슬림화 (653 → 173줄): 상세 도메인 문서를 docs/ 5개 파일로 분리 (seat-hold-architecture, seat-conflict-validation, domain-model, testing-guide, deployment)

• 테스트 컨벤션 일원화: /test skill을 진실의 원천으로 통합, CLAUDE.md는 핵심 금지 사항(@Transactional 금지)만 유지

• 팀 공유 전환: .gitignore에서 CLAUDE.md와 .claude/skills/ 제외. .claude/settings.local.json만 개인용

• superpowers 기반 표준 워크플로우 채택: CLAUDE.md에 brainstorming → writing-plans → TDD → verification → PR 흐름 명시. 별도의 이슈 기반 plan skill은 두지 않고 superpowers:writing-plans로 일원화

• 기존 skill 슬림화/정리

  Skill	Before	After	변경
  /commit	613	177	예시/예외/출력 형식 중복 제거, Co-Authored-By 금지 승격, 라벨 매핑은 /branch 참조
  /branch	245	126	라벨→타입 매핑 단일 소스로 유지
  /pr	137	165	.github/PULL_REQUEST_TEMPLATE.md 우선 사용 + 사용자 검수 단계 추가 (gh pr create 자동 실행 금지)
  /implementation	214	제거	superpowers:writing-plans로 일원화

• 신규 skill 3개 추가

  • /issue — 팀 GitHub Issue 컨벤션([CATEGORY] 제목 + 3섹션 본문 + 라벨)에 맞춘 텍스트 생성 (gh CLI 실행 안 함)
  • /validator — application/validator/ 위치에 @Slf4j @Component @RequiredArgsConstructor + BusinessException + 도메인 ErrorCode 패턴으로 Validator 클래스/메서드 생성
  • /api-doc — {domain}/docs/ 위치에 Controller 시그니처 기반 Swagger {Domain}ControllerDoc 인터페이스 생성

• README에 Claude Code 가이드 섹션 추가: CLAUDE.md, docs/ 상세 문서, 커스텀 skills, superpowers 기반 표준 워크플로우를 하나의 섹션으로 정리해 팀원이 한눈에 파악 가능

리뷰어 참고 사항

• skill 변경은 자바 코드에 영향 없음 (가이드 문서 + 메타데이터만)
• 본 PR 머지 후 새 Claude Code 세션에서 신규 skill 3개(/issue, /validator, /api-doc)가 자동 등록됨 (description 트리거)
• .gitignore 변경으로 팀원 머신의 CLAUDE.md, .claude/skills/, docs/가 git 트래킹 대상으로 전환됨 (개인 권한 설정 .claude/settings.local.json만 ignore 유지)

추가 정보

9개 commit을 작업 성격별로 분리

PR 작성 체크리스트 (필수)

• 제목이 Issue와 동일함을 확인했습니다.

[Ogu1208]

확인했습니다!!
전체 관련 문서와 REAEME까지 엄청 꼼꼼하게 작성해주신 것 같아요! 한번 잘 사용하면서 디벨롭 해보면 너무 좋을 것 같습니다 ㅎㅎ
hook이나 의존성을 사용해서 PR 올리기 전에 해당 브랜치에서 AI 관련 문서 업데이트 체크 task도 수행하도록 고려해보면 좋을 것 같아요!!
고생하셨습니다!! 👍👍