diff --git a/CLAUDE.md b/CLAUDE.md
index f1099199..2c1c2094 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -146,7 +146,18 @@ PostGIS integration handles geometric calculations. Coordinate system defaults t
 - WebSocket push throttling: 1000ms to prevent frontend overload
 - Redis caching with 60-second expiration for real-time data
 
-## API Access
+## Version Management
+
+### Version Control Files
+- **VERSION.md**: Contains current version number (semantic versioning)
+- **changelog.md**: Detailed change log following Keep a Changelog format
+
+### Version Update Process
+When making significant changes:
+1. Update version number in VERSION.md
+2. Add detailed changelog entry in changelog.md
+3. Include version update in commit message
+4. Use semantic versioning (MAJOR.MINOR.PATCH)
 
 - **Admin Interface**: http://localhost:8080
 - **API Documentation**: http://localhost:8080/swagger-ui/index.html