Add Changelog Command

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.

This plugin uses Calendar Versioning 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:

• 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 principles

Unreleased Section Format

## [Unreleased] - yyyy-mm-dd

### Added

### Changed

### Fixed

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