changelog

name	changelog
description	Record current session changes to CHANGELOG.md
user-invocable	true
handoffs	["When finished logging changes, suggest running tests or committing"]

Changelog Recording Skill

Purpose

이 스킬은 현재 세션의 변경사항을 체계적으로 기록합니다:

• 사용자 프롬프트 내용
• 변경된 파일 목록 및 상세 내용
• 테스트 결과 (있을 경우)
• 브랜치 정보

Usage

/changelog "변경 내용 요약"

예시:

/changelog "TC-API-001 테스트 5개 추가"
/changelog "DB 설정 파일 업데이트"
/changelog "티켓 생성 API 구현 완료"

Workflow

1. Parse Arguments

사용자가 제공한 변경 요약을 파싱합니다:

• 요약이 없으면 사용자에게 요청
• 요약은 간결하게 (1-2 문장)

2. Analyze Current Session

현재 git 상태를 분석합니다:

# Staged files 확인
git diff --cached --name-status

# Unstaged files 확인
git diff --name-status

# 현재 브랜치
git branch --show-current

# 변경 라인 수
git diff --cached --stat
git diff --stat

3. Extract Session Prompts

현재 세션의 사용자 프롬프트를 대화 컨텍스트에서 추출:

• 모든 사용자 프롬프트 원문을 시간순으로 수집
• 슬래시 커맨드(/changelog 자체 등)는 제외
• 짧은 확인 응답("ㅇㅇ", "ㄱㄱ", "yes" 등)은 제외
• IDE 선택 컨텍스트(@파일명)는 프롬프트에 포함하여 기록

4. Generate CHANGELOG Entry

다음 형식으로 changelog 엔트리 생성:

## [브랜치명] - YYYY-MM-DD HH:MM

### 🎯 Prompts
1. "첫 번째 사용자 프롬프트 원문"
2. "두 번째 사용자 프롬프트 원문"
3. "세 번째 사용자 프롬프트 원문"

### ✅ Changes
- **Added**: 새로운 기능/파일 (`파일경로`)
- **Modified**: 수정된 내용 (`파일경로`)
- **Fixed**: 버그 수정 (`파일경로`)
- **Removed**: 삭제된 내용 (`파일경로`)

### 📊 Test Results (Optional)
- Total: X/Y passed (Z%)
- Coverage: 관련 테스트 케이스

### 📁 Files Modified
- `경로/파일1.ts` (+10, -2 lines)
- `경로/파일2.ts` (+5, -1 lines)

### 🌿 Branches (if multi-branch)
- `브랜치1` (commit: abc1234)
- `브랜치2` (commit: def5678)

---

5. Update CHANGELOG.md

CHANGELOG.md 파일 처리:

파일이 없으면:

# Tika Development Changelog

> 이 문서는 Tika 프로젝트의 개발 히스토리를 기록합니다.
> 각 엔트리는 프롬프트, 변경사항, 영향받은 파일을 포함합니다.

[새 엔트리 추가]

파일이 있으면:

• 새 엔트리를 최상단에 추가 (시간 역순)
• 같은 날짜 내에서는 최신이 위로

6. Report to User

생성된 changelog 엔트리를 사용자에게 보여주고:

📝 Changelog 엔트리가 생성되었습니다:

[생성된 내용 미리보기]

다음 파일이 업데이트되었습니다:
- CHANGELOG.md (새 엔트리 추가)

staged 파일에 추가하시겠습니까? (yes/no)

7. Optional Auto-commit

사용자가 원하면 자동 커밋:

# 파일 staging
git add CHANGELOG.md

# 커밋 (선택사항)
git commit -m "docs: Update changelog - [요약]

Co-Authored-By: Claude Sonnet 4.5 <[e-mail]>"

Implementation Notes

Helper Script

.specify/scripts/bash/generate-changelog.sh 스크립트 사용:

• git diff 파싱
• 변경 파일 목록 추출
• 라인 수 계산
• 날짜/시간 포맷팅

