my-history-insight

과거 Claude Code 세션 기록에서 패턴을 찾아 인사이트를 추출한다. "일기장을 꺼내서 이번 달 돌아보기"와 같은 역할.

Execution Flow

┌─────────────────────────────────────────────┐
│  Step 1. 세션 파일 탐색                        │
│  ~/.claude/projects/ 에서 .jsonl 파일 목록     │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 2. 사용자 메시지만 추출                  │
│  (전체의 ~6% — 나머지 94%는 부속 자료)         │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 3. 병렬 분석 (3개 에이전트 동시)         │
│  ┌──────────────┬──────────────┐             │
│  │session-      │pattern-      │             │
│  │summarizer   │finder        │             │
│  ├──────────────┴──────────────┤             │
│  │growth-tracker               │             │
│  └─────────────────────────────┘             │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 4. 인사이트 리포트 출력                  │
└─────────────────────────────────────────────┘

Step 1: 세션 파일 탐색

현재 프로젝트의 세션 파일 목록을 확인한다.

위치: ~/.claude/projects/ 하위 폴더
파일 형식: UUID 형태의 .jsonl 파일
subagents/ 폴더 안의 파일은 제외 (서브에이전트 기록)
파일 수와 전체 크기를 파악해서 분석 범위 결정

파일이 너무 많으면 (20개 이상) 최근 10개만 분석한다.

Step 2: 사용자 메시지 추출

각 .jsonl 파일에서 실제 대화 내용만 추출한다.

jsonl 파일의 각 줄은 JSON 객체
"role":"user" 인 항목의 content만 추출
tool_use, tool_result, system 메시지는 모두 제외
추출된 텍스트로 세션의 주제를 파악

핵심: 세션 파일의 ~94%는 파일 변경 이력, 도구 실행 로그 등 부속 자료. 실제 사용자 대화는 ~6%뿐이므로 이것만 추출해서 빠르게 분석한다.

Step 3: 병렬 분석 (3개 에이전트 동시 실행)

추출한 대화 내용을 3개 에이전트가 동시에 분석한다.

Agent 1: session-summarizer

역할: 각 세션이 어떤 작업이었는지 한 줄로 요약
출력: 세션별 요약 목록 (날짜 + 주제)

Agent 2: pattern-finder

역할: 전체 세션에서 반복되는 패턴 탐지
확인 항목:
- 가장 자주 한 작업 유형 (자동화, 문서 작성, API 연동 등)
- 반복되는 에러나 재시도 패턴
- 자주 사용하는 도구나 기술
출력: 패턴 Top 3 + 근거

Agent 3: growth-tracker

역할: 시간에 따른 변화와 성장을 추적
확인 항목:
- 초기 세션 vs 최근 세션의 작업 복잡도 변화
- 새로 추가된 기술 또는 도구
- 반복되던 작업이 자동화된 흔적
출력: 성장 포인트 2~3개

Step 4: 인사이트 리포트 출력

3개 에이전트 결과를 통합해서 아래 형식으로 출력한다.

📊 히스토리 인사이트 리포트
분석 세션: XX개 | 기간: YYYY-MM-DD ~ YYYY-MM-DD

━━━━━━━━━━━━━━━━━━━━━━━━

📅 세션별 요약 (최근 순)
- [날짜] 세션명: 한 줄 요약
- ...

━━━━━━━━━━━━━━━━━━━━━━━━

🔍 반복 패턴 Top 3
1. [패턴명]: 설명
2. [패턴명]: 설명
3. [패턴명]: 설명

━━━━━━━━━━━━━━━━━━━━━━━━

📈 성장 트래킹
- [성장 포인트 1]
- [성장 포인트 2]
- [성장 포인트 3]

━━━━━━━━━━━━━━━━━━━━━━━━

💡 핵심 인사이트
[전체를 관통하는 핵심 한 문장]

분석 범위 옵션

스킬 실행 시 AskUserQuestion으로 범위를 선택받는다:

AskUserQuestion({
  "questions": [{
    "question": "어떤 범위로 분석할까요?",
    "header": "분석 범위",
    "options": [
      {"label": "현재 프로젝트만", "description": "지금 작업 중인 프로젝트 세션만 분석"},
      {"label": "최근 10개 세션", "description": "가장 최근 10개 세션만 빠르게 분석"},
      {"label": "전체 세션", "description": "모든 Claude Code 세션 분석 (시간 더 소요)"}
    ],
    "multiSelect": false
  }]
})

Quick Reference

언제: 월간 회고, 프로젝트 전환 시, "내가 뭘 해왔지?" 궁금할 때
소요 시간: ~2분 (현재 프로젝트 기준)
출력 파일: sync/history-insight-YYYY-MM-DD.md (선택)