docs: consolidate and optimize .github documentation

Squashed merge of 5 documentation improvement commits.

Changes:
- CONTRIBUTING.md: Remove duplicated standards (-25 lines)
- RELEASE.md: Streamline with tables, reduce verbosity (-16 lines)
- copilot-instructions.md: Remove circular references (-5 lines)
- instructions: Consolidate 3 files → 1 (code-conventions.instructions.md)
  - Remove 6 duplicate rules with copilot-instructions.md
  - Keep only 11 actionable layer-specific constraints
  - Fix format: standard YAML frontmatter, no code wrapper

Result: 171 lines → 125 lines (-46, -27%)
- Single source of truth for each constraint
- Clearer information hierarchy
- Follows Markdown best practices

Author: wysaid

.github/CONTRIBUTING.md

@@ -11,54 +11,27 @@
 ## Code Standards
 
 - Use **English** for all code comments, commit messages, and PR descriptions
-- Follow conventional-commit format for commits: `feat:`, `fix:`, `refactor:`, `chore:`
+- Follow conventional-commit format: `feat:`, `fix:`, `refactor:`, `chore:`
 - One logical change per commit
-
-### C++ (Native)
-
-- Follow `.clang-format` (Allman braces, 4-space indent)
-- All code in `namespace CGE {}`
-- No C++ exceptions (compiled with `-fno-exceptions`)
-- Use logging macros: `CGE_LOG_INFO`, `CGE_LOG_ERROR`, `CGE_LOG_KEEP`
-- Inline GLSL via `CGE_SHADER_STRING_PRECISION_H()` / `CGE_SHADER_STRING_PRECISION_M()`
-- Release GL resources (programs, textures, FBOs) along the handler lifecycle
-
-### Java (Android)
-
-- GL operations in `GLSurfaceView` subclasses must use `queueEvent(...)`
-- Load native libraries through `NativeLibraryLoader` only
-- Check `BuildConfig.CGE_USE_VIDEO_MODULE` before referencing FFmpeg classes
-
-### JNI Bridge
-
-- JNI function names: `Java_org_wysaid_nativePort_<Class>_<method>`
-- Always validate JNI parameters (null checks) before dereferencing
-- Never store JNI local references across calls
+- Detailed code style rules are automatically applied by file path — see `.github/instructions/`
 
 ## Compatibility Rules
 
+These are **hard constraints** for the public API:
+
 - **Do not change** method signatures in `org.wysaid.nativePort.*`
 - **Do not change** existing JNI function names
 - **Do not change** existing filter rule string syntax
 - New methods, filters, and syntax additions are welcome
 
-## FFmpeg / Video Module
-
-All FFmpeg-dependent code must be optional:
-
-- C++: guard with `#ifdef CGE_USE_VIDEO_MODULE`
-- Java: check `BuildConfig.CGE_USE_VIDEO_MODULE`
-- Verify the project compiles with `--disable-video-module`
+## Key Constraints
 
-## Dual Build System
+- **FFmpeg/Video Module**: All video-related code must be optional — verify builds work with `--disable-video-module`
+- **Dual Build**: When adding native files, CMake auto-discovers via `GLOB_RECURSE`, but `Android.mk` requires explicit listing
+- **Thread Safety**: GL operations must run on the GL thread (`queueEvent(...)` in Java)
 
-When adding new native source files under `library/src/main/jni/`:
-
-- **CMake**: auto-discovered via `GLOB_RECURSE` — usually no action needed
-- **ndk-build**: update `Android.mk` to explicitly list the new files
+See `copilot-instructions.md` for detailed project conventions.
 
 ## CI
 
-Pull requests trigger CI on three platforms (macOS, Ubuntu, Windows). PRs run a reduced matrix (1 combination per platform); merges to `master` run the full 16-combination matrix.
-
-Ensure all CI checks pass before requesting review.
+PRs trigger CI on three platforms (macOS, Ubuntu, Windows) with a reduced matrix. Merges to `master` run the full 16-combination matrix. Ensure all checks pass before requesting review.

.github/RELEASE.md

@@ -1,56 +1,41 @@
 # Release Process
 
-This project uses an automated release workflow triggered by version tags.
+Automated release triggered by version tags (`v*.*.*`).
 
 ## Creating a Release
 
-### 1. Update the Version
+1. **Update** `versionName` in [build.gradle](../build.gradle) (e.g., `"3.1.1"`)
+2. **Commit, tag, and push**:
 
-Edit `versionName` in `build.gradle`:
+   ```bash
+   git add build.gradle
+   git commit -m "chore: bump version to 3.1.1"
+   git tag v3.1.1
+   git push && git push origin v3.1.1
+   ```
 
-```gradle
-ext {
-    android = [
-        ...
-        versionName: "3.1.1",
-        ...
-    ]
-}
-```
-
-### 2. Commit and Push
-
-```bash
-git add build.gradle
-git commit -m "chore: bump version to 3.1.1"
-git push
-```
-
-### 3. Tag and Push
-
-```bash
-git tag v3.1.1
-git push origin v3.1.1
-```
+**Important**: Tag version must exactly match `versionName` in `build.gradle`.
 
 ## Automated Workflow
 
-When a tag matching `v*.*.*` is pushed, the [release workflow](../.github/workflows/release.yml) will:
+The [release workflow](../.github/workflows/release.yml) builds and publishes:
+
+| Artifact | FFmpeg | Page Size |
+| --- | --- | --- |
+| `gpuimage-plus-{version}.aar` | ✅ | 4KB |
+| `gpuimage-plus-{version}-16k.aar` | ✅ | 16KB |
+| `gpuimage-plus-{version}-min.aar` | ❌ | 4KB |
+| `gpuimage-plus-{version}-16k-min.aar` | ❌ | 16KB |
 
