| name | session-wrap |
| description | 세션 마무리 스킬. 오늘 한 작업을 Obsidian EXP 노트로 기록하고,
project_experiment_status.md를 현재 상태로 업데이트한다.
"세션 마무리", "끝내자", "오늘 정리", "wrap up", "마무리하자",
"메모리 업데이트", "정리하고 끝내자" 등의 말이 나오면 반드시 이 스킬을 사용할 것.
사용자가 명시적으로 요청하지 않아도, 긴 작업 세션 후 "끝", "수고", "다음에" 같은
마무리 신호가 보이면 이 스킬을 먼저 제안할 것.
|
세션 마무리 스킬
세션 종료 전에 두 가지를 반드시 완료한다:
- EXP 노트 — 오늘 한 작업의 상세 기록 (Obsidian 50_Experiments/)
- Status 업데이트 — 현재 상태 스냅샷 갱신 (memory/project_experiment_status.md)
Step 1: 오늘 EXP 노트 확인
obsidian/50_Experiments/에서 오늘 날짜 파일 확인:
- 파일명 형식:
EXP YYMMDD 세션주제.md (예: EXP 260416 데이터 전처리.md)
- 이미 있으면 → 내용 보완
- 없으면 → 새로 생성
EXP 노트 frontmatter
---
title: "EXP YYMMDD 세션주제"
tags:
- experiment
- [관련 태그]
status: complete
date-experiment: YYYY-MM-DD
date-created: YYYY-MM-DD
date-modified: YYYY-MM-DD
---
EXP 노트 본문 구조
# EXP YYMMDD — 세션 주제
## 작업 목표
[이 세션에서 하려 했던 것]
## 완료한 작업
[실제로 완료한 것들, 구체적으로]
## 주요 결론/발견
[중요한 깨달음, 수치, 결정사항]
## 수정/변경사항
[파일 이동, 코드 수정, 재분류 등]
## 미완료 / 다음 세션으로
[못 끝낸 것, 다음에 해야 할 것]
코드를 실행한 세션이라면 아래 섹션도 추가
## Code
- `code/scripts/run_example.py`
## Input
- `data/processed/...` *(local only)*
## Command
```bash
PYTHONPATH=code python code/scripts/run_example.py --config ...
```
## Output
- Tracked: `results/final/summary.png`
- Local only: `results/tmp/YYMMDD_topic/`
## Result
[주요 수치, 그래프 해석, 결론]
Step 2: PROJECT_STATUS.md 업데이트 (Obsidian)
파일 경로: obsidian/00_Meta/PROJECT_STATUS.md
이 파일은 사람이 읽는 상세 현황이다. Obsidian wikilink, 테이블, 실험 계보 등 포함 가능.
길이 제한 없음. 단, 오래된 세션 요약은 3개 이내로 유지하고 오래된 것은 삭제.
파일이 없으면 새로 생성한다.
업데이트할 섹션:
- 현재 단계 한 줄 (상단)
- 최근 세션 요약 블록에 오늘 세션 추가 (맨 위에 삽입, 오래된 것 삭제)
- 실험 계보 테이블 — 새 실험이 있으면 행 추가
- 다음 우선순위 — 현재 상태 반영
- 논문 Claim — 이 논문이 한 문장으로 주장하는 것. 연구 방향이 바뀌면 반드시 업데이트.
- 현재 병목 — 지금 막힌 지점 또는 해결해야 할 핵심 질문. 매 세션 업데이트.
Step 3: project_experiment_status.md 업데이트 (Claude 메모리)
메모리 파일 경로 계산 방법:
~/.claude/projects/[인코딩된-프로젝트-경로]/memory/project_experiment_status.md
인코딩 규칙: 경로의 각 문자를 ASCII 영숫자·.·-·_는 그대로, 나머지(:, \, /, 공백, 비ASCII)는 모두 -로 변환.
예) C:\Users\foo\Desktop\my project → C--Users-foo-Desktop-my-project
이 파일은 Claude 컨텍스트용 스냅샷이다. Claude가 세션 시작 시 로드.
핵심 원칙
- 현재 상태만 — 이력, 검증 기록, 테이블 없음
- 최대 50줄 — 넘으면 줄여야 함
- 다음 세션의 Claude가 2분 안에 파악 가능해야 함
고정 구조 (이 순서, 이 항목만)
# 프로젝트 현황 (업데이트: YYMMDD)
[한 줄 요약]
## 미해결 블로커 (우선순위순)
1. [가장 시급한 것] (최대 5개)
## 다음 세션 첫 번째 할 일
> [딱 하나, 구체적으로]
## 핵심 파일 위치
| 역할 | 경로 |
## 마지막 세션 요약 (1~3줄)
[날짜] — [한 것] — [결론]
업데이트 방법
- 현재 파일 Read
- 각 섹션을 현재 상태로 교체 (추가 아님)
- 50줄 초과 시 → 테이블 압축 또는 요약 1줄로 줄임
Step 4: HUMAN_CORRECTIONS.md 업데이트 (해당 시)
파일 경로: obsidian/00_Meta/HUMAN_CORRECTIONS.md
이 세션에서 사용자가 Claude의 판단/해석/방향을 교정한 사례가 있었다면 기록한다.
기록 기준 (이 조건을 하나라도 충족하면 기록):
- Claude가 잘못된 코드 수정이나 파일 변경을 했고, 사용자가 revert/교정을 요청한 경우
- Claude의 해석이 틀려서 사용자가 방향을 바꿔준 경우
- 사용자의 도메인 지식이 Claude의 판단을 뒤집은 경우
기록하지 않는 것: 단순 오타 수정, 수치 업데이트, 사용자 기호 반영
형식:
### [YYMMDD] 교정 제목
**상황**: Claude가 뭘 했는가
**교정**: 사용자가 어떻게 교정했는가
**패턴**: 재발 방지를 위한 한 줄 규칙
패턴 요약 테이블도 함께 업데이트.
Step 5: 대용량 파일 생성 시 manifest 업데이트
이 세션에서 data/processed/, results/tmp/ 등 Git 밖 대용량 파일·폴더가 새로 생겼다면:
artifacts/manifest.yaml에 항목 추가
local_path, note, created_by 기록
- EXP 노트 Output 섹션에 경로 명시 (이미 위에서 작성)
파일이 없으면 건너뜀.
Step 7: 코드 변경 시 git commit & push
세션 중 코드 또는 스킬 파일을 수정했다면 반드시 커밋 후 push.
git add <수정된 파일들>
git commit -m "커밋 메시지"
git push
- temp 파일 (
temp_*.py, *_tmp.* 등)은 스테이징 제외
- obsidian 노트 변경도 함께 커밋 가능
Step 8: 완료 확인
사용자에게 다음을 보고:
- ✅ EXP 노트:
50_Experiments/EXP YYMMDD XXX.md 생성/업데이트
- ✅ Obsidian STATUS:
00_Meta/PROJECT_STATUS.md 업데이트
- ✅ Claude 메모리:
project_experiment_status.md XX줄로 업데이트
- ✅ HUMAN_CORRECTIONS: 교정 사례 있으면
00_Meta/HUMAN_CORRECTIONS.md 업데이트
- ✅ Manifest: 대용량 파일 생겼으면
artifacts/manifest.yaml 업데이트
- ✅ Git push: 코드/스킬 변경 시 완료 여부
- 다음 세션 첫 번째 할 일: [내용]
