## 개요
Claude Code 훅 기반의 히스토리 기록 및 AI 사용량 추적 시스템을 설정합니다.
## 적용된 훅
| 훅 이벤트 | 스크립트 | 역할 |
|-----------|----------|------|
| `SessionStart` | `session-start.sh` | 세션 시작 시 PROGRESS.md 상태 주입 |
| `UserPromptSubmit` | `session-context.sh` | 매 프롬프트마다 최근 히스토리 파일 목록 주입 |
| `PreToolUse (Edit/Write)` | `protect-files.sh` | `.env`, 영상 파일 등 보호 파일 수정 차단 |
| `PostToolUse (Write)` | `guard-history-fields.sh` | 히스토리 파일 필수 항목 검증 및 차단 |
| `PostToolUse (Bash)` | `progress-reminder.sh` | 빌드/테스트 후 PROGRESS.md 업데이트 리마인더 |
| `PostToolUse (Edit/Write)` | `auto-lint.sh` | TypeScript 파일 수정 후 타입 체크 |
| `Stop` | `guard-history-reminder.sh` | 세션 종료 전 히스토리 파일 미작성 시 차단 |
## 히스토리 파일 규칙
경로: `docs/history/YYYY-MM-DD_{작업명}.md`
필수 항목:
- `**소요 시간**: X분`
- `**Context 사용량**: input Xk / output Xk tokens`
- `**이슈**: #N`
## 완료 기준
- [ ] 히스토리 파일이 `docs/history/`에 올바르게 저장됨
- [ ] 이슈 번호가 히스토리 파일에 연결됨
- [ ] 세션 종료 시 미작성 히스토리 차단 동작 확인
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
개요
Claude Code 훅 기반의 히스토리 기록 및 AI 사용량 추적 시스템을 설정합니다.
적용된 훅
SessionStartsession-start.shUserPromptSubmitsession-context.shPreToolUse (Edit/Write)protect-files.sh.env, 영상 파일 등 보호 파일 수정 차단PostToolUse (Write)guard-history-fields.shPostToolUse (Bash)progress-reminder.shPostToolUse (Edit/Write)auto-lint.shStopguard-history-reminder.sh히스토리 파일 규칙
경로:
docs/history/YYYY-MM-DD_{작업명}.md필수 항목:
**소요 시간**: X분**Context 사용량**: input Xk / output Xk tokens**이슈**: #N완료 기준
docs/history/에 올바르게 저장됨