docs: update AGENTS.md and README.md with semantic release information

- Update project status to v1.2.0
- Add semantic release workflow documentation
- Document automated PR title management
- Add conventional commit guidelines
- Update repository structure with new GitHub workflows
- Remove AGENTS.md reference from README (agent-only file)
- Add manual CHANGELOG.md for immediate reference

Author: wiiiimm

AGENTS.md

@@ -4,12 +4,14 @@
 
 **ra2mp3** is a cross-platform bash script that converts RealAudio (.ra) files to MP3 format using FFmpeg. This project was created to help users migrate legacy audio files to a modern, widely-supported format.
 
-### Current Status: v1.1.0 (Production Ready)
+### Current Status: v1.2.0 (Production Ready)
 - ✅ Full feature implementation complete
 - ✅ Cross-platform support (macOS/Linux) 
 - ✅ Comprehensive testing with real RealAudio files
 - ✅ Unicode and special character support
 - ✅ Advanced command-line options
+- ✅ Semantic release automation and CI/CD workflows
+- ✅ Automated changelog generation and PR title management
 
 ## Repository Structure
 
@@ -18,9 +20,18 @@ ra2mp3/
 ├── ra2mp3                 # Main conversion script (bash)
 ├── install_macos.sh       # macOS installer (Homebrew + FFmpeg)
 ├── install_linux.sh       # Linux installer (multi-distro support)
+├── package.json           # NPM package config for semantic-release
+├── CHANGELOG.md           # Generated changelog (semantic-release)
 ├── README.md              # User documentation
 ├── LICENSE                # MIT License
+├── CLAUDE.md              # Minimal redirect to this file
 ├── .gitignore             # Git ignore patterns
+├── .github/
+│   ├── workflows/
+│   │   ├── automated-release.yml    # Semantic release on main push
+│   │   └── pr-title-manager.yml     # PR title automation
+│   └── scripts/
+│       └── normalize-pr-title.js    # PR title normalization logic
 ├── AGENTS.md              # This file - project memory/instructions
 ├── tests/                 # Test RealAudio files (gitignored)
 └── converted/             # Output directory (gitignored)
@@ -29,9 +40,10 @@ ra2mp3/
 ## Core Features
 
 ### Main Script (`ra2mp3`)
-- **Version:** 1.1.0
+- **Version:** 1.2.0
 - **Language:** Bash with strict error handling (`set -euo pipefail`)
 - **Dependencies:** FFmpeg with libmp3lame support
+- **Supported formats:** .ra, .ram, .rm (case-insensitive)
 - **Encoding:** VBR quality 2 (~170-210 kbps)
 
 ### Command-Line Options
@@ -85,9 +97,10 @@ chmod +x ra2mp3
 
 ### Version Management
 - **Format:** Semantic versioning (MAJOR.MINOR.PATCH)
-- **Current:** 1.1.0
-- **Update locations:** All 3 scripts (ra2mp3, install_macos.sh, install_linux.sh)
-- **Git tags:** Create matching tag (e.g., `git tag v1.1.0`)
+- **Current:** 1.2.0
+- **Automation:** semantic-release handles version bumping and git tags
+- **Update locations:** All 3 scripts (ra2mp3, install_macos.sh, install_linux.sh) + package.json
+- **Release process:** Automated via GitHub Actions on main branch push
 
 ### Code Standards
 - **Bash style:** Strict error handling, proper quoting, consistent indentation
@@ -109,24 +122,36 @@ chmod +x ra2mp3
 - **Feature branches:** For major changes (optional for small fixes)
 
 ### Commit Message Format
