히스토리 및 AI 사용량 추적 시스템 설정 #1

Open
opened 2026-04-07 11:45:58 +09:00 by kimminsung · 0 comments
Owner

개요

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/에 올바르게 저장됨
  • 이슈 번호가 히스토리 파일에 연결됨
  • 세션 종료 시 미작성 히스토리 차단 동작 확인
## 개요 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/`에 올바르게 저장됨 - [ ] 이슈 번호가 히스토리 파일에 연결됨 - [ ] 세션 종료 시 미작성 히스토리 차단 동작 확인
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kimminsung/recordingtest#1