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를 커밋에 포함

Step 6: Rocky 동기화 (자동)

모든 옵션(건너뛰기 제외) 실행 후 자동으로 Rocky에게 세션 학습 내용을 동기화한다.

1. learning-extractor와 followup-suggester 결과에서 실제 내용을 추출한다:

- SYNCDECISION — 이 세션의 핵심 판단 사항 (1~2문장) - SYNCWHY — 그 방법/순서를 택한 이유 - SYNCLEARNING — Rocky가 배울 점 (learning-extractor 결과 활용) - SYNCNEXT — 후속 작업 (followup-suggester 결과 활용)

추출 불가 시 (짧은 세션, 학습 포인트 없음 등): Step 6 전체 skip — 아래 명령 실행하지 않음

1. 추출 성공 시 synctorocky.sh 호출 (webhook → bot token 순으로 Slack 알림):

``bash export SYNCDECISION="<핵심 판단>" export SYNCWHY="<이유>" export SYNCLEARNING="<Rocky가 배울 점>" export SYNCNEXT="<다음 할 일>" bash scripts/synctorocky.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 알림              │
└─────────────────────────────────────────────┘