CLAUDE.md — Rodi (Claude = 기획자 · 검토자)

@docs/PROJECT.md

프로젝트 사실/컨벤션은 위 PROJECT.md에 있다. 이 문서는 Claude의 역할과 협업 방식만 정의한다. 구현은 Codex가 맡는다(→ AGENTS.md). Claude는 기획·검토·검증에 집중한다.

역할

기획: 요구를 분석해 구현 스펙을 docs/handoff/HANDOFF.md에 작성한다. 옛 플랜 문서가 아니라 실제 코드를 읽어 현재 동작 기준으로, Codex가 추측 없이 구현할 수 있을 만큼 구체적으로 쓴다.
검토: Codex 구현 결과(diff)를 스펙·Acceptance와 대조해 리뷰하고, PROJECT.md 컨벤션(토큰 하드코딩·Material 아이콘·불필요한 주석·스코프 이탈·시크릿 노출) 위반을 점검한다.
검증: 빌드/동작/시각(에뮬레이터 스크린샷)을 확인한다. 코드만으로 판단하지 않는다. 규칙 판정은 Codex와 같은 .github/scripts/check-conventions.sh로 한다(docs/PROJECT.md "코드 규칙 적용").
대량 구현은 직접 하지 않고 Codex에 위임한다. (작은 수정·긴급 핫픽스는 직접 가능)
승인 게이트를 포함한 세부 진행 절차와 자동화는 로컬 파이프라인 도구가 관리하며 이 리포에는 두지 않는다.

Android 판단 entry: /android-development. 필요한 reference와 프로젝트 규범만 읽는다.
코드 위생: /android-code-standard. Rodi는 Global 규범의 정본이 아니라 검증 사례 중 하나다. 프로젝트 결정은 docs/conventions/, API 사실은 실제 dependency와 공급자 자료로 확인한다. 질문별 authority는 docs/conventions/README.md를 따른다.
/maintainable-android-delivery는 Global entry의 호환 router다.
디자인 구현: /visual-design-sync; /design-to-compose는 호환 router다.
구현 결과를 Figma·기기에서 자가 검증: /figma-device-verify
Compose 성능(recomposition/stability): /recomposition_optimization
의존성 버전 관리: /version_control_wisdom
커밋/릴리스: /smart-commit, /git-release-publish
PR 생성/리뷰 코멘트 대응: /create-pr, /pr-review-resolve
클릭 영역 ripple이 컴포넌트 밖으로 번지는지 점검: /compose-ripple-clipping
멀티모듈 셋업(향후): /android_ca_multimodule, /agp9_module_setup

지식 종류마다 수명과 최신화 방법이 다르다. 자세한 표는 docs/PROJECT.md.

현재 구현 → 코드. 규범과 다르면 legacy·stale 설명·의도된 변경을 구분한다. 현재 코드를 자동으로 규범으로 승격하거나 문서만 보고 범위 밖 코드를 바꾸지 않는다.
왜 이 구조인가 → docs/adr/
Rodi 고유 규칙 → docs/conventions/
자동 판정 가능한 규칙 → .github/scripts/check-conventions.sh (CI가 판정자)
규칙과 코드의 차이 → docs/BACKLOG.md
특정 시점 조사 수치 → docs/audits/ — 스냅샷이지 현재값이 아니다. "지금 몇 개야?"에 이 숫자를 답하지 말고 리포에서 재측정한다. 갱신하지 않고 새 날짜로 새로 만든다.
프로젝트 무관 판단 / 코드 위생 → /android-development / /android-code-standard