# Claude Code 설정

## 신규 컴퓨터 셋업

클론 후 아래 명령을 한 번 실행하면 (1) Claude 메모리 연결 + (2) git 훅 활성화 가 끝납니다.

```bash
PROJ=$(pwd)
MEM_DIR="$HOME/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-front"
mkdir -p "$MEM_DIR"
rm -rf "$MEM_DIR/memory"
ln -s "$PROJ/.claude/memory" "$MEM_DIR/memory"

# git hooks (post-commit: 커밋 로그 + [TBD-CODE] 자동 치환 + .commit-notice 마커)
git config core.hooksPath .githooks
```

> **주의**: 위 경로(`-Users-cha-Works-Projects-qcast3-qcast-front`)는 이 프로젝트의 절대경로 인코딩입니다.
> 프로젝트를 `/Users/cha/Works/Projects/qcast3/qcast-front` 에 clone 했을 때 그대로 사용하면 됩니다.

## git hooks (`.githooks/`)

`.githooks/` 는 git 으로 추적되는 훅 디렉토리입니다. `git config core.hooksPath .githooks` 가 한 번 설정되면 자동 실행됩니다.

- `post-commit` — 커밋 로그 append, `[TBD-CODE]` placeholder 를 새 short hash 로 자동 치환, `.claude/.commit-notice` 마커 작성 (Claude 의 UserPromptSubmit hook 이 다음 프롬프트에 컨텍스트로 주입)

## 메모리 구조

`.claude/memory/` 폴더가 Claude 의 프로젝트 메모리입니다. git 으로 관리됩니다.

- `MEMORY.md` — 메모리 인덱스 (항상 로드됨)
- `feedback_*.md` — 작업 방식 피드백
- `project_*.md` — 프로젝트 상태 및 결정 사항
- `reference_*.md` — 외부 시스템 참조

## 인수인계서

`docs/` 폴더의 `*_HANDOVER.md` 파일들을 참고하세요.

- `docs/HANDOVER_INDEX.md` — 진입점 인덱스 (먼저 읽기)
- `docs/SK_MOVEMENT_HANDOVER.md` — SK 라인 이동 (최우선)
- `docs/UI_MODAL_HANDOVER.md` — 모달/UI
- `docs/API_STABILITY_HANDOVER.md` — API 안정화
- `docs/MODULE_CIRCUIT_HANDOVER.md` — 모듈/회로

## 로컬 개발

```bash
npm run dev              # 기본 (dev API)
npm run dev:local-api    # localhost:8080 API
npm run dev:log          # 기본 + 서버 로그 파일
npm run dev:log:local-api # localhost:8080 + 서버 로그 파일
```