메뉴
주간/세션 단위 회고를 실행하세요. "회고해줘", "이번 주 정리해줘", "뭘 했는지 요약해줘", "retro", "retrospective", "/retro" 등에 트리거합니다. git 통계 + 메모리를 결합해 성과·배운 것·막힌 곳을 구조화된 리포트로 출력하고, 진화 기회를 식별합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
실수를 했을 때, 사용자에게 교정받았을 때, 가정이 틀렸을 때, 또는 코드베이스에 대해 비자명한 것을 배웠을 때 사용하세요. 실수와 교훈을 .claude/memory/ 파일에 영구적으로 기록하여 다음 세션에서 같은 실수를 반복하지 않도록 합니다.
컨텍스트 압축(compaction) 타이밍을 안내합니다. "컴팩트해줘", "컨텍스트 정리해줘", "compact-guide", "context가 꽉 찼어", "토큰이 부족해" 등에 트리거합니다. 언제 압축해야 하고 언제 하면 안 되는지 판단 기준과 압축 전 체크리스트를 제공합니다.
사용자가 "커밋해줘", "스테이지해줘", "PR 만들어줘", "브랜치 만들어줘", "이거 올려줘", "git 작업 도와줘"라고 할 때 사용하세요. 안전한 git 작업, 커밋 메시지 작성, PR 생성을 위한 표준 절차를 제공합니다. 파괴적 명령은 절대 실행하지 않습니다.
하네스 자체를 진화시킬 때 사용하세요. "이거 규칙으로 만들어", "이 작업 스킬로 만들어", "이거 차단해", 같은 실수가 반복될 때, 같은 패턴의 코드를 여러 번 작성할 때, 프로젝트 구조가 변경되었을 때 트리거합니다. 규칙·스킬·hook·메모리를 프로젝트에 맞게 진화시킵니다.
| name | retro |
| description | 주간/세션 단위 회고를 실행하세요. "회고해줘", "이번 주 정리해줘", "뭘 했는지 요약해줘", "retro", "retrospective", "/retro" 등에 트리거합니다. git 통계 + 메모리를 결합해 성과·배운 것·막힌 곳을 구조화된 리포트로 출력하고, 진화 기회를 식별합니다. |
숫자는 거짓말하지 않는다. git과 메모리가 말하는 것을 들어라. 회고는 자책이 아니라 다음 주를 더 잘 보내기 위한 데이터 수집이다.
기간을 지정하지 않으면 지난 7일이 기본. 명시적 기간 예시:
# 커밋 수 및 메시지
git log --oneline --since="7 days ago" --no-merges
# 파일별 변경량
git diff --stat HEAD~$(git log --oneline --since="7 days ago" --no-merges | wc -l) HEAD 2>/dev/null || \
git log --since="7 days ago" --no-merges --numstat --format="" | awk '{add+=$1; del+=$2} END {print "+"add" -"del}'
# 변경된 파일 목록
git log --since="7 days ago" --no-merges --name-only --format="" | sort -u | head -30
# 작업한 브랜치
git log --since="7 days ago" --no-merges --format="%D" | tr ',' '\n' | grep -v '^$' | sort -u | head -10
# 커밋 타입 분포 (conventional commits 기준)
git log --since="7 days ago" --no-merges --format="%s" | grep -oP '^(feat|fix|docs|refactor|test|chore|perf|build|ci)' | sort | uniq -c | sort -rn
기간 내 커밋이 0개이면 파라미터를 늘려 재시도하고, 그래도 없으면 사용자에게 알린다.
a) .claude/memory/mistakes.md 에서 해당 기간 항목 추출
- 새로 기록된 실수 개수
- 반복 태그 있는지 (진화 트리거 확인)
b) .claude/memory/lessons.md 에서 새 항목 확인
c) .claude/memory/decisions.md 에서 기간 내 ADR 확인
아래 조건이 감지되면 진화 권고 섹션에 명시:
| 신호 | 의미 |
|---|---|
| mistakes.md 동일 태그 2회 이상 | 해당 영역 규칙/hook 강화 필요 |
| 같은 커밋 타입이 전체의 60% 이상 | 특정 작업 패턴 → 스킬 추출 고려 |
| fix 커밋이 feat 커밋보다 많음 | 테스트 커버리지 또는 설계 문제 신호 |
| 문서 관련 커밋이 0개 | 코드-문서 불일치 누적 가능성 |
## 🔁 회고 — YYYY-MM-DD ~ YYYY-MM-DD
### 📊 숫자
| 항목 | 값 |
|---|---|
| 커밋 | N개 |
| 추가 라인 | +X |
| 삭제 라인 | -Y |
| 순 변화 | +Z |
| 변경 파일 | N개 |
| 테스트 커밋 비율 | N% |
### 🏗️ 무엇을 했나
커밋 타입별 요약. 가장 많이 건드린 영역 3개.
### 🐛 실수와 학습
- 이번 기간 mistakes.md에 기록된 실수: N개
- 새 교훈(lessons.md): N개
- 반복 태그: <있으면 나열 / 없음>
### 🚧 막힌 곳
fix 커밋이 많거나 같은 파일을 반복 수정한 경우 식별.
### ⚡ 진화 권고
<감지된 진화 신호가 있으면 나열. 없으면 "이번 기간 진화 트리거 없음">
### 📝 다음 주 제안
데이터 기반으로 1~3개 제안. 추측 금지 — 숫자에서 도출한 것만.
evolve 스킬 트리거 여부를 명시한다:
/evolve 실행을 고려하세요"