Error Handling

• git 저장소가 아니면 에러
• 변경사항이 없으면 경고
• 요약이 너무 길면 경고 (200자 제한)

Edge Cases

• Merge conflicts: 경고 후 수동 해결 요청
• Detached HEAD: 경고 표시
• No changes: "변경사항이 없습니다" 메시지

Examples

Example 1: Single File Change

# 사용자 입력
/changelog "빈 제목 검증 테스트 추가"

# 생성된 엔트리
## [001-create-ticket-api] - 2026-02-13 14:30

### 🎯 Prompts
1. "TC-API-001에 빈 제목 검증 테스트 추가해줘"

### ✅ Changes
- **Added**: Empty title validation test (`__tests__/api/tickets.test.ts:95`)

### 📁 Files Modified
- `__tests__/api/tickets.test.ts` (+17, -0 lines)

---

Example 2: Multi-File, Multi-Branch

# 사용자 입력
/changelog "DB 설정 파일 3개 브랜치에 추가"

# 생성된 엔트리
## [chapter5.1-init] - 2026-02-13 10:15

### 🎯 Prompts
1. ".env 파일들을 3개 브랜치(chapter4.4.5, chapter5.1-SDD, chapter5.1-init)에 푸시해줘"
2. "jest.setup.ts에서 ticketService mock 제거해"

### ✅ Changes
- **Modified**: `.env.local` - DB 인증 정보 추가
- **Modified**: `.env.test` - DB 인증 정보 추가
- **Added**: `.env.example` - 템플릿 생성
- **Modified**: `jest.setup.ts` - ticketService mock 제거 (chapter5.1-init만)

### 🌿 Branches Updated
- `chapter4.4.5` (commit: a825f9c)
- `chapter5.1-SDD` (commit: 2988021)
- `chapter5.1-init` (commit: f6e7609, c512b3c)

### 📁 Files Modified
- `.env.local` (+1, -1 lines)
- `.env.test` (+1, -1 lines)
- `.env.example` (+4, -0 lines)
- `jest.setup.ts` (+3, -1 lines)

---

Example 3: With Test Results

# 사용자 입력
/changelog "TC-API-001 전체 테스트 완료"

# 생성된 엔트리
## [001-create-ticket-api] - 2026-02-13 16:45

### 🎯 Prompts
1. "TC-API-001의 누락된 5개 테스트를 추가해줘"
2. "npm test 실행해서 결과 보여줘"

### ✅ Changes
- **Added**: 빈 제목 검증 테스트 (`__tests__/api/tickets.test.ts:95`)
- **Added**: 공백만 제목 검증 테스트 (`__tests__/api/tickets.test.ts:113`)
- **Added**: 설명 1000자 초과 검증 테스트 (`__tests__/api/tickets.test.ts:149`)
- **Added**: position 순서 검증 테스트 (`__tests__/api/tickets.test.ts:208`)
- **Added**: startedAt/completedAt 초기값 검증 테스트 (`__tests__/api/tickets.test.ts:224`)

### 📊 Test Results
- Total: 11/11 passed (100%)
- Coverage: TC-API-001 완료

### 📁 Files Modified
- `__tests__/api/tickets.test.ts` (+85, -0 lines)

---

Handoffs

이 스킬 실행 후 제안:

1. 테스트 실행: 변경사항이 코드일 경우

   npm run test
   

2. 커밋 생성: changelog만 업데이트한 경우

   git commit -m "docs: Update changelog - [요약]"
   

3. 전체 커밋: 코드 + changelog 함께

   git add .
   git commit -m "feat: [기능 요약]
   
   Co-Authored-By: Claude Sonnet 4.5 <[e-mail]>"
   

Related Skills

• /commit: Git 커밋 생성 (changelog 자동 호출 가능)
• /review-pr: PR 리뷰 (changelog 참조)
• /speckit.implement: 구현 완료 후 changelog 기록