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 당면 과제 체크박스 포함) → 커밋
- 전체 실행: 문서 업데이트 → 커밋 → 자동화 스크립트/스킬 초안 생성
- 건너뛰기: 요약만 출력하고 종료
"문서 업데이트 + 커밋" 또는 "전체 실행" 선택 시 반드시 실행:
CLAUDE.md당면 과제 체크박스를 doc-updater 분석 결과대로 업데이트마지막 업데이트날짜를 오늘 날짜로 갱신- 변경된 CLAUDE.md를 커밋에 포함
Step 6: Rocky 동기화 (자동)
모든 옵션(건너뛰기 제외) 실행 후 자동으로 Rocky에게 세션 학습 내용을 동기화한다.
- learning-extractor와 followup-suggester 결과에서 실제 내용을 추출한다: 추출 불가 시 (짧은 세션, 학습 포인트 없음 등): Step 6 전체 skip — 아래 명령 실행하지 않음
- SYNC_DECISION — 이 세션의 핵심 판단 사항 (1~2문장) - SYNC_WHY — 그 방법/순서를 택한 이유 - SYNC_LEARNING — Rocky가 배울 점 (learning-extractor 결과 활용) - SYNC_NEXT — 후속 작업 (followup-suggester 결과 활용)
- 추출 성공 시
sync_to_rocky.sh호출 (webhook → bot token 순으로 Slack 알림):export SYNC_DECISION="<핵심 판단>" export SYNC_WHY="<이유>" export SYNC_LEARNING="<Rocky가 배울 점>" export SYNC_NEXT="<다음 할 일>" bash scripts/sync_to_rocky.sh "세션 요약 한 줄"
- exit 2 반환 시: 내용 미완성 → 에러 메시지 출력 후 skip (세션 wrap 계속) - SSH 오류 등 기타 실패: 에러 메시지만 출력, wrap 정상 완료
Rocky sync 실패/skip은 세션 마무리를 막지 않는다.
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. 선택된 작업 실행 │
└──────────────────────┬──────────────────────┘
│
┌──────────────────────▼──────────────────────┐
│ Step 6. Rocky 동기화 (SSH → macbook_sync.md) │
│ + Slack #project-hailmary 알림 │
└─────────────────────────────────────────────┘