# CLAUDE.md — documan 프로젝트 규칙

## 작업 히스토리 기록 규칙

모든 작업 세션이 끝나면 반드시 히스토리 파일을 작성해야 한다.

### 기록 위치
```
docs/history/YYYY-MM-DD_{작업명}.md
```

### 필수 포함 항목 (누락 시 저장 차단됨)
```markdown
**소요 시간**: X분
**Context 사용량**: input Xk / output Xk tokens
```

### 선택 포함 항목
```markdown
**이슈**: #N
```
- 작업이 특정 Gitea 이슈와 연관된 경우 이슈 번호를 기재
- 나중에 이슈별 토큰 사용량 집계에 활용됨

### 히스토리 파일 작성 기준
- 사용자 요청이 완료된 직후, 응답 마지막 단계에서 작성
- 작업명은 핵심 내용을 한국어로 간결하게 (예: `2026-03-31_PDF2단변환기능추가.md`)
- 변경한 파일 목록, 주요 결정사항, 발생한 문제와 해결 방법 포함

### 히스토리 파일 템플릿
```markdown
**이슈**: #N
**소요 시간**: X분
**Context 사용량**: input Xk / output Xk tokens

## 작업 내용
{작업 요약}

## 변경 파일
- `파일경로` : 변경 내용

## 주요 결정사항
{설계 판단, 선택한 이유}

## 문제 및 해결
{발생한 문제와 해결 방법}
```