| name | debrief |
| description | 코드 작업 완료 후 변경 내러티브 문서 생성. 변경 요약, 설계 판단 근거, 학습 포인트를 vault에 기록. Vault 위치/매핑은 `documentation` skill, 형식은 `obsidian-write` 참조. Use when completing code work, after PR creation, reviewing what was done, or wanting to document changes for learning. /debrief, 작업 정리, 변경 기록, 회고. |
| user-invocable | true |
| argument-hint | [branch-or-pr] |
Debrief — 변경 내러티브 문서 생성
코드 작업 완료 후 왜 이렇게 했는지, 전체 그림, 학습 포인트를 구조화하여 vault에 기록한다.
diff만으로는 파악하기 어려운 설계 판단과 맥락의 문서화가 목적. 경량 실행이 원칙 — 부가 파이프라인(미생성 키워드 제안, 관련 개념 탐색, 학습 질문, ir embed)은 수행하지 않는다.
Phase 1: 변경 분석
- 대상:
$ARGUMENTS가 PR 번호면 gh pr view {n} --json headRefName으로 branch 추출, branch명이면 그대로, 없으면 현재 branch의 main..HEAD
- 수집 (병렬):
git log {base}..HEAD --oneline --no-decorate, git diff {base}..HEAD --stat, git diff {base}..HEAD, PR 있으면 gh pr view --json title,body,url,number
- 추가 맥락:
.claude/plans/·.claude/designs/ 문서, 현재 세션 대화의 논의/판단
Phase 2: 문서 생성
파일명: projects/{name}/debrief/{제목}.md
---
project: pj-{name}
date: YYYY-MM-DD
status: done
branch: {branch-name}
pr: {number}
---
# Summary
{2-3줄 변경 요약 — 무엇을 왜}
# Changes
## {모듈/기능 그룹}
- {각 변경의 의도 설명}
# Decisions
- {설계 판단과 트레이드오프 — "A 대신 B, 이유: C" 형식}
# Learned
- {사용된 패턴, 라이브러리, 기법 중 학습 가치 있는 것}
# Related
- {PR 링크, 관련 이슈, 참고 자료를 [[링크]]로}
작성 원칙:
- Changes: 파일 나열이 아닌 모듈/기능 단위 그룹핑 + "왜 필요했는지" 한 줄
- Decisions: diff에서 드러나지 않는 판단만 — "A 대신 B를 선택한 이유"
- Learned: 범용 재사용 가능한 지식만. 프로젝트 특수사항은 Changes로
- 표준 markdown heading (
- # 결합 금지), #태그 대신 [[링크]], pr 프로퍼티는 PR 없으면 생략
Phase 3: 연결 + 저장
- ir search 1회:
ir search --mode bm25 "{branch 또는 PR title 핵심 키워드}" -n 5 --files — 결과에서:
- 관련 페이지 → Related 섹션에
[[링크]]
- open 상태
issue/ 페이지 → "진행 상황"에 날짜 + debrief 링크 추가, last-verified 갱신, 해결됐으면 status 변경 제안
- 매칭 없으면 스킵
- 페이지 저장 후 당일 저널에 링크:
- [x] {작업 요약} #pj-{project}
- -> [[{제목}]]
ir update (ir embed는 생략 — /recall index 배치가 수행)
obsidian-write의 "작성 후 필수 작업" 중 Step 1(미생성 키워드)·2(관련 개념 탐색)·4(학습 질문)는 생략한다.
중요 원칙
- diff 너머의 맥락: 변경 자체가 아닌 변경의 이유가 핵심
- 학습 자산화: Learned는 미래의 나를 위한 범용 지식만
- 연결 우선: ir search 1회로 찾은 관련 페이지와 반드시
[[링크]]
- 간결함: "A 대신 B, 이유: C" 형식. 장황한 설명 금지
Example
User: "/debrief 42"
→ gh pr view 42 → branch 추출 → diff 분석
→ 내러티브 구성 (Summary/Changes/Decisions/Learned)
→ ir search 1회 (Related + issue 교차)
→ 페이지 저장 + 저널 링크 + ir update
