내가 하는 일
Kotlin · Spring Boot 기반 멀티모듈 백엔드 모노레포(API, 인증 BFF, 배치)를 개발한다. AI는 설계 논의, 구현, 마이그레이션 작성, 커밋 전 리뷰에 쓰고, 최종 판단과 코드 확인은 내가 IDE에서 한다.
작업 방식
- 티켓 단위로 브랜치를 따고, Claude Code가 Jira 티켓을 직접 읽어 요구사항을 정리한 뒤 시작한다.
- 인증 구조 변경이나 외부 시스템 연동처럼 설계가 필요한 일은 바로 코딩하지 않고 브레인스토밍 스킬로 선택지를 먼저 좁힌다.
- 변경 후 모듈별 정적 분석·테스트를 돌리고, 커밋 전에 프로젝트 전용 리뷰 에이전트에게 한국어 리뷰를 받는다.
- 결과 diff는 IntelliJ에서 직접 읽고 고친다.
에이전트 & 하네스
- Claude Code (매일, iTerm): 메인 코딩 에이전트. 기본 모델은 Opus.
- IntelliJ IDEA (매일): 코드 읽기, diff 확인, 직접 수정과 디버깅.
에이전트 커스터마이징
레포 안에 "모델이 혼자 못 하는 것"만 기록하고, 불필요해진 제약은 지운다는 원칙으로 관리한다.
- CLAUDE.md + 모듈별 CLAUDE.md (current): 모듈 구조와 원칙. 해당 디렉터리를 작업할 때 자동으로 로드된다.
- 경로별 rules (current): 코딩 가이드라인, 컨벤션, 품질 게이트, DB 마이그레이션, API 클라이언트 동기화 규칙을 파일 경로에 맞춰 적용한다.
- code-reviewer 에이전트 (current): 컨벤션·품질 게이트·아키텍처 테스트 기준으로 diff를 한국어로 리뷰한다. 코드는 수정하지 않는다.
- new-migration 스킬 (current): Flyway 마이그레이션 번호 채번, 네이밍, Entity·DBML 동기화까지 한 번에 처리한다.
- 커밋 훅 (current):
git commit시 변경된 모듈의 detekt를 자동 실행한다. - 아키텍처 테스트(Konsist) (current): CI에서 레이어·네이밍 컨벤션을 강제해 에이전트 출력도 같은 기준을 통과해야 한다.
스킬 & 플러그인
- superpowers (current): 설계 전 브레인스토밍, 디버깅 같은 프로세스 스킬.
- ponytail (current): 최소 변경·YAGNI 우선으로 과설계를 막는다.
- andrej-karpathy-skills (installed): 가정 명시, 외과적 변경 같은 코딩 행동 가이드라인.
- ECC, claude-md-management, understand-anything (installed): 리뷰·세션 관리, CLAUDE.md 유지보수, 코드베이스 이해용 플러그인.
연결 & 컨텍스트
- Jira (current): 티켓 조회와 요구사항 분석. MCP 서버 대신 REST API를 직접 호출한다.
- Bruno (current): API 컬렉션을 레포에 두고 Controller·DTO 변경 시 함께 동기화한다.
- mysetup (current): 이 페이지 관리.