retrospectivelisted
Install: claude install-skill gagip/gagip-dev
# 회고 스킬
현재 대화 세션을 돌아보며 유의미한 정보를 추출하고, 적절한 위치에 기록을 남긴다.
다음 대화에서 LLM이 같은 실수를 반복하지 않거나, 더 나은 판단을 내릴 수 있도록 맥락을 축적하는 것이 핵심 목적이다.
---
## 실행 절차
### Step 1: 대화 세션 분석
현재 대화 전체를 읽으며 아래 항목을 추출한다.
여러 세션을 대상으로 하는 회고라면, 먼저 아래 "옵션: 범위 확장 → 다중 세션·주간 회고 워크플로우"로
세션을 분산 분석한 뒤 그 결과를 종합해 같은 항목을 추출한다.
**추출 항목**:
- **수정/재작업 발생 지점**: 내가 처음 제안한 것을 사용자가 수정 요청한 경우 → 왜 틀렸는지
- **사용자 명시적 피드백**: "그건 아니야", "그게 아니라", "다시 해봐", "원본 유지해" 등의 표현
- **사용자 암묵적 피드백**: 수정 없이 바로 수락한 접근법 → 무엇이 잘 작동했는지
- **새로 파악한 사실**: 프로젝트 구조, 팀 맥락, 사용자 선호 등 이전에 몰랐던 것
- **스킬/문서 개선 포인트**: 스킬이 놓친 케이스, 문서에 없는 규칙
### Step 2: 인사이트 분류 및 업데이트 항목 결정
추출한 항목을 아래 4가지 카테고리로 분류하고, 각각 업데이트가 필요한지 판단한다.
**업데이트 여부는 강제하지 않는다** — 유의미한 변경이 없으면 해당 항목은 건너뛴다.
| 카테고리 | 해당 내용 | 업데이트 위치 |
|---|---|---|
| 스킬/지침 개선 | 스킬이 놓친 케이스, 잘못된 절차, 추가할 규칙 | 해당 `SKILL.md` |
| 메모리 업데이트 | 사용자 선호, 피드백, 프로젝트 맥락 | `~/.claude/projects/.../memory/` |
| 볼트 기록 (회사) | 업무 회고 — 작업 내용, 의사결정, 팀 맥락 | CLAUDE.md의 회사 볼트 경로 참조 |
| 볼트 기록 (개인) | 순수 기술 인사이트 — 회사 맥락 제거, 재사용 가능한 지식 | CLAUDE.md의 개인 볼트 경로 참조 |
| CLAUDE.md 업데이트 | 전역 또는 프로젝트 수준 지침 변경 | `~/.claude/CLAUDE.md` 또는 프로젝트 `CLAUDE.md` |
### 업데이트 판단 기준
카테고리별로 아래 기준을 충족할 때만 업데이트한다.
**메모리** — LLM이 다음 대화에서 행동을 바꿔야 할 때
- 사용자가 명시적으로 교정한 접근법 ("그건 아니야", "원본 유지해" 등)
- 이 프로젝트/사용자에게만 해당하는 선호나 맥락
- 기존 메모리 파일로 커버되지 않는 새 패턴
- 단, 전역 CLAUDE.md(**항상 로드**)에 이미 있거나 이번에 승격할 내용이면 메모리로 중복 보유하지 않는다. 스킬(**조건부 로드** — 그 스킬이 불릴 때만)에만 있는 내용은 안전망으로 메모리에 둘 수 있다.
**볼트 (회사)** — 업무 관련 기록, 나중에 사람이 다시 꺼내볼 가치가 있을 때
- 의사결정 근거 (왜 이 방식을 선택했는지, 팀/프로젝트 맥락 포함)
- 오늘 작업에서 발생한