Hierarchy · layer별로 무엇을 담는가

글로벌

~/.claude/CLAUDE.md

코딩 철학 · 언어 선호 · 일반 행동

- 응답은 한국어 격식체.
- 구현 전 가정 명시,
  모호하면 질문 먼저.
- 단순함 우선. 요청
  안 한 추상화 금지.
- 본인이 만든 잔해
  외엔 건드리지 말 것.

프로젝트 루트

project/CLAUDE.md

도메인 · 아키텍처 · 컨벤션 · 명령

## 개요
B2B SaaS, Next.js
+ Supabase, multi-tenant.
## 명령
- 테스트: pnpm test
- 마이그레이션: db:migrate
## 컨벤션
- API는 lib/api/ wrapper만.
- 새 라우트는 zod schema.

하위 디렉토리

project/backend/CLAUDE.md

그 영역에만 적용되는 특수 규칙

- 모든 endpoint는
  tenant_id 격리 확인.
- DB 트랜잭션은
  lib/db/with-tx 헬퍼만.
- 외부 API 호출 시
  retry + circuit
  breaker 필수.