packwise-skills 1.0.0

package/sub-skills/desktop/game-dev.md

@@ -0,0 +1,443 @@
+# Game Development Build Sub-Skill
+
+For indie games and small game studios. Covers Unity, Unreal Engine, and Godot across desktop, mobile, web, and console platforms.
+
+**Current versions**: Unity 6 (6000.x) / Unreal Engine 5.5 / Godot 4.4 (2025-2026)
+
+---
+
+## Unity Build
+
+### When to Use
+
+2D/3D indie games, cross-platform (desktop + mobile + web + console), small-to-medium teams, AR/VR applications
+
+### Build Flow
+
+```
+File → Build Settings → Select Platform → Player Settings → Build
+```
+
+### Player Settings
+
+| Setting | Windows | macOS | Linux | Android | iOS | WebGL |
+|---------|---------|-------|-------|---------|-----|-------|
+| Scripting Backend | IL2CPP | IL2CPP | IL2CPP | IL2CPP | IL2CPP | IL2CPP |
+| Architecture | x64 + ARM64 | Universal | x64 + ARM64 | ARM64 | ARM64 | N/A |
+| Compression | LZ4HC | LZ4HC | LZ4HC | LZ4HC | LZ4HC | Brotli |
+| API Compat. | .NET Standard 2.1 | .NET Standard 2.1 | .NET Standard 2.1 | .NET Standard 2.1 | .NET Standard 2.1 | .NET Standard 2.1 |
+
+### IL2CPP vs Mono
+
+| Feature | IL2CPP | Mono |
+|---------|--------|------|
+| Performance | Better (AOT compilation) | Standard (JIT) |
+| Build speed | Slow | Fast |
+| Package size | Larger | Smaller |
+| Debugging | Limited | Full |
+| Platform support | All | Limited (no iOS JIT) |
+| **Recommendation** | Release builds | Development/debug |
+
+### Command Line Build
+
+```bash
+# Windows
+Unity -batchmode -nographics -projectPath . -buildTarget StandaloneWindows64 -executeMethod BuildScript.BuildWindows -quit
+
+# macOS
+Unity -batchmode -nographics -projectPath . -buildTarget StandaloneOSX -executeMethod BuildScript.BuildMac -quit
+
+# Linux
+Unity -batchmode -nographics -projectPath . -buildTarget StandaloneLinux64 -executeMethod BuildScript.BuildLinux -quit
+
+# Android (APK)
+Unity -batchmode -nographics -projectPath . -buildTarget Android -executeMethod BuildScript.BuildAndroid -quit
+
+# Android (AAB for Play Store)
+Unity -batchmode -nographics -projectPath . -buildTarget Android -executeMethod BuildScript.BuildAndroidAAB -quit
+
+# iOS (generates Xcode project, requires Mac to finalize)
+Unity -batchmode -nographics -projectPath . -buildTarget iOS -executeMethod BuildScript.BuildiOS -quit
+
+# WebGL
+Unity -batchmode -nographics -projectPath . -buildTarget WebGL -executeMethod BuildScript.BuildWebGL -quit
+```
+
+```csharp
+// Editor/BuildScript.cs
+using UnityEditor;
+using UnityEditor.Build.Reporting;
+using System.Linq;
+
+public static class BuildScript
+{
+    static string[] GetScenes() =>
+        EditorBuildSettings.scenes.Where(s => s.enabled).Select(s => s.path).ToArray();
+
+    public static void BuildWindows()
+    {
+        var report = BuildPipeline.BuildPlayer(GetScenes(), "build/Windows/MyGame.exe",
+            BuildTarget.StandaloneWindows64, BuildOptions.None);
+        if (report.summary.result != BuildResult.Succeeded)
+            throw new System.Exception("Build failed");
+    }
+
+    public static void BuildAndroid()
+    {
+        EditorUserBuildSettings.buildAppBundle = false;
+        var report = BuildPipeline.BuildPlayer(GetScenes(), "build/Android/MyGame.apk",
+            BuildTarget.Android, BuildOptions.None);
+        if (report.summary.result != BuildResult.Succeeded)
+            throw new System.Exception("Build failed");
+    }
+
+    public static void BuildAndroidAAB()
+    {
+        EditorUserBuildSettings.buildAppBundle = true;
+        var report = BuildPipeline.BuildPlayer(GetScenes(), "build/Android/MyGame.aab",
+            BuildTarget.Android, BuildOptions.None);
+        if (report.summary.result != BuildResult.Succeeded)
+            throw new System.Exception("Build failed");
+    }
+
+    public static void BuildiOS()
+    {
+        var report = BuildPipeline.BuildPlayer(GetScenes(), "build/iOS",
+            BuildTarget.iOS, BuildOptions.None);
+        if (report.summary.result != BuildResult.Succeeded)
+            throw new System.Exception("Build failed");
+    }
+}
+```
+
+### Addressables (Asset Management)
+
+```bash
+# Install Addressables package
+# Window → Package Manager → Addressables
+
+# Build addressable content
+AddressableAssetSettings.BuildPlayerContent()
+
+# Use for: DLC, on-demand loading, reduce initial download
+```
+
+### Unity Mobile Builds
+
+#### Android
+
+```bash
+# Prerequisites: JDK 17, Android SDK 34+, NDK r23b+
+# Edit → Preferences → External Tools → set JDK/SDK/NDK paths
+
+# Build settings:
+# - Minimum API Level: 24 (Android 7.0)
+# - Target API Level: 34
+# - Scripting Backend: IL2CPP
+# - Target Architectures: ARM64 (check ARMv7 for older devices)
+```
+
+#### iOS
+
+```bash
+# Requires macOS + Xcode
+# Build generates Xcode project in build/iOS/
+
+cd build/iOS
+xcodebuild -scheme Unity-iPhone -configuration Release -sdk iphoneos archive -archivePath build/MyGame.xcarchive
+
+# TestFlight:
+# Xcode → Archive → Distribute App → App Store Connect → Upload
+```
+
+### Steam Integration
+
+```csharp
+using Steamworks;
+
+void Start() {
+    if (!SteamAPI.Init()) {
+        Debug.LogError("Steam init failed");
+        return;
+    }
+    // Achievements, leaderboards, cloud saves, workshop
+}
+```
+
+```bash
+# Steamworks SDK setup:
+# 1. Download Steamworks SDK from partner.steamgames.com
+# 2. Place steam_appid.txt in project root (contains your App ID)
+# 3. Upload via Steamworks Depot or steamcmd
+```
+
+### Steam / itch.io / Epic Games Store
+
+| Platform | Upload Method | Fee | Revenue Share |
+|----------|--------------|-----|---------------|
+| Steam | Steamworks SDK / SteamPipe | $100 per game | 70% (30% to Valve, drops to 75/25 after $10M) |
+| itch.io | Web upload | Free / pay what you want | You set the share (default 0%) |
+| Epic Games Store | Epic Dev Portal | Free | 88% (12% to Epic) |
+| GOG | GOG Galaxy partner | Free | 70% |
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| IL2CPP build failure | Install Visual Studio Build Tools; check C++ compiler path |
+| Too many shader variants | Use Shader Stripping (Project Settings → Graphics) |
+| Large package | Addressables for on-demand loading; strip unused engines |
+| Black screen on start | Check Graphics API priority (Vulkan/OpenGL/Metal) |
+| Android build: "Unable to find unity activity" | Check Player Settings → Minimum API Level ≥ 24 |
+| iOS build: "Signing requires a development team" | Set Team ID in Xcode; requires Apple Developer account |
+| WebGL memory crash | Reduce texture sizes; use `WebGLMemorySize` setting |
+| Steam overlay not working | Ensure `steam_appid.txt` in build directory; test outside Unity Editor |
+
+---
+
+## Unreal Engine Build
+
+### When to Use
+
+AAA-quality 3D graphics, realistic rendering (Lumen/Nanite), multiplayer (dedicated servers), small-to-medium teams with 3D experience
+
+### Build Flow
+
+```
+Platforms → [Target Platform] → Package Project
+```
+
+### Command Line Build
+
+```bash
+# Build editor and game
+UnrealBuildTool.exe MyGame Win64 Development -Project="C:/MyGame/MyGame.uproject" -WaitMutex -FromMsBuild
+
+# Package for Windows
+RunUAT.bat BuildCookRun -project="C:/MyGame/MyGame.uproject" -noP4 -platform=Win64 -configuration=Shipping -cook -build -stage -pak -archive -archivedirectory="C:/MyGame/build"
+
+# Package for Linux
+RunUAT.bat BuildCookRun -project="C:/MyGame/MyGame.uproject" -noP4 -platform=Linux -configuration=Shipping -cook -build -stage -pak -archive -archivedirectory="C:/MyGame/build"
+
+# Package for Android
+RunUAT.bat BuildCookRun -project="C:/MyGame/MyGame.uproject" -noP4 -platform=Android -configuration=Shipping -cook -build -stage -pak -archive -archivedirectory="C:/MyGame/build"
+
+# Package for iOS
+RunUAT.bat BuildCookRun -project="C:/MyGame/MyGame.uproject" -noP4 -platform=IOS -configuration=Shipping -cook -build -stage -pak -archive -archivedirectory="C:/MyGame/build"
+```
+
+### Platform Configuration
+
+| Platform | Min Specs | Key Settings |
+|----------|-----------|-------------|
+| Windows | Win10 x64, DX12 GPU | RHI: DirectX 12; Ray Tracing (optional) |
+| Linux | Ubuntu 22.04+ | Vulkan RHI; install `libc++1` |
+| Android | API 29+, Vulkan GPU | Android SDK 34, NDK r25b; Vulkan ES 3.1 |
+| iOS | iOS 16+, A12+ chip | Metal RHI; Xcode 15+ |
+| macOS | macOS 13+, M1+ | Metal RHI; Xcode 15+ |
+
+### Key Build Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **Cook** | Process assets into platform-specific formats |
+| **Stage** | Copy cooked content + binaries to staging directory |
+| **Package** | Create distributable build (.exe/.apk/.ipa) |
+| **Pak** | Pack content into `.pak` files for distribution |
+| **Shipping** | Final build config: no debug, fully optimized, no console |
+
+### Optimization
+
+| Technique | Description |
+|-----------|-------------|
+| **Nanite** | Virtualized geometry (millions of polygons, auto-LOD) |
+| **Lumen** | Global illumination + reflections (software or hardware ray tracing) |
+| **World Partition** | Stream large worlds in cells |
+| **Level Streaming** | Load/unload levels dynamically |
+| **Texture Streaming** | Load textures on demand |
+| **Shader Permutation Reduction** | Reduce shader compile time and package size |
+
+### Steam Integration (UE5)
+
+```cpp
+// DefaultEngine.ini
+[OnlineSubsystem]
+DefaultPlatformService=Steam
+
+[OnlineSubsystemSteam]
+bEnabled=true
+SteamDevAppId=480  // Replace with your App ID
+
+[/Script/Engine.GameEngine]
++NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
+```
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Build takes hours | Enable `Editor → Cook on the Fly`; use SSD; increase `MaxParallelActions` |
+| Package too large (10GB+) | Use Pak file compression; remove unused plugins; reduce texture quality levels |
+| Android Vulkan crash | Test on target device; set minimum GPU feature level |
+| iOS provisioning error | Set Team ID in Project Settings → Platforms → iOS → Signing |
+| Shader compilation takes forever | Enable Shader Pipeline Caching; pre-compile shaders |
+| Linux missing .so files | Include Vulkan validation layers; install system dependencies |
+| Memory crash on mobile | Reduce texture resolution; disable Lumen on mobile; use software ray tracing |
+
+---
+
+## Godot Build
+
+### When to Use
+
+2D indie games, lightweight 3D, free and open source, low learning curve, rapid prototyping
+
+### Export Flow
+
+```
+Project → Export → Select Platform → Configure → Export Project
+```
+
+### Command Line Export
+
+```bash
+# Desktop
+godot --headless --export-release "Windows Desktop" build/Windows/MyGame.exe
+godot --headless --export-release "macOS" build/macOS/MyGame.dmg
+godot --headless --export-release "Linux/X11" build/Linux/MyGame.x86_64
+
+# Mobile
+godot --headless --export-release "Android" build/Android/MyGame.apk
+godot --headless --export-release "iOS" build/iOS/MyGame.ipa
+
+# Web
+godot --headless --export-release "Web" build/Web/
+
+# Debug builds (with remote debugging)
+godot --headless --export-debug "Windows Desktop" build/MyGame-debug.exe
+```
+
+### Platform Export Configuration
+
+| Platform | Export Preset | Key Settings |
+|----------|--------------|-------------|
+| Windows | Windows Desktop | Architecture: x86_64; Embed PCK: on |
+| macOS | macOS | Code signing identity; Bundle identifier |
+| Linux | Linux/X11 | Architecture: x86_64 or arm64 |
+| Android | Android | Min SDK 24, Target SDK 34; Keystore; Gradle build |
+| iOS | iOS | Team ID; Bundle identifier; Provisioning profile |
+| Web | Web | Export type: Regular (WASM); Headless: off |
+
+### Android Export Setup
+
+```bash
+# Prerequisites: JDK 17, Android SDK 34+, Gradle 8.x
+
+# In Godot Editor:
+# Editor → Manage Export Templates → Download
+# Export → Android → Set:
+#   - Min SDK: 24
+#   - Target SDK: 34
+#   - Keystore: path to debug.keystore or release keystore
+#   - Gradle Build: Use Gradle Build (recommended)
+```
+
+### iOS Export Setup
+
+```bash
+# Requires macOS + Xcode 15+
+# In Godot Editor → Export → iOS:
+#   - Team ID: your Apple Developer Team ID
+#   - Bundle Identifier: com.yourcompany.mygame
+#   - Provisioning Profile: automatic
+
+# After export, open .xcodeproj in Xcode:
+# Product → Archive → Distribute to TestFlight/App Store
+```
+
+### Web Export Notes
+
+```bash
+# Web export generates:
+# - index.html
+# - MyGame.wasm
+# - MyGame.pck (game data)
+# - MyGame.js (loader)
+
+# Hosting requirements:
+# - Server must send correct MIME type: application/wasm
+# - CORS headers: Cross-Origin-Opener-Policy: same-origin
+# - Cross-Origin-Embedder-Policy: require-corp
+# (Required for SharedArrayBuffer / threads)
+
+# nginx config:
+location ~* \.wasm$ { types { application/wasm wasm; } }
+add_header Cross-Origin-Opener-Policy "same-origin";
+add_header Cross-Origin-Embedder-Policy "require-corp";
+```
+
+### GDScript vs C#
+
+| Feature | GDScript | C# |
+|---------|---------|-----|
+| Performance | Standard | Better (for complex logic) |
+| Package size | Smaller | Larger (needs .NET runtime) |
+| Learning curve | Low | Medium |
+| Ecosystem | Godot native | .NET ecosystem |
+| Web export | Full support | Limited (.NET WASM overhead) |
+| **Recommendation** | 2D games, rapid prototyping | 3D games, C#-experienced teams |
+
+### itch.io Publishing
+
+```bash
+# 1. Export as HTML5 (Web) or Windows/macOS/Linux
+# 2. Zip the build output
+# 3. Upload to itch.io project page
+# 4. Set "This file will be played in the browser" for HTML5
+# 5. Set viewport size to match your game resolution
+```
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Export template missing | Editor → Manage Export Templates → Download |
+| macOS signing | Configure signing identity + entitlements in Export settings |
+| C# build failure | Install correct .NET SDK version (8.0+); `dotnet build` first |
+| Android build: Gradle error | Check JDK 17; Android SDK path in Editor Settings |
+| Web export: blank screen | Check browser console; ensure .wasm MIME type is set |
+| Web export: SharedArrayBuffer error | Set COOP/COEP headers on web server |
+| Large .pck file | Compress textures; use OGG Vorbis for audio; remove unused resources |
+| Touch input not working (mobile) | Enable Touch input in Project Settings → Input Devices |
+
+---
+
+## Engine Selection Guide
+
+| Scenario | Recommended Engine | Why |
+|----------|-------------------|-----|
+| 2D indie game | Godot | Free, lightweight, fast iteration |
+| 2D/3D cross-platform | Unity | Most mature cross-platform pipeline |
+| AAA-quality 3D | Unreal Engine | Nanite, Lumen, best-in-class rendering |
+| Mobile-first game | Unity | Best mobile tooling and performance |
+| Web game | Godot or Unity | Both have good WASM support |
+| AR/VR application | Unity or Unreal | Unity: mobile VR; Unreal: PC VR |
+| Multiplayer game | Unreal Engine | Built-in dedicated server, replication |
+| Game jam / prototype | Godot | Zero cost, fastest setup |
+| Learning game dev | Godot or Unity | GDScript/C# easier than C++ |
+| Console publishing | Unity or Unreal | Both have official console SDK support |
+
+---
+
+## Universal Game Packaging Checklist
+
+1. **Test on target hardware** — not just the development machine
+2. **Strip debug symbols** — reduces package size 30–50%
+3. **Compress textures** — ASTC (mobile), BC7 (desktop), BPTC (VR)
+4. **Audio format** — OGG Vorbis (small), WAV (quality-critical SFX)
+5. **Shader compilation** — pre-compile for target platform to avoid runtime stutters
+6. **Save system** — test save/load across app updates
+7. **Input handling** — support keyboard+mouse, gamepad, and touch where applicable
+8. **Localization** — use engine's i18n system; test text overflow
+9. **Platform-specific** — achievements, leaderboards, cloud saves per platform
+10. **Legal** — EULA, privacy policy, age rating (IARC for stores)

