chore: release api v0.3.2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

AGENTS.md

@@ -184,18 +184,28 @@ cat ../webber-sandbox/TASKS.md
 ## Versioning & Releases
 
 Uses prefixed tags:
-- `api/v0.3.0` → Triggers API Docker build
+- `api/vX.Y.Z` → Triggers API Docker build
-- `cli/v0.1.0` → Triggers CLI build (future)
+- `cli/vX.Y.Z` → Triggers CLI build (future)
+
+### MANDATORY Release Procedure
+
+**NEVER push a tag before updating version files.** Follow this exact order:
 
 ```bash
-# API release
+# 1. Update version in pyproject.toml
-cd webber-api
+# 2. Update CHANGELOG.md with release notes
-# Update version in pyproject.toml
+# 3. Commit the version bump
-git add -A && git commit -m "chore: release api v0.3.0"
+git add -A && git commit -m "chore: release api vX.Y.Z"
-git tag api/v0.3.0
+
+# 4. Create the tag (AFTER the commit)
+git tag api/vX.Y.Z
+
+# 5. Push everything together
 git push origin main --tags
 ```
 
+**Why this matters:** Pushing a tag before the version commit requires deleting and recreating the tag, which can trigger CI/CD pipelines prematurely and cause deployment issues.
+
 ---
 
 ## Troubleshooting

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-01-11
+
+### Added
+- Mandatory release procedure documentation in AGENTS.md
+
 ## [0.3.1] - 2026-01-11
 
 ### Added

webber-api/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webber-api"
-version = "0.3.1"
+version = "0.3.2"
 description = "Webber API - Multi-Agent AI Development Server"
 authors = [
     {name = "jpmschweitzer"}