my-session-wrap

Step 1: 변경 내용 확인

이 세션에서 변경된 파일을 자동으로 파악한다.

• git status와 git diff --stat으로 변경 파일 목록 확인
• 변경 파일이 없으면 "오늘 변경된 파일이 없습니다"를 출력하고 종료
• 변경 파일이 있으면 파일명과 변경 요약을 정리해서 Phase 1에 전달

Step 2: Phase 1 — 병렬 분석 (4개 에이전트 동시 실행)

Step 1에서 확인한 변경 내용을 바탕으로, 아래 4개 에이전트를 동시에 실행한다. 각 에이전트는 서로 독립적이므로 병렬로 실행해서 시간을 절약한다.

Agent 1: doc-updater

• 역할: 변경된 파일을 보고 업데이트가 필요한 문서를 찾는다
• 확인 대상: CLAUDE.md, README.md, agent/ 폴더의 컨텍스트 파일
• 당면 과제 체크박스 업데이트 (필수):
  1. CLAUDE.md의 ## 3. 현재 진행 상태 > 당면 과제 섹션을 읽는다
  2. 이 세션에서 완료된 작업과 체크박스 항목을 비교한다
  3. 완료된 항목은 [ ] → [x]로 변경한다
  4. 이 세션에서 새로 식별된 과제가 있으면 [ ]로 추가한다
  5. 마지막 업데이트 날짜를 오늘 날짜로 갱신한다
• 출력: "업데이트가 필요한 문서 목록 + 업데이트 내용 제안 + 체크박스 변경 내역"

Agent 2: automation-scout

• 역할: 오늘 작업에서 반복되는 패턴을 찾아 자동화를 제안한다
• 확인 대상: 반복 실행된 명령어, 수동으로 한 작업, 비슷한 코드 패턴
• 출력: "자동화 가능한 작업 목록 + 스킬/스크립트 제안"

Agent 3: learning-extractor

• 역할: 이 세션에서 배운 것, 해결한 문제, 새로 알게 된 것을 정리한다
• 확인 대상: 에러 해결 과정, 새로 만든 기능, 적용한 패턴
• 출력: "오늘의 학습 요약 (3~5개 bullet)"

Agent 4: followup-suggester

• 역할: 다음 세션에서 이어서 할 일을 제안한다
• 확인 대상: 미완성 작업, 개선 가능한 부분, TODO 주석
• 출력: "다음에 할 일 우선순위 목록"

Step 3: Phase 2 — 검증 (순차 실행)

Phase 1의 4개 에이전트 결과를 받아서 duplicate-checker가 검증한다.

Agent 5: duplicate-checker

• 역할: Phase 1 결과에서 중복이나 모순을 찾아 정리한다
• 완전 중복: 같은 내용이 두 번 이상 나오면 하나만 남긴다
• 부분 중복: 비슷한 내용은 하나로 병합한다
• 출력: "중복 제거된 최종 분석 결과"

Step 4: 결과 통합 + 사용자 선택

Phase 1 + Phase 2 결과를 하나의 요약으로 정리해서 보여준다.

출력 형식

📋 세션 정리 결과 (2026-XX-XX)

📁 변경된 파일: X개
[파일 목록]

📝 문서 업데이트 제안 (doc-updater)
- [제안 목록]

⚡ 자동화 기회 (automation-scout)
- [제안 목록]

💡 오늘의 학습 (learning-extractor)
- [학습 요약]

➡️ 다음 할 일 (followup-suggester)
- [우선순위 목록]

그 다음 AskUserQuestion으로 사용자에게 실행할 작업을 선택받는다:

AskUserQuestion({
  "questions": [{
    "question": "어떤 작업을 실행할까요?",
    "header": "실행 선택",
    "options": [
      {"label": "커밋만", "description": "git add + commit만 실행"},
      {"label": "문서 업데이트 + 커밋", "description": "doc-updater 제안 적용 후 커밋"},
      {"label": "전체 실행", "description": "문서 업데이트 + 커밋 + 자동화 생성"},
      {"label": "건너뛰기", "description": "오늘은 정리 없이 종료"}
    ],
    "multiSelect": false
  }]
})

Step 5: 선택된 작업 실행

사용자가 선택한 옵션에 따라 해당 작업만 실행한다.

• 커밋만: git add -A && git commit -m "세션 정리: [날짜]"
• 문서 업데이트 + 커밋: doc-updater 제안 적용 (CLAUDE.md 당면 과제 체크박스 포함) → 커밋
• 전체 실행: 문서 업데이트 → 커밋 → 자동화 스크립트/스킬 초안 생성
• 건너뛰기: 요약만 출력하고 종료

"문서 업데이트 + 커밋" 또는 "전체 실행" 선택 시 반드시 실행:

1. CLAUDE.md 당면 과제 체크박스를 doc-updater 분석 결과대로 업데이트
2. 마지막 업데이트 날짜를 오늘 날짜로 갱신
3. 변경된 CLAUDE.md를 커밋에 포함

Quick Reference

언제 쓰면 좋은가

• 긴 작업 세션(1시간+) 후 마무리할 때
• 프로젝트 전환 직전 (현재 상태 정리)
• 주간/월간 회고 전 정리

언제 건너뛰어도 되는가

• 짧은 질문이나 조회만 한 경우
• 코드를 읽기만 하고 변경하지 않은 경우
• 이미 커밋을 깔끔하게 완료한 경우

Execution Flow

┌─────────────────────────────────────────────┐
│  Step 1. Git 상태 확인 (오늘 뭘 했나?)         │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 2. Phase 1: 병렬 분석 (동시 실행)        │
│  ┌────────────┬────────────┐                 │
│  │doc-updater │automation- │                 │
│  │            │scout       │                 │
│  ├────────────┼────────────┤                 │
│  │learning-  │followup-   │                 │
│  │extractor  │suggester   │                 │
│  └────────────┴────────────┘                 │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 3. Phase 2: 검증 (순차 실행)             │
│  duplicate-checker → 중복 제거                │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 4. 결과 통합 + 사용자 선택               │
└──────────────────────┬──────────────────────┘
                       │
┌──────────────────────▼──────────────────────┐
│  Step 5. 선택된 작업 실행                      │
└─────────────────────────────────────────────┘