package/sub-skills/desktop/native-app.md

@@ -0,0 +1,123 @@
+# Native Application Build Sub-Skill
+
+For Qt, Flutter, .NET Avalonia frameworks. Suitable for performance-sensitive, system-integrated small-to-medium team projects.
+
+---
+
+## Qt (C++/Python)
+
+**When to use**: IoT control panel, industrial software, audio/video tools, database clients
+
+### Build
+
+```bash
+# CMake project
+mkdir build && cd build
+cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=/path/to/qt
+cmake --build . --config Release -j$(nproc)
+```
+
+### Deploy
+
+```bash
+windeployqt release/MyApp.exe          # Windows
+macdeployqt MyApp.app -dmg             # macOS
+linuxdeployqt MyApp.AppImage           # Linux
+```
+
+### Python PyQt
+
+```bash
+pyinstaller --onefile --windowed app.py
+# or Nuitka (better performance)
+python -m nuitka --standalone --enable-plugin=pyqt5 --onefile app.py
+```
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Missing DLL | windeployqt didn't copy, manually add |
+| High DPI blurry | `AA_EnableHighDpiScaling` |
+| LGPL compliance | Dynamic linking or buy commercial license |
+
+---
+
+## Flutter Desktop (3.44.x / Dart 3.12.x)
+
+**When to use**: Existing Flutter mobile project, need unified mobile + desktop UI. Single codebase for mobile, web, and desktop. Impeller rendering engine now default on all platforms.
+
+### Build
+
+```bash
+flutter config --enable-windows-desktop
+flutter config --enable-macos-desktop
+flutter config --enable-linux-desktop
+
+flutter create --platforms=windows,macos,linux my_app
+flutter build windows
+flutter build macos    # Universal Binary
+flutter build linux
+```
+
+### Package
+
+```bash
+# Windows MSIX
+flutter pub add msix
+flutter pub run msix:create
+
+# macOS DMG
+create-dmg build/macos/Build/Products/Release/MyApp.app
+
+# Linux AppImage
+appimagetool MyApp.AppDir MyApp.AppImage
+```
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Windows missing MSVC | Install Visual Studio Build Tools |
+| Linux missing deps | sudo apt install clang cmake ninja-build libgtk-3-dev |
+| Font differences | Embed custom fonts |
+
+---
+
+## .NET Avalonia / MAUI
+
+**When to use**: C#/.NET teams, enterprise internal tools, Windows-first
+
+### Avalonia
+
+```bash
+dotnet new install Avalonia.Templates
+dotnet new avalonia.app -n MyApp
+dotnet publish -c Release -r win-x64 --self-contained
+dotnet publish -c Release -r osx-arm64 --self-contained
+dotnet publish -c Release -r linux-x64 --self-contained
+```
+
+### MAUI
+
+```bash
+dotnet new maui -n MyApp
+dotnet build -t:Publish -f net9.0-windows10.0.19041.0
+```
+
+### Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Runtime missing | `--self-contained` publish |
+| macOS signing | Apple Developer ID |
+
+---
+
+## Selection Guide
+
+| Scenario | Recommended | Size |
+|----------|------------|------|
+| High performance / embedded / industrial | Qt | 30–80MB |
+| Mobile + desktop unified | Flutter | 20–50MB |
+| C#/.NET team | Avalonia | 30–60MB |