qcast-front/CLAUDE.md

Claude Code 설정

신규 컴퓨터 셋업

클론 후 아래 명령을 한 번 실행하면 Claude 메모리가 이 프로젝트 폴더와 연결됩니다.

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"

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

메모리 구조

.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 — 모듈/회로

로컬 개발

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 + 서버 로그 파일