update-docs

문서 업데이트

목적

특정 날짜(기본: 오늘)의 git 커밋을 분석하여 다음 문서를 일관되게 업데이트합니다:

• docs/changelog/YYYY-MM/YYYY-MM-DD.md — 해당 날짜 변경 이력 파일 신규 생성 (또는 같은 날 추가 항목이면 -2/-3 suffix)
• docs/changelog/README.md — 인덱스에 한 줄 추가
• docs/SETUP.md — 사용법/API 테이블 반영

CLAUDE.md는 이 스킬의 기본 업데이트 대상이 아닙니다. 일상적인 기능 추가/수정은 changelog와 SETUP.md만 갱신하고, CLAUDE.md는 손대지 않습니다. CLAUDE.md는 기존 설명에 사실과 다른 부분(실수)이 있다고 명확히 확인된 경우에만 그 부분만 정확히 고치도록 합니다 — 자세한 조건은 "Step 6: CLAUDE.md 처리" 참조.

워크플로우

Step 1: 대상 커밋 수집

인수를 파싱하여 대상 커밋 범위를 결정합니다:

• 인수 없음: 오늘 날짜 (git log --since="YYYY-MM-DDT00:00:00" --until="YYYY-MM-DDT23:59:59")
• 날짜 지정 (예: 2026-04-03): 해당 날짜 커밋
• 커밋 범위 (예: abc123..def456): 해당 범위 커밋

대상 커밋이 0개이면:

## 문서 업데이트

해당 기간에 커밋이 없습니다.

종료합니다.

Step 2: 변경 분석

각 커밋에 대해 다음을 수집합니다:

1. git log <hash> -1 --format="%B" — 커밋 메시지 전문
2. git diff <hash>^..<hash> --stat — 변경 파일 목록
3. git diff <hash>^..<hash> — 주요 파일의 실제 diff (서버 서비스, DB 스키마, 라우트, 클라이언트 컴포넌트 중심)

수집한 정보를 바탕으로 다음을 파악합니다:

• 기능 추가: 새 파일, 새 API 엔드포인트, 새 UI 컴포넌트
• 아키텍처 변경: 서비스 역할 변경, 새 패턴 도입, DB 스키마 변경
• 사용법 변경: 새 설정 옵션, 새 사용자 기능, UI 흐름 변경

Step 3: 현재 문서 읽기

다음 파일을 읽습니다:

1. docs/changelog/README.md — 인덱스 형식과 가장 최근 entry의 월/파일명 패턴 파악
2. 직전 entry 파일 1-2개 (예: docs/changelog/YYYY-MM/YYYY-MM-DD.md) — 본문 스타일과 톤 파악
3. docs/SETUP.md — 섹션 번호, API 테이블 위치 파악

CLAUDE.md는 읽지 않습니다. (기본 대상이 아니므로 Step 6에서 실수 정정 조건이 만족될 때만 부분적으로 읽습니다.)

Step 4: 날짜별 changelog 파일 생성 + 인덱스 갱신

4a. 파일 경로 결정

• 대상 날짜가 YYYY-MM-DD이면 폴더는 docs/changelog/YYYY-MM/
• 해당 폴더가 없으면 신규 생성
• 파일명:
  • 같은 날 첫 번째 항목: YYYY-MM-DD.md
  • 같은 날 두 번째 이후 항목 (이미 YYYY-MM-DD.md가 있는 경우): 기존 파일을 YYYY-MM-DD-1.md로 rename 후 새 파일을 YYYY-MM-DD-2.md로 생성. 이미 -1, -2 패턴이면 다음 번호로 이어감.

4b. 파일 본문 (기존 entry 스타일 그대로)

## YYYY-MM-DD — 한줄 요약 제목

### 배경

왜 이 변경이 필요했는지 1-2문장.

### 주요 변경

#### 1. 기능/변경 이름 (`커밋해시`)

- 변경 내용 bullet points
- **서버**: 서버 측 변경
- **클라이언트**: 클라이언트 측 변경
- **DB**: 스키마 변경
- **i18n**: 번역 키 추가

### 수정된 주요 파일

| 파일 | 변경 내용 |
|------|----------|
| `path/to/file.ts` | 변경 설명 |

### 아키텍처 결정

1. **결정 이름**: 왜 이렇게 했는지