changelog-manager

# Changelog Manager Skill

## Purpose

This skill manages changelog entries in CHANGELOG.md following the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format with [Calendar Versioning](https://calver.org/).

## Core Capabilities

### 1. Changelog Entry Generation

- Analyze current changes and commits
- Generate appropriate changelog descriptions
- Support Korean and English languages
- Extract ticket IDs from branch names
- Follow Keep a Changelog categories

### 2. Change Analysis

- Review git commits since last release
- Identify changed files and their purposes
- Categorize changes appropriately
- Generate concise but informative descriptions

### 3. Format Compliance

- Maintain Keep a Changelog format
- Use CalVer (YYYY.MM.MICRO) versioning
- Include JIRA ticket linking
- Preserve existing format and conventions

## Versioning Strategy

This plugin uses [Calendar Versioning](https://calver.org/) with format `YYYY.Minor.Patch`.

**Examples**:
- `2026.1.0` - First minor release in 2026
- `2026.1.1` - First patch release
- `2026.2.0` - Second minor release in 2026

## Changelog Categories

Based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/):

- **Added**: New features, endpoints, functionality
- **Changed**: Changes in existing functionality, improvements, updates
- **Fixed**: Bug fixes, error corrections, issue resolutions
- **Deprecated**: Soon-to-be removed features
- **Removed**: Removed features
- **Security**: Security fixes

## Entry Format

```markdown
- [TICKET-ID](JIRA-URL) Description in specified language
```

**Korean Example**:
```markdown
- [SYN-1234](https://jira.example.com/browse/SYN-1234) 사용자 인증 기능 추가
```

**English Example**:
```markdown
- [SYN-1234](https://jira.example.com/browse/SYN-1234) Add user authentication feature
```

## Workflow

### 1. Extract Ticket ID

**From branch name**:
```bash
git branch --show-current
# Example: feature/SYN-1234-user-authentication
# Extract: SYN-1234
```

**Pattern**: `(PROJ-\d+)