diff --git a/CLAUDE.md b/CLAUDE.md
index 3e382e9..dc7857d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -280,6 +280,32 @@ add_action( 'wp_prometheus_collect_metrics', function( $collector ) {
 
 ## Session History
 
+### 2026-02-01 - CI/CD Fixes (v0.0.2)
+
+- Fixed composer.json dependency configuration for CI compatibility
+- **Key Learning**: Git submodules with path repositories need explicit version aliases for CI:
+
+  ```json
+  "repositories": [
+      {
+          "type": "path",
+          "url": "lib/wc-licensed-product-client",
+          "options": {
+              "symlink": false,
+              "versions": {
+                  "magdev/wc-licensed-product-client": "0.2.2"
+              }
+          }
+      }
+  ]
+  ```
+
+- Using `dev-main` constraints with `minimum-stability: dev` causes issues in CI
+- Path repository with `symlink: false` and explicit `versions` mapping works reliably
+- **Key Learning**: Gitea API returns "Release has no Tag" error when re-releasing existing tags
+- Fixed release.yml to check for and delete existing releases before creating new ones
+- Changed minimum-stability back to stable
+
 ### 2026-02-01 - Initial Setup (v0.0.1)
 
 - Created initial plugin structure based on wp-fedistream blueprint