# Agent Instructions — {{projectName}}

> 이 파일은 Claude Code / Codex / 기타 에이전트 진입점입니다.
> **전체 규칙은 [`CLAUDE.md`](CLAUDE.md) 에 있습니다.** 먼저 그것을 읽으세요.

## 필수 읽기 순서

1. [`CLAUDE.md`](CLAUDE.md) — 프로젝트 규칙 (계층, provider 규약, RAG 파이프라인)
2. [`docs/architecture.md`](docs/architecture.md) — 모듈 설계
3. [`docs/plans/`](docs/plans/) — 진행 중/완료된 플랜

## 핵심 원칙

- **코드보다 하네스부터** — 비자명한 변경은 `docs/plans/NN-*.md` 먼저
- **계층 역방향 의존 금지** — `app/* → service/* → external/* → domain/* → ...`
- **Provider 는 항상 factory 경유** — service 가 `OpenAiLlm` 등 직접 import 금지
- **임베딩 차원 일치** — `EMBEDDING_DIM` env 와 pgvector 컬럼 차원 동기
- **LLM 응답 비결정** — 테스트는 구조 검증, 정확 텍스트 매칭 금지
- **API 키 절대 커밋 금지**
- **Boring Tech** — 새 의존성 추가는 정당화 필요