Claude Code CLAUDE.md

Work Logs

작업 내용 및 의사결정 기록은 /mnt/c/Users/USER/OneDrive/Documents/logs/<프로젝트명>/` 에 보관.

• 저장 경로: CWD의 마지막 디렉토리명을 프로젝트명으로 사용
  • 예: CWD = /mnt/c/work/kweb → 저장 위치 = /mnt/c/Users/USER/OneDrive/Documents/logs/kweb/
• 네이밍: YYYYMMDD-<짧은-주제-kebab-case>.md
• 인덱스: <저장 경로>/INDEX.md — 모든 로그 요약 및 상태 확인
• 새 대화 시작 시 인덱스를 참조해 최근 컨텍스트 파악 가능

로그 파일은 Obsidian 문서로 작성한다. obsidian:obsidian-markdown 스킬을 참고해 아래 형식을 따른다:

---
date: YYYY-MM-DD
tags:
  - kweb
  - <작업-유형>   # e.g. implementation, debugging, planning
status: active   # active | done | blocked
---

# 제목

## 배경

## 작업 내용

## 결정 사항

## 다음 단계

• 관련 파일은 [[wikilink]] 대신 코드블록(`경로`)으로 표기 (vault 외부 파일이므로)
• 중요 사항은 > [!note] / > [!warning] 콜아웃 활용

이어쓰기 규칙

동일 이슈나 작업을 다른 날 이어서 진행할 때는 새 파일을 만들지 않고 기존 파일에 추가한다.

• 기존 파일의 ## 다음 단계 아래에 날짜 구분 헤딩을 추가:

## 작업 내용 — 2026-04-10

(이날 진행한 내용)

## 다음 단계

• frontmatter의 date는 최초 작성일 유지 (파일명과 일치)
• 작업이 완료되면 frontmatter의 status를 done으로 변경

컨텍스트 파악

• 과거 작업 내용, 확실치 않은 맥락(context), 도메인 배경지식은 qmd mcp 를 사용해 컨텍스트를 파악할 수 있다.
• qmd 사용법: https://github.com/tobi/qmd/blob/main/CLAUDE.md

빌드

java version 설정 (PowerShell)

echo $env:JAVA_HOME

$env:JAVA_HOME = "C:\Users\USER\.jdks\temurin-1.8.0_402"
$env:JAVA_HOME = "C:\Users\USER\.jdks\temurin-17.0.13"
$env:JAVA_HOME = "C:\Users\USER\.jdks\temurin-25.0.1"

$env:PATH = "${env:JAVA_HOME}\bin;${env:PATH}"

build, test 예시

• build 예시

mvn clean package -D"maven.test.skip"="true"

• test 예시

mvn clean test-compile
mvn test -D"test"="DateSectionBuilderTest" 
mvn test -D"test"="DateSectionBuilderTest" -pl collmake
mvn scalatest:test -D"suites"="com.repository.updater.log.*"