cc-kit

main 최신화 → 작업 브랜치 생성 → 커밋/푸시 → main 머지 → main 최신화 전체 플로우 자동 실행. staged 변경사항으로 커밋 메시지 생성 후 커밋.

작업 완료 후 검증 → 커밋 → PR 생성까지 전체 플로우 수행.

Claude Code 초기 환경 설정 (terminal-notifier 설치 및 훅 권한 설정)

cc-kit을 현재 프로젝트에 설치합니다. 프로젝트 기술 스택을 입력받아 맞춤형 CLAUDE.md와 .claude/ 설정을 생성합니다.

작업 시작. Plan Mode 진입 → 코드 분석 → 작업 계획 생성.

단위 → 통합 → E2E 테스트를 순서대로 실행. "테스트 전체 실행", "전체 테스트", "/test" 입력 시 사용.

cc-kit 플러그인 파일을 최신 버전으로 업데이트합니다. CLAUDE.md와 커스텀 파일은 건드리지 않습니다.

계획 기반 구현. .claude/plans/에서 계획 읽기 → 구현 → 계획 대비 검증.

코드 품질, 규칙 준수, 보안, 유지보수성 검토. git diff 기반 변경사항 집중 분석.

코드베이스 빠른 탐색 전문가. 파일/코드 패턴 검색, 구현 위치 파악.

git 상태 확인, 스테이징, 커밋, 로그/브랜치 관리. 프로젝트 커밋 규칙 준수.

tsc/eslint 오류 수정. 간단한 오류는 즉시 수정.

Next.js 16 + React 19.2 코드 레벨 진단 전문가. 주니어/미들/시니어 패턴 판별 + 다음 레벨 로드맵 제시. code-level-review 루브릭 기반.

버그 분석 및 수정. "버그", "오류", "에러", "동작 안함", "왜 안되지", 에러 메시지/스택트레이스가 제공될 때 반드시 이 스킬을 활성화. 2-3가지 해결 옵션 제시 후 구현.

Next.js + React 코드 작성 시 시니어 기준 컨벤션 적용 및 레벨 진단. "코드 리뷰해줘", "이 패턴 맞아?", "더 좋은 방법", "시니어 패턴으로", "nextjs 컨벤션", "이 코드 수준이 어때?", "주니어 패턴", "미들 수준" 등이 언급될 때 반드시 사용. 코드 작성 시에는 시니어 기준 패턴을 기본으로 적용하고, 코드 리뷰 요청 시에는 레벨(주니어/미들/시니어)을 진단하고 개선 포인트를 제시한다.

린트, 포맷, 타입 체크 실행 및 자동 수정. "린트", "포맷", "타입체크", "code quality" 입력 시 사용.

staged 변경사항 기준 커밋 메시지 자동 생성. 프리픽스(type)만 영어, 제목/Body는 한글로 작성.

React/Next.js 단일 컴포넌트 또는 훅을 신규 생성. 기존 프로젝트 패턴(스타일링 방식, export 형태, props 타입 위치)을 분석하여 일관된 보일러플레이트 생성. "컴포넌트 만들어", "새 컴포넌트", "훅 만들어", "페이지 추가" 가 언급될 때 사용. 단, service+query+view를 함께 만드는 도메인 전체 스캐폴딩이나 "어디에 파일 만들어야 해?" 같은 폴더 구조 질문은 nextjs-scaffold를 사용.

프로젝트를 분석하고 도구 우선순위에 맞는 루트 지시문(CLAUDE.md 또는 AGENTS.md)을 생성/업데이트합니다. "루트 지시문 생성", "CLAUDE.md 만들어줘", "AGENTS.md 업데이트", "프로젝트 규칙 파일 만들어줘" 같은 요청에 반드시 사용하세요. 모노레포 자동 감지 및 워크스페이스별 중첩 파일 생성 지원.

AI 코딩 도구 문서 작성. CLAUDE.md, AGENTS.md, SKILL.md, COMMAND.md, rules/*.md 작성/수정 요청 시 이 스킬을 활성화. 새 프로젝트 세팅, 스킬/커맨드 신규 작성, 규칙 추가 모두 포함.

라이브러리 버전 업그레이드 및 패턴 마이그레이션. "업그레이드", "마이그레이션", "v4→v5", "Pages Router→App Router", "의존성 업데이트" 언급 시 이 스킬을 활성화. 영향 파일 분석 후 단계적 실행.

Next.js 프로젝트에서 여러 레이어를 아우르는 도메인 전체를 스캐폴딩하거나, 파일 위치/폴더 구조를 안내할 때 사용. 단일 컴포넌트·훅 생성은 component-creator를 사용. 이 스킬은 다음 상황에만 사용: "전체 도메인 추가" (service + query 훅 + view 한 번에), "API 서비스 파일 만들어" / "BaseServices 상속" / "서비스 클래스", "TanStack Query 훅 구조" / "queryKeys 분리" / "useQuery 어디에 만들어", "views 폴더 구조" / "어디에 파일 만들어야 해?" / "폴더 구조 어떻게?", "view + hook 분리 패턴" / "도메인 스캐폴딩" / "모노레포 구조". CLAUDE.md 없는 새 프로젝트나 문서가 부족한 프로젝트에서 특히 유용하다.

PR 리뷰 코멘트 분석 및 대응. "리뷰 반영", "코멘트 처리", "리뷰어 피드백", PR 번호/URL이 제공될 때 이 스킬을 활성화. 수용/거절/질문으로 분류 후 수용 항목 자동 구현.

코드 리팩토링 분석 및 실행. "리팩토링", "구조 개선", "중복 제거", "분리", "정리", "클린업"이 언급될 때 이 스킬을 활성화. 정책 보호 테스트 포함.

Playwright 기반 E2E(End-to-End) 테스트 생성. "e2e 테스트", "playwright", "end-to-end", "사용자 시나리오 테스트", "브라우저 테스트", "전체 흐름 테스트" 언급 시 반드시 이 스킬을 활성화. async Server Component, 미들웨어, 인증 플로우 등 단위/통합 테스트로 커버 불가한 영역 담당.

Route Handler, Server Actions 통합 테스트 생성. "통합 테스트", "API 테스트", "Route Handler 테스트", "Server Action 테스트", "integration test" 언급 시 반드시 이 스킬을 활성화. node 환경, BDD(Given-When-Then) 방식.

컴포넌트/함수/훅 단위 테스트 생성. "단위 테스트", "유닛 테스트", "테스트 작성", "테스트 추가", "커버리지 올려", "테스트 없는 파일", "unit test" 언급 시 반드시 이 스킬을 활성화. BDD(Given-When-Then) 방식, 정책 케이스 포함.

2025-2026 트렌드를 반영한 웹/앱 UI를 Next.js + TailwindCSS + shadcn/ui로 구현하는 전문 디자인 스킬. 페이지, 컴포넌트, 사이트, 랜딩페이지, 대시보드, 앱 화면 등 시각적 UI 관련 작업이라면 반드시 이 스킬을 사용할 것. "만들어줘", "디자인해줘", "구현해줘", "예쁘게", "트렌디하게", "화면 만들어줘" 같은 요청 포함. Next.js, TailwindCSS, shadcn/ui가 언급되거나 웹/앱 UI를 다루는 상황 전반에 적용.

3 hooks across 3 events