-1. **Validate** that the tag version matches `versionName` in `build.gradle`
-2. **Build** four AAR variants:
-   - `gpuimage-plus-{version}.aar` — Full with FFmpeg, 4KB page size
-   - `gpuimage-plus-{version}-16k.aar` — Full with FFmpeg, 16KB page size
-   - `gpuimage-plus-{version}-min.aar` — Image-only, 4KB page size
-   - `gpuimage-plus-{version}-16k-min.aar` — Image-only, 16KB page size
-3. **Build** the demo APK (with video module)
-4. **Create** a GitHub release with all artifacts and release notes
+Plus demo APK with video module enabled.
 
 ## Tag Format
 
-- Official: `v3.1.1`
-- Beta: `v3.1.1-beta1`
-- Alpha: `v3.1.1-alpha1`
-- Release candidate: `v3.1.1-rc1`
+| Type | Format | Example |
+|------|--------|---------|
+| Official | `vX.Y.Z` | `v3.1.1` |
+| Beta | `vX.Y.Z-beta#` | `v3.1.1-beta1` |
+| Alpha | `vX.Y.Z-alpha#` | `v3.1.1-alpha1` |
+| RC | `vX.Y.Z-rc#` | `v3.1.1-rc1` |
 
-The core `X.Y.Z` segments must be numeric. Prerelease suffixes (for example `-beta1`, `-alpha1`, `-rc1`) are allowed, and the full tag version (including any suffix) must exactly match `versionName` in `build.gradle`.
+`X.Y.Z` must be numeric; prerelease suffixes are optional.

.github/copilot-instructions.md

@@ -23,20 +23,16 @@ Android GPU filter library (C++ & Java). Prefer **small, safe, backward-compatib
 
 Use `tasks.sh` for all operations (`bash tasks.sh --help`). Key `local.properties` flags: `usingCMakeCompile`, `disableVideoModule`, `enable16kPageSizes`. See `docs/build.md` for details.
 
-**Important**: CMake uses `GLOB_RECURSE`; ndk-build (`Android.mk`) lists sources **explicitly** — update both when adding native files.
-
 ## Code Conventions
 
-Language-specific rules live in `.github/instructions/` and are auto-applied by file path — see `cpp.instructions.md`, `java.instructions.md`, `jni-bridge.instructions.md`.
-
-For detailed standards, see `.github/CONTRIBUTING.md`.
+Language-specific rules live in `.github/instructions/code-conventions.instructions.md` and are auto-applied by file path.
 
 ## Documentation
 
 - `docs/build.md` — Full build guide and configuration options
 - `README.md` — API usage, custom filters, and code samples
 - `.github/RELEASE.md` — Release process and versioning
-- `.github/CONTRIBUTING.md` — Contributing guidelines and code standards
+- `.github/CONTRIBUTING.md` — Contributing workflow and compatibility rules
 
 ## Skills
 
@@ -46,7 +42,7 @@ For detailed standards, see `.github/CONTRIBUTING.md`.
 ## Behavior Constraints
 
 - **Validation:** After native code changes, ALWAYS run `bash tasks.sh --enable-cmake --build`.
+- **Dual Build:** CMake uses `GLOB_RECURSE` (auto-discovers); `Android.mk` lists files **explicitly** — update both when adding native sources.
 - **Commit Policy:** Only commit to feature branches, never force-push to `master`.
 - **Completeness:** Implement fully or request clarification — no TODOs in committed code.
-- **Dual Build:** When adding native files, update both `CMakeLists.txt` and `Android.mk`.
 - **Thread Safety:** Never call OpenGL ES functions outside the GL thread.

.github/instructions/code-conventions.instructions.md

@@ -0,0 +1,24 @@
+---
+description: "Code conventions for C++, Java, and JNI bridge layers. Covers naming, safety patterns, and resource management."
+applyTo: "library/src/main/jni/**/*.cpp,library/src/main/jni/**/*.h,library/src/main/jni/**/*.c,library/src/main/java/**/*.java,cgeDemo/src/main/java/**/*.java"
+---
+
+# C++ / Native
+
+- Follow `.clang-format` (Allman braces, 4 spaces). All code in `namespace CGE {}`.
+- No C++ exceptions (`-fno-exceptions`). Return error codes; never `throw`.
+- Logging: `CGE_LOG_INFO` / `CGE_LOG_ERROR` / `CGE_LOG_KEEP` — never raw `__android_log_print`.
+- Inline GLSL via `CGE_SHADER_STRING_PRECISION_H()` / `CGE_SHADER_STRING_PRECISION_M()`.
+- GL resources (programs, textures, FBOs) must be released along the handler lifecycle; shader compile failures must be logged, not crash.
+
+# JNI Bridge (`interface/`)
+
+- JNI function names follow `Java_org_wysaid_nativePort_<Class>_<method>`.
+- Always validate JNI params (null bitmap, null env, invalid handler pointer) before dereferencing.
+- **Never** store JNI local refs across calls.
+- Respect `NativeLibraryLoader`'s library loading order.
+- Any new JNI method needs a corresponding Java `native` declaration in `org.wysaid.nativePort.*`.
+
+# Java / Android
+
+- Native methods are loaded through `NativeLibraryLoader` — don't add direct `System.loadLibrary` calls.