work-report

Work Report

작업 완료 후 회고 리포트를 생성. 상세 파일 + 터미널 요약 이원화 구조.

이 스킬은 CLAUDE.md의 "작업 완료 시 회고"를 대체한다. 이 스킬 사용 시 별도 회고를 출력하지 않는다.

사전 준비

# reports/ 디렉토리 없으면 생성
mkdir -p reports

# .gitignore에 reports/ 없으면 추가 (개인 회고용, git 추적 불필요)
grep -q '^reports/' .gitignore || echo 'reports/' >> .gitignore

Step 1: 상세 리포트 파일 생성

reports/{task_id}_report.md 파일을 생성한다. 아래 9개 섹션을 모두 필수로 포함한다.

해당 사항이 없는 섹션은 "해당 없음"으로 표기한다. 섹션을 삭제하지 않는다.

"해당 없음" 표기법: 테이블 형식 섹션은 테이블을 생략하고 "해당 없음" 텍스트만 작성.

# 작업 완료 리포트: [task_id] [작업명]

- 날짜: [YYYY-MM-DD]
- 커밋: [N]개 | 변경 파일: [N]개 | 테스트: [N]개
- PR: [URL]

## 1. 작업 요약

[무엇을 했는지 3-5줄 요약. 주요 변경사항 나열]

## 2. 의사결정 로그

작업 중 2개 이상의 선택지가 있었던 모든 지점:

| 결정 | 선택지 | 최종 선택 | 이유 |
|------|--------|----------|------|
| [결정1] | A: ... / B: ... | [선택] | [이유] |

## 3. 실수와 우회

처음 시도했다가 실패하거나 방향을 바꾼 모든 부분:

- **[실수 내용]**: [왜 실패했고 어떻게 우회했는지] (소요시간: ~N분)

## 4. Plan vs 실제

Phase 1 Plan과 실제 구현의 차이점:

| Plan | 실제 | 차이 이유 |
|------|------|----------|
| [계획했던 것] | [실제 한 것] | [왜 달라졌는지] |

## 5. 확신도

- **전체**: 상/중/하
- **낮은 영역**: [구체적으로 어떤 부분이 불확실한지, 왜 그런지]

## 6. TIL (Today I Learned)

이 작업에서 새로 배운 것, 발견한 패턴, 기술적 인사이트:

- [배운 것 1]
- [배운 것 2]

## 7. 기술 부채 / 개선점

발견했지만 이번 작업 scope에서 처리하지 않은 것:

- [ ] [부채/개선점 1]
- [ ] [부채/개선점 2]

## 8. Skill 후보

작업 중 반복적으로 나타난 패턴으로, 자동화하거나 skill로 만들면 좋을 것:

- [패턴 설명] → [제안하는 skill/자동화]

## 9. 액션 아이템

이 작업의 후속으로 필요한 구체적 행동:

- [ ] [액션 1]
- [ ] [액션 2]

Step 2: 터미널 요약 출력

상세 파일 생성 후, 터미널에 압축 요약(5-10줄)을 출력한다.

아래 형식을 정확히 따른다. 박스 아트, 이모지 장식, 커스텀 섹션 추가 금지.

작업 완료 리포트

• Task: [task_id] [한줄 설명]
• 커밋: [N]개 | 변경: [N]파일 | 테스트: [N]개
• 확신도: [상/중/하] ([한줄 이유])

주의 포인트

• [확신도 낮은 부분 또는 리스크 1-2개]

액션 아이템

• [핵심 액션 1-2개]

📄 상세 리포트: reports/[task_id]_report.md

작성 규칙

1. 구체적으로 쓰세요: "잘 모르겠다"가 아니라 "N+1 쿼리 발생 가능성이 있으나 프로파일링 미실시"
2. 파일/함수 참조 포함: 의사결정이나 실수가 어느 코드에 관련된 것인지 명시 (예: src/containers.py)
3. 시간 소모 기록 필수: 실수/우회마다 반드시 (소요시간: ~N분) 표기
4. 비어있어도 섹션 유지: "해당 없음"으로 표기. 섹션을 삭제하지 않는다
5. 사실만 기록: 실제 작업 내용만 기록. 추측이나 일반론 금지

금지 사항

• 템플릿에 없는 섹션 추가 금지 (배포 체크리스트, 코드 품질 지표 등)
• 코드 스니펫을 리포트에 포함하지 않는다 (파일 경로 참조로 대체)
• 터미널 요약에 박스 아트, 구분선, 과도한 이모지 사용 금지
• 파일 경로는 반드시 reports/{task_id}_report.md (.claude/reports/ 아님)