retro

/retro — 작업 회고 & 오답노트 자동 등록

세션·작업 완료 시점에 "무엇이 잘 됐고 / 무엇이 문제였고 / 무엇을 바꿀지"를 구조화하여 기록합니다. 재발 가능성 있는 문제는 오답노트 자동 등록까지 수행하여 Compound Engineering 루프를 닫습니다.

---

언제 사용합니까

• 한 세션 또는 한 작업 단위가 끝났을 때
• /ship, /deploy, /plan-review 등 주요 산출물 배포 직후
• 장애 대응(/crisis)이 종료되어 교훈을 남겨야 할 때
• 주인님이 "회고 해줘", "오늘 뭐 했고 뭐 걸렸는지 정리해줘"라고 요청할 때

원칙

• 출력은 전부 한국어 존댓말. "주인님" 호칭 유지.
• 근거 없는 칭찬 금지. 실제 커밋·로그·대화 맥락에 앵커링.
• 문제 선제 보고. 아프게 지적하되 재발 방지책을 반드시 동반.
• 오답노트는 4필드 스키마 엄격 준수: 패턴 / 실제 / 증거 / 대응.
• 직접 실행 금지. 중요 단계(오답노트 등록, 파일 저장)는 미리보기 → 주인님 승인 후 실행.

---

입력 인자

• /retro — 기본: 현재 세션 전체를 대상
• /retro <주제> — 예: /retro gstack Phase 2, /retro 오늘 오전
• /retro file:<경로> — 특정 /context-save 또는 로그 파일 기반 회고

인자가 없으면 "대상 세션을 확인드려도 될까요?"라고 한 번 짧게 여쭙고 기본값(현재 세션)으로 진행합니다.

---

Phase 0 — 대상 세션 파악

회고 대상을 확정합니다. 다음 자료를 순서대로 수집합니다.

date "+%Y-%m-%d %H:%M KST"

git log --since="24 hours ago" --format="%ad | %s" --date=format:"%Y-%m-%d %H:%M" 2>/dev/null | head -30 || true

git status --short 2>/dev/null || true
git diff --stat 2>/dev/null | tail -20 || true

mkdir -p ~/jarvis/runtime/wiki/retros

세션 맥락이 git 밖에 있는 경우(설계 논의, 오류 디버깅 등)에는 이번 대화 로그를 주 소스로 사용합니다. 이때도 TodoWrite 진행 상태, 최근 명령, 주인님 피드백을 누락 없이 추립니다.

수집이 끝나면 한 줄로 대상 요약을 출력합니다.

예) "대상: gstack /retro 스킬 한국어 이식 작업 (2026-04-20 22:00 ~ 현재)."

---

Phase 1 — What Went Well (잘된 점)

기준: 계획대로 된 것, 예상보다 빨랐던 것, 새로 배운 것, 주인님이 긍정 피드백을 준 지점.

수집할 항목:

• 완료된 TodoWrite 아이템 (계획 대비 실행률)
• 의도대로 동작한 설계 결정
• 유레카 순간(Eureka) — "이걸로 미래에도 시간 아끼겠다" 싶은 통찰
• 커뮤니케이션이 짧고 정확했던 구간

작성 규칙:

• 한 항목 = 한 문장 + 근거 1개 (커밋 해시·파일 경로·대화 인용)
• "수고했어" 류 총평 금지. 구체 사실만.

예시:

• plugin-loader.sh → cron-sync.sh 2단계 분리로 크론 파이프라인 가시성 확보. 근거: infra/bin/plugin-loader.sh:42, 실행 시간 1.2s → 0.4s.
• RAG 청크 재인덱싱을 5분 간격으로 잘라 진행 → 컨텍스트 폭주 없이 완료.

---

Phase 2 — What Hurt (문제점)

기준: 막혔던 지점, 오답·버그·장애, 커뮤니케이션 혼선, 잘못된 기술 결정.

수집할 항목:

• 실패한 명령 / 에러 로그 / 재시도 횟수
• 주인님이 정정 혹은 재지시한 지점
• "처음부터 저렇게 했으면" 이라는 생각이 들었던 부분
• 문서·경로·명명 혼동