+Follow [Conventional Commits](https://www.conventionalcommits.org/) specification:
 ```
-Brief description of change
+<type>[optional scope]: <description>
 
-Detailed explanation if needed:
-- Bullet points for multiple changes
-- Reference issue numbers if applicable
+[optional body]
 
-🤖 Generated with [Claude Code](https://claude.ai/code)
-
-Co-Authored-By: Claude <[email protected]>
+[optional footer(s)]
 ```
 
-### Release Process
-1. Update version in all 3 scripts
-2. Update AGENTS.md if needed
-3. Commit with descriptive message
-4. Create git tag: `git tag vX.Y.Z`
-5. Push everything: `git push && git push origin vX.Y.Z`
+**Types:** feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+
+**Examples:**
+- `feat: add support for .ram and .rm file formats`
+- `fix: handle unicode characters in filenames properly`
+- `docs: update installation instructions for Linux`
+
+### Automated Release Process
+1. **PR Creation:** Titles automatically formatted to conventional commits
+2. **Main Branch Push:** Triggers semantic-release workflow
+3. **Version Calculation:** Based on commit types (feat = minor, fix = patch)
+4. **CHANGELOG.md:** Generated automatically from commits
+5. **GitHub Release:** Created with release notes
+6. **Git Tags:** Applied automatically
+
+### Manual Release Override
+If needed for hotfixes:
+1. Update version in all 3 scripts + package.json
+2. Update CHANGELOG.md manually
+3. Create conventional commit
+4. Push to main branch (triggers automated release)
 
 ## GitHub Repository
 
@@ -210,5 +235,5 @@ When working on this project:
 
 ---
 
-*Last updated: 2025-08-31 (v1.1.0)*
+*Last updated: 2025-08-31 (v1.2.0)*
 *Remember to update this file when making significant changes to the project.*

CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Semantic release automation with changelog generation
+- PR title manager workflow for conventional commits
+- Automated version bumping and GitHub releases
+- Support for `.ram` and `.rm` RealAudio file extensions
+- Comprehensive project documentation in AGENTS.md
+
+### Changed
+- Updated to version 1.2.0 with enhanced file format support
+- Improved workflow automation for development
+
+## [1.1.0] - 2023-XX-XX
+
+### Added
+- Command-line options: `--input`, `--output`, `--overwrite`, `--dry-run`
+- Help (`-h`, `--help`) and version (`-v`, `--version`) flags
+- Enhanced error handling and progress tracking
+- Improved testing workflow with dedicated test directories
+
+### Changed
+- Renamed main script from `convert_ra_to_mp3.sh` to `ra2mp3`
+- Updated installation scripts for better user experience
+- Improved documentation and usage instructions
+
+### Fixed
+- Better handling of nested directory structures
+- More robust file processing with error recovery
+
+## [1.0.0] - 2023-XX-XX
+
+### Added
+- Initial release of ra2mp3 conversion tool
+- Support for `.ra` RealAudio file conversion to MP3
+- Cross-platform installation scripts (macOS and Linux)
+- Automatic dependency management (FFmpeg, Homebrew)
+- Recursive directory processing
+- Color-coded output with progress indicators
+- MIT license
+- Comprehensive README with installation and usage instructions
+
+### Features
+- Batch conversion of RealAudio files
+- Preserves directory structure in output
+- Handles Unicode characters in filenames
+- Automatic FFmpeg installation via package managers
+- Cross-platform compatibility (macOS, Linux)
+
+[Unreleased]: https://github.com/wiiiimm/ra2mp3/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/wiiiimm/ra2mp3/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/wiiiimm/ra2mp3/releases/tag/v1.0.0

README.md

@@ -195,9 +195,33 @@ The script uses FFmpeg's libmp3lame encoder with VBR quality setting 2, which pr
 
 MIT License - feel free to use, modify, and distribute as needed.
 
-## Contributing
-
-Issues and pull requests welcome! This is a simple tool but improvements are always appreciated.
+## Development
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/) and [semantic-release](https://semantic-release.gitbook.io/) for automated versioning and releases.
+
+### Semantic Release
+- Automatic version bumping based on commit messages
+- Automated CHANGELOG.md generation
+- GitHub releases with release notes
+- Follows semantic versioning (MAJOR.MINOR.PATCH)
+
+### Pull Request Guidelines
+- PR titles are automatically formatted to conventional commit format
+- Use conventional commit types: `feat:`, `fix:`, `docs:`, `chore:`, etc.
+- Breaking changes should include `!` or `BREAKING CHANGE:` in commit message
+- All PRs include `[skip ci]` to prevent premature deployments
+
+### Contributing
+Issues and pull requests welcome! This project includes automated workflows for:
+- PR title formatting and validation
+- Automated releases and changelog generation
+- Code quality checks
+
+When contributing:
+- Use conventional commit messages (feat:, fix:, docs:, etc.)
+- PR titles are automatically formatted
+- Releases are automated based on commit types
+- See [CHANGELOG.md](./CHANGELOG.md) for release history
 
 ## About RealAudio