[harness] Claude Code 하네스 도입 및 프로젝트 맞춤 설정

[LeeSangHyeok0731]

개요 💡

Claude Code 에이전트 팀 하네스(.claude/)를 도입하고, 모든 규칙·스킬·설정을 Washer-Client-v2의 실제 구조와 컨벤션에 맞게 정합화했습니다.

작업내용 ⌨️

하네스 이관

• 기존 .antigravity/(PowerShell 기반)를 .claude/(bash 기반 Claude 하네스)로 교체
• 프로젝트 참조 전면 수정 (EveryGSM → Washer-Client-v2), 툴링을 Prettier/ESLint → Biome/pnpm 스크립트로 전환

실제 코드베이스와 정합화 (전수 감사)

• FSD 레이어를 실제 구조에 맞게 수정: app → widgets → features → entities → shared (views 레이어 제거)
• 존재하지 않는 컨벤션 제거: server fetcher(apiFetcher), Zustand, modal store, 파일 업로드/크롭, index.server.ts
• 실제 패턴 반영: http.ts 헬퍼 + axiosInstance(401 리프레시 인터셉터), useGet*/useUpdate*/useDelete* 훅 네이밍, interface props, 로컬 useState 모달, sonner 토스트
• GitHub 메타 수정: PR base 브랜치 develop → main, 라벨 레퍼런스를 실제 레포 라벨로 재작성, PR 템플릿 구조 반영
• 커밋 스코프 가이드를 Washer 도메인(machine/reservation/report/user/dashboard/auth/admin)으로 교체, 커밋 설명 한국어 규칙 복원

안정화

• 루트 CLAUDE.md 추가 (프로젝트 지시 + 스킬 트리거 포인터)
• hook의 jq 미설치 환경 폴백 처리 (세션 오류 방지)
• .gitattributes로 .sh 파일 LF 강제 (Windows CRLF로 인한 bash 파손 방지)
• .gitignore에 하네스 런타임 산출물 추가 (.claude/command.log, _workspace*/, .pr-tmp/)

검증

• bash -n으로 셸 스크립트 문법 검증 통과, hook jq-미설치 동작 테스트 통과 (exit 0)
• 앱 소스(src/**) 변경 없음 — pnpm lint/pnpm build는 해당 없음

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
washer	Ready	Preview, Comment	Jul 7, 2026 1:46am

[gemini-code-assist]

Code Review

This pull request establishes a comprehensive Claude agent harness for the Washer-Client-v2 repository, introducing specialized agent definitions, path-scoped rules, workflow skills, and pre/post-tool hooks to automate and guide development tasks. The review feedback highlights two key improvement opportunities: first, updating the allowed commands in .claude/settings.json with wildcards and adding missing commands like find and cat to prevent execution blocks; second, implementing a fallback mechanism in get-pr-data.sh for environments where jq is not installed to ensure robust script execution.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.