fixture-monkey CLAUDE.md

Fixture Monkey - Claude Code 가이드

절대 규칙

• 기존 테스트는 삭제/수정/주석 처리 금지
• 테스트 실패 시 바로 롤백 (개선 가능하다고 판단되면 사용자에게 롤백 여부 확인)
• Adapter 작업 시 fixture-monkey, fixture-monkey-api 모듈 코드 수정 금지 (필요 시 사용자에게 확인)
• 커밋은 사용자가 명시적으로 요청할 때만 (메시지는 영어)
• 데드 코드는 제거한다
• [작업 흐름] 을 보고 작업을 한다

프로젝트 구조

모듈/폴더	역할
fixture-monkey/	메인 모듈 (ArbitraryBuilder, FixtureMonkey 등)
fixture-monkey-api/	공용 API 인터페이스
object-farm-api/	JvmNodeTree, PathExpression 등 구조 관련 API
fixture-monkey-tests/	통합 테스트
history/	벤치마크 결과 + 작업 히스토리
guide/	프로파일링 가이드 등 참고 문서

빌드 및 테스트

./gradlew build                        # 전체 빌드
./gradlew :fixture-monkey:test         # 특정 모듈 테스트
./gradlew :fixture-monkey:test --tests "com.navercorp.fixturemonkey.test.FixtureMonkeyAdapterTest"

Adapter 작업 시 회귀 테스트:

./gradlew clean \
  :fixture-monkey:test --tests "com.navercorp.fixturemonkey.adapter.*" \
  :fixture-monkey-tests:java-tests:test --tests "com.navercorp.fixturemonkey.tests.java.adapter.*" \
  :fixture-monkey-tests:java-17-tests:test --tests "com.navercorp.fixturemonkey.tests.java17.adapter.*" \
  :fixture-monkey-tests:kotlin-tests:test --tests "com.navercorp.fixturemonkey.tests.kotlin.adapter.*"

코드 스타일

• 탭 들여쓰기 (스페이스 아님)
• 주석은 // given, // when, // then만 허용 (예외 시 사용자 확인)
• Javadoc은 public API에만 작성
• @API 어노테이션으로 API 안정성 표시 (EXPERIMENTAL, MAINTAINED 등)

디버깅 절차

테스트 실패 시 아래 순서를 따른다:

1. 코드 분석 우선 - 코드를 읽고 원인 추론
2. 런타임 확인 - 분석만으로 부족하면 디버그 로그 추가 후 --info 플래그로 실행
3. 문제 격리 - 반복 실패 시 최소 재현 테스트 작성 (sample() → adapt → 특정 Phase 순으로 좁힘)
4. 수정 및 검증 - 원인 부분만 수정, 기존 테스트 전체 통과 확인

tracer 활성화:

FixtureMonkey fm = FixtureMonkey.builder()
    .plugin(new JavaNodeTreeAdapterPlugin()
        .tracer(AdapterTracer.console()))
    .build();

테스트 케이스 관리

테스트 작성/발견 시 해당 경우의 수가 기존 테스트에서 커버하지 못하는 새로운 경우의 수라고 판단되면:

1. test-case/ 폴더의 해당 카테고리 마크다운 파일에 경우의 수를 추가
2. 카테고리가 없으면 새 마크다운 파일 생성
3. 각 경우의 수는 원자적 단위(하나의 독립된 동작/조건)로 기록
4. 타입 변형(String→Int, List→Set→Array)은 같은 경우의 수로 취급 — 동작이 다른 경우만 별도