diff --git a/CLAUDE.md b/CLAUDE.md
index 1f8f4b5..30d780e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1200,8 +1200,8 @@ The plugin architecture is solid and well-tested. Most bugs arise from:
    - All 7 language files updated and compiled
 
 6. Created release package:
-   - Package size: 745KB
-   - 642 files included
+   - Package size: 775KB (after proper exclusions)
+   - 650 files included
    - SHA256 checksum generated
 
 7. Updated README.md:
@@ -1209,6 +1209,10 @@ The plugin architecture is solid and well-tested. Most bugs arise from:
    - Updated PHP requirement to 8.3
    - Added v1.3.0 and v1.3.1 changelog entries
 
+8. Re-released v1.3.1:
+   - Fixed release package exclusions (vendor .git dirs were included)
+   - Added `.claude/settings.json` to .gitignore
+
 **Key Learnings:**
 
 - `SecureLicenseClient` requires `serverSecret` parameter for HMAC verification
@@ -1216,6 +1220,13 @@ The plugin architecture is solid and well-tested. Most bugs arise from:
 - `RateLimitExceededException` has a `retryAfter` property (int seconds)
 - Always check library documentation in `docs/server-implementation.md` for implementation requirements
 
+**Release Package Learnings (CRITICAL):**
+
+- Vendor directories installed via Composer (dev-main) contain their own `.git/` folders
+- Release exclusion patterns must include `'wc-tier-and-package-prices/vendor/*/.git/*'` and `'wc-tier-and-package-prices/vendor/*/CLAUDE.md'`
+- Run zip from `/home/magdev/workspaces/php/wordpress/wp-content/plugins/` (NOT `/home/magdev/workspaces/php/`)
+- Always verify exclusions with: `unzip -l package.zip | grep -E "\.git/|CLAUDE\.md"`
+
 ---
 
 Always refer to this document when starting work on this project. Good luck!