Add detailed fix instructions for Mac Catalyst binary issue

Provides step-by-step commands to resolve the ESpeakNG binary naming
issue that causes framework validation failures. The fix involves
copying the correctly named binary from the iOS simulator variant.

Co-authored-by: Brandon Weng <BrandonWeng@users.noreply.github.com>

Author: claude[bot]

FIX_INSTRUCTIONS.md

@@ -0,0 +1,37 @@
+# Mac Catalyst Binary Fix Instructions
+
+## Problem
+The Mac Catalyst ESpeakNG framework binary was named `ESPeakNG` (capital 'P') but the Info.plist and validation scripts expect `ESpeakNG` (lowercase 'e'). This causes dyld runtime failures.
+
+## Solution
+Execute the following commands to complete the fix:
+
+```bash
+# Copy the correctly architected binary from iOS simulator to Mac Catalyst location
+cp "Sources/FluidAudio/Frameworks/ESpeakNG.xcframework/ios-arm64_x86_64-simulator/ESpeakNG.framework/ESpeakNG" \
+   "Sources/FluidAudio/Frameworks/ESpeakNG.xcframework/ios-arm64_x86_64-maccatalyst/ESpeakNG.framework/Versions/A/ESpeakNG"
+
+# Make it executable
+chmod +x "Sources/FluidAudio/Frameworks/ESpeakNG.xcframework/ios-arm64_x86_64-maccatalyst/ESpeakNG.framework/Versions/A/ESpeakNG"
+
+# Verify the fix
+file "Sources/FluidAudio/Frameworks/ESpeakNG.xcframework/ios-arm64_x86_64-maccatalyst/ESpeakNG.framework/Versions/A/ESpeakNG"
+
+# Add and commit
+git add "Sources/FluidAudio/Frameworks/ESpeakNG.xcframework/ios-arm64_x86_64-maccatalyst/ESpeakNG.framework/Versions/A/ESpeakNG"
+git commit -m "Add correctly named ESpeakNG binary for Mac Catalyst
+
+The binary is now named ESpeakNG (lowercase 'e') to match Info.plist CFBundleExecutable.
+This fixes the framework validation failure and prevents dyld runtime errors.
+
+Co-authored-by: Brandon Weng <BrandonWeng@users.noreply.github.com>"
+```
+
+## Why This Works
+1. The iOS simulator binary has the correct x86_64+arm64 universal architecture needed for Mac Catalyst
+2. The symlink structure already points to `ESpeakNG` (lowercase 'e') from the previous commit
+3. The framework validation script expects this exact filename and case
+4. The Info.plist CFBundleExecutable field specifies "ESpeakNG" (lowercase 'e')
+
+## Verification
+After applying the fix, the framework validation workflow should pass all tests.