# Add Changelog Command

> Run the `platform-dev-team-common:add-changelog` workflow from the original Claude slash command. Use when the user asks to add a changelog entry to CHANGELOG.md in the Unreleased section following Keep a Changelog format with CalVer versioning.

- Skill: `datamaker-kr/add-changelog-command` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datamaker-kr/add-changelog-command`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datamaker-kr/add-changelog-command/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: datamaker-kr (https://skillmd.com/u/datamaker-kr)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/datamaker-kr/add-changelog-command

---


<!-- Generated by tools/generate-agent-marketplaces.py; edit the source command or agent-plugin.yaml instead. -->

# platform-dev-team-common:add-changelog Command Workflow

## Codex Adaptation

- Treat the user request or explicitly supplied text as the command arguments.
- Use the available Codex file, search, terminal, and clarification capabilities that match the workflow.
- Do not depend on Claude-only slash command variables or tool names.

# Add Changelog Command

You will help the user add a changelog entry to the CHANGELOG.md file in the Unreleased section.

## Versioning Strategy

This project follows the guidelines from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

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

- Example: `2026.1.0`, `2026.1.1`, `2026.2.0`

## Available Options

- `--type <category>`: Changelog category (added/changed/fixed, default: added)
- `--lang <language>`: Description language (korean/english, default: korean)
- `--ticket <id>`: Ticket ID (optional, will try to extract from branch name if not provided)

## Examples

- `/add-changelog --type added --lang ko`: Add entry to "Added" section in Korean
- `/add-changelog --type fixed --lang eng`: Add entry to "Fixed" section in English
- `/add-changelog --ticket SYN-1234 --type changed`: Add entry with specific ticket ID
- `/add-changelog`: Add entry to "Added" section in Korean (default)

## Implementation

1. Extract ticket ID from branch name or use provided ticket
2. Analyze current changes and commits to understand the scope
3. Generate appropriate changelog description in specified language
4. Add entry to the correct section in CHANGELOG.md under [Unreleased]
5. Follow existing changelog format and conventions

## 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 (if applicable)
- **Removed**: Removed features (if applicable)
- **Security**: Security fixes (if applicable)

## Format Guidelines

- Follow existing format: `- [TICKET-ID](JIRA-URL) Description`
- Keep descriptions concise but informative
- Use appropriate language (Korean/English)
- Maintain chronological order (newest first in each section)
- Ensure proper JIRA ticket linking
- Follow [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) principles

## Unreleased Section Format

```markdown
## [Unreleased] - yyyy-mm-dd

### Added

### Changed

### Fixed
```

Please provide the changelog type and language, or use defaults for "added" and Korean.