# Migration Guides Index

This directory contains migration guides for upgrading between versions and making configuration changes.

## Migration Guides

- **[fix-hardcoded-endpoints.md](fix-hardcoded-endpoints.md)** - Migrate from hardcoded TOKEN_ENDPOINT to dynamic endpoint discovery

## Migration Types

### Configuration Migrations
Guides for updating configuration between versions:
- Environment variable changes
- Configuration file updates
- Feature flag migrations

### Code Migrations
Guides for updating code that uses StarPunk:
- API changes
- Breaking changes
- Deprecated feature replacements

## How to Use Migration Guides

1. **Identify Your Version**: Check current version with `python -c "from starpunk import __version__; print(__version__)"`
2. **Find Relevant Guide**: Look for migration guide for your target version
3. **Follow Steps**: Complete migration steps in order
4. **Test**: Verify system works after migration
5. **Update**: Update version numbers and documentation

## Related Documentation
- **[../standards/versioning-strategy.md](../standards/versioning-strategy.md)** - Versioning guidelines
- **[CHANGELOG.md](../../CHANGELOG.md)** - Version change log
- **[../decisions/](../decisions/)** - ADRs documenting breaking changes

---

**Last Updated**: 2025-11-25
**Maintained By**: Documentation Manager Agent