🔧 :: Claude Code 하네스 구성 (CLAUDE.md·설정·훅·스킬) #311

Describe

Claude Code로 작업할 때 매번 프로젝트 구조·컨벤션을 다시 파악하고, 검증·이슈·PR 절차를 수동으로 챙기지 않도록 에이전트 하네스를 구성합니다.

• 기존 AGENTS.md는 domain/, pages/, repository 계층 등 실제 코드와 다른 구조를 설명하고 있어 에이전트가 잘못된 위치에 코드를 만들 수 있음
• 이슈/브랜치/커밋/PR 컨벤션(type/#번호-slug, 이모지 :: 설명 (#번호), develop 기준)이 에이전트용으로 정리되어 있지 않음
• FVM(fvm flutter ...), 코드 생성(build_runner), .env.* 준비 등 CI와 동일한 검증 절차가 자동화되어 있지 않음
• 반복 명령마다 권한 확인이 뜨고, 시크릿 파일 보호 장치가 없음

계획

• CLAUDE.md: 실제 lib/ 구조 기준 아키텍처·오류 처리(AppException + guardApiCall)·코드 생성·Git 컨벤션 정리
• .claude/settings.json: 자주 쓰는 읽기·검증 명령(fvm flutter analyze/test, git, gh) 권한 허용, .env.* 등 시크릿 파일 접근 차단
• 훅: Dart 파일 수정 후 dart format 자동 적용 등 검증 자동화
• 스킬: 이슈 생성 → 브랜치 생성, PR 생성 등 팀 컨벤션 워크플로를 .claude/skills로 정리 (기존 .agents/skills/pr 이관)
• AGENTS.md 정리 (CLAUDE.md와 내용 일치 또는 참조로 대체)

Additional

• 개인 설정은 .claude/settings.local.json으로 분리하고 저장소에는 팀 공용 설정만 커밋합니다.