diff --git a/README.md b/README.md
index 58269ed..ba10518 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,13 @@
 # workhistory
 
+작업 이력과 메모를 기록하는 개인 저장소.
+
+## 목적
+- Claude Code 세션에서 수행한 작업 로그 보관
+- 프로젝트 전반에 걸친 짧은 메모 / 실험용 스크래치
+- `.claude/` 훅(Aptabase 토큰 기록 등) 구성 테스트베드
+
+## 구조
+- `.claude/hooks/` — Aptabase 커밋 기준 토큰 기록 훅
+- `.claude/state/` — 훅 누적 상태 (자동 생성)
+- `memory/` — 장기 메모리 저장소