Whiplash-Server

이 저장소에서 신규 기능 개발, 기존 기능 리팩토링, 버그 수정, API 변경, 도메인 정책 변경을 수행할 때 설계 문서화, Red-Green-Refactor 테스트 작성, 구현, 관련 테스트와 전체 테스트 검증, 배포/PR 확인까지 자연스럽게 이어가도록 사용하는 워크플로우 스킬이다.

이 저장소에서 브랜치 변경 내역을 바탕으로 프로젝트 PR 본문 형식에 맞춰 요약, 상세 작업 내용, 참고사항을 작성할 때 사용한다.

이 저장소에서 변경 내용을 바탕으로 프로젝트 커밋 메시지 규칙에 맞는 커밋 메시지를 만들거나, staged 변경을 확인해 적절한 Type과 제목을 정리할 때 사용한다.

이 저장소에서 큰 기능 설계나 정책 변경을 시작하기 전에 AGENTS.md, CONTEXT.md, docs/adr, docs/history, 실제 코드를 근거로 요구사항을 질문하고 도메인 용어와 아키텍처 결정 및 작업 이력을 문서화할 때 사용한다.

이 저장소에서 신규 기능 개발, 기능 수정, PRD 작성, API 변경, 스케줄러/Redis/FCM/외부 API 연동 작업을 할 때 latency, availability, error rate 관점의 SLO 영향을 점검하고 필요한 metric, 테스트, 운영 확인 항목을 정리할 때 사용한다.

이 저장소에서 기능 요청, 정책 변경, API 변경, 앱 요구사항을 docs/history/{0001}-{기능명-slug}/PLAN.md 형식의 PRD 또는 구현 계획으로 정리할 때 사용한다.

이 저장소에서 controller, service, repository, Redis, integration 테스트를 작성하거나 수정할 때 사용한다. TDD red-green-refactor 흐름, 어노테이션 선택, fixture 사용, nested 테스트 구조, DisplayName 규칙, 현재 코드베이스의 테스트 패턴을 다룬다.

이 저장소에서 Spring Boot, JPA, Redis, Firebase FCM, 인증/인가, 테스트 실패, 운영성 버그를 재현하고 원인 분석부터 최소 수정 및 회귀 테스트까지 진행할 때 사용한다.

사용자가 "grill me", "나한테 질문해줘", "요구사항을 같이 명확히 하자", "계획을 검증해줘"라고 하거나, 계획/설계/기능 아이디어를 AI와 대화하며 같은 이해에 도달할 때까지 집요하게 인터뷰해야 할 때 사용한다.

이 저장소에서 진행 중인 작업, 설계 결정, 변경 파일, 테스트 상태, 남은 TODO를 다음 작업자나 다음 세션에 넘길 인수인계 문서로 정리할 때 사용한다.

이 저장소에서 전체 코드베이스 또는 특정 도메인의 구조 개선 후보를 탐색하고, 레이어 의존, 트랜잭션 경계, DTO/mapper 위치, 도메인 분리 개선안을 제안할 때 사용한다.

이 저장소에서 성능, 메모리, N+1, 트랜잭션 범위, Redis 사용, 스트림/컬렉션 효율, 시간/공간 복잡도를 리뷰할 때 사용한다.

이 저장소에서 PRD, PLAN.md, 기능 설계를 GitHub 이슈 초안으로 분해하고 domain, controller, service, test, migration 단위 TODO로 정리할 때 사용한다.

이 저장소에서 특정 도메인, 클래스, API, 흐름이 전체 아키텍처에서 어떤 역할을 하는지 설명하고 레이어 의존, 도메인 연결, 리스크를 요약할 때 사용한다.

프로젝트 테스트 작성 시 어노테이션 선택, Fixture 활용, FCM 주의사항 안내. "테스트 작성해줘", "단위 테스트", "통합 테스트", "@WebMvcTest", "Mock 테스트" 요청 시 반드시 참고.

이 저장소에서 작성된 테스트 코드가 프로젝트 컨벤션을 지키는지 리뷰할 때 사용한다. nested 구조, success/fail 네이밍, DisplayName, BDD 주석, 어노테이션 선택, fixture 사용을 점검한다.

Whiplash 프로젝트 실행 커맨드, 스프링 프로파일, 인프라 의존성, Claude Code 문서 조회 안내. "어떻게 실행해", "프로파일", "Docker", "인프라", "Claude Code 문서" 요청 시 참고.

이 저장소에서 프로젝트 실행 방법, Spring profile 선택, 인프라 의존성, Redis/FCM 연동 위치, local과 비운영 환경 차이를 설명할 때 사용한다.

이 저장소에서 새 도메인을 만들거나, 기존 도메인에 entity, repository, service, use case, mapper, DTO, exception, controller를 추가 또는 확장할 때 사용한다. 저장소의 레이어 구조와 네이밍 규칙을 따른다.

이 저장소에서 ErrorCode enum을 추가/수정하거나, 예외 발생 로직, controller 에러 선언, validation과 에러 매핑을 다룰 때 사용한다. 프로젝트의 HttpStatus 및 ErrorCode 규칙을 맞춘다.

이 저장소에서 아키텍처, 레이어 의존, 메서드 네이밍, ErrorCode 형식, DTO 규칙, CustomErrorCodes 선언, 트랜잭션 경계를 리뷰할 때 사용한다.

이 저장소에서 보안 취약점(SQL Injection, XSS, 시크릿 하드코딩, 명령어 인젝션, 입력 검증, 인증/인가, 민감 데이터 로깅, 오류 정보 노출)을 리뷰할 때 사용한다.

Whiplash 프로젝트에서 새 도메인 생성, 레이어 추가(Entity/Repository/Service/UseCase/Controller) 시 사용. "도메인 만들어줘", "레이어 추가해줘", "UseCase 만들어줘", "Service 구현해줘", "Controller 추가해줘" 요청 시 반드시 참고.

Whiplash 프로젝트에서 ErrorCode 추가, 예외 발생 코드 작성 시 사용. "에러코드 추가해줘", "예외 처리해줘", "ErrorCode 만들어줘", "예외 던져줘" 요청 시 반드시 참고.