---
name: update-backlog
description: 노션 백로그에 작업 내용을 맥락 중심으로 정리. "백로그 정리", "노션 정리", "작업 내용 정리" 등 백로그 문서화 요청 시 사용.
---

# 노션 백로그 작업 내용 정리

커밋 완료된 변경사항을 분석하여 노션 백로그에 **읽는 사람이 맥락을 이해할 수 있도록** 정리합니다.

## 사용법

```bash
/update-backlog <노션 URL>
/update-backlog <노션 URL> "추가 컨텍스트"
```

## 핵심 룰

**반드시 [노션 백로그 작업 내용 정리 룰](../../../.docs/claude/notion/backlog-documentation.md)을 따릅니다.**

작성 흐름: **배경(왜) → 내용(뭘) → 결과(어떻게 됐는지)**

## 처리 단계

1. **노션 페이지 확인**
   - 전달받은 URL에서 페이지 ID 추출
   - `notion fetch`로 현재 내용 확인
   - 기존 내용이 있으면 보존하며 보완

2. **변경사항 분석**
   - `git log`로 이번 작업의 커밋 내역 확인
   - `git diff`로 실제 변경 범위 파악
   - 변경의 목적과 맥락 파악

3. **일감 유형 판별**
   - 커밋 타입과 변경 내용을 기반으로 판별
   - 유형: 기능 개발 / 버그 수정 / 테스트 작성 / 리팩토링
   - 유형에 맞는 템플릿 적용

4. **내용 작성 — 맥락 중심**

   **기능 개발일 때:**
   - 배경: 사용자가 어떤 상황에서 어떤 필요가 있었는지
   - 구현: 핵심 기능이 사용자에게 어떤 가치를 주는지
   - 결과: 사용자 관점에서 달라진 점

   **버그 수정일 때:**
   - 증상: 어떤 문제가 발생했는지
   - 원인: 근본 원인
   - 해결: 어떻게 수정했는지

   **테스트 작성일 때:**
   - 배경: 왜 이 테스트가 필요했는지
   - 구현: 무엇이 검증되는지 (파일명 나열이 아닌 검증 내용)
   - 결과: 커버리지와 안전망 확보 범위

   **리팩토링일 때:**
   - 배경: 기존 구조의 문제점
   - 변경: 무엇을 어떻게 바꿨는지
   - 결과: 개선된 점

5. **금지 사항 확인**
   - ❌ 파일명/함수명 나열 (→ 기능 레벨로 설명)
   - ❌ Git 관련 정보 (커밋, 브랜치, PR)
   - ❌ 상태/날짜 속성 변경
   - ❌ 숫자 강조 ("62개 테스트" → "지도 제어/이벤트/마커 전 영역 검증")
   - ❌ 추측성 내용 작성 (git diff/log에서 확인 가능한 사실 또는 사용자가 전달한 맥락만 기재, 확인할 수 없는 동기/문제점 추측 금지)
   - ❓ 배경이 불분명하면 역질문 (배경/동기가 git diff에서 파악되지 않으면 사용자에게 질문하여 확인 후 작성)

6. **Todo 리스트 작성**
   - 완료된 작업 항목을 [x]로 체크
   - 기능 레벨로 작성 (파일 단위가 아닌 작업 단위)

7. **노션 페이지 업데이트**
   - `notion-update-page`로 저장
   - 기존 child database가 있으면 보존 (allow_deleting_content 사용 금지)

## 주의사항

- **파일/코드 나열 금지**: "useMapControl 테스트 14개"가 아니라 "지도 이동/줌 제어가 정상 동작하는지 검증"
- **숫자보다 의미**: "62개 테스트 추가"가 아니라 "지도 모듈 전 영역에 회귀 테스트 안전망 확보"
- 기존 내용이 있으면 삭제하지 않고 하단에 추가
- 추가 컨텍스트가 있으면 내용에 반영