docs: add engine reference docs for SFML3 and Raylib

CHANGELOG.md

@@ -1,3 +1,21 @@
+# Update unreleased — 2026-07-23
+
+## Bug Fixes
+
+- Update .opencode/{agents,skills,commands}/ paths to canonical .agents/
+- Bump question tool max options from 4 to 10
+- Remove dead ternary in question tool (both branches same value)
+
+
+# Update unreleased — 2026-07-22
+
+## Bug Fixes
+
+- Update .opencode/{agents,skills,commands}/ paths to canonical .agents/
+- Bump question tool max options from 4 to 10
+- Remove dead ternary in question tool (both branches same value)
+
+
 # Update unreleased — 2026-07-22
 
 ## Bug Fixes
@@ -141,3 +159,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 
 
+
+

CHANGELOG_INTERNAL.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [unreleased] — 2026-07-23
+
+### FIX
+
+- update .opencode/{agents,skills,commands}/ paths to canonical .agents/ [`4f4d944`]
+- bump question tool max options from 4 to 10 [`e9cb855`]
+- remove dead ternary in question tool (both branches same value) [`43405e9`]
+
+### CHORE
+
+- **deps**: bump actions/setup-node from 6 to 7 (#75) [`f9d61d3`]
+- **deps**: bump actions/checkout from 6 to 7 (#74) [`7f5e94b`]
+- prepare v0.10.2 (#73) [`96f52fa`]
+- remove superpowers reference from CHANGELOG [`075b68d`]
+- prepare v0.10.1 [`5d4543b`]
+
+### Other Changes
+
+- Fix Pi compatibility gaps (module installer, config, drift detector) (#84) [`6ef55fb`]
+- Fix plugin code quality issues (dead code, cross-platform notifications, E2E test) (#83) [`12a6321`]
+
+
+## [unreleased] — 2026-07-22
+
+### FIX
+
+- update .opencode/{agents,skills,commands}/ paths to canonical .agents/ [`4f4d944`]
+- bump question tool max options from 4 to 10 [`e9cb855`]
+- remove dead ternary in question tool (both branches same value) [`43405e9`]
+
+### CHORE
+
+- **deps**: bump actions/setup-node from 6 to 7 (#75) [`f9d61d3`]
+- **deps**: bump actions/checkout from 6 to 7 (#74) [`7f5e94b`]
+- prepare v0.10.2 (#73) [`96f52fa`]
+- remove superpowers reference from CHANGELOG [`075b68d`]
+- prepare v0.10.1 [`5d4543b`]
+
+### Other Changes
+
+- Fix Pi compatibility gaps (module installer, config, drift detector) (#84) [`6ef55fb`]
+- Fix plugin code quality issues (dead code, cross-platform notifications, E2E test) (#83) [`12a6321`]
+
+
 ## [unreleased] — 2026-07-22
 
 ### FIX
@@ -116,3 +160,5 @@
 
 
 
+
+

docs/engine-reference/raylib/VERSION.md

@@ -0,0 +1,58 @@
+# Raylib Engine — Version Reference
+
+| Field | Value |
+|-------|-------|
+| **Engine Version** | Raylib 5.5 |
+| **Release Date** | 2025 |
+| **Project Pinned** | 2026-07-22 |
+| **Last Docs Verified** | 2026-07-22 |
+| **LLM Knowledge Cutoff** | May 2025 |
+
+## Knowledge Gap Warning
+
+Raylib 5.5 is within the LLM's training data cutoff (May 2025). The model
+should have good knowledge of Raylib 5.x APIs. Risk level is LOW.
+
+Raylib is stable and generally backwards-compatible between minor versions.
+Major API changes are rare and well-documented.
+
+## Risk Level: LOW
+
+This engine version is within the LLM's training data. Engine reference
+docs are maintained for accuracy but most API knowledge should be current.
+
+## Version History
+
+| Version | Release | Risk Level | Key Theme |
+|---------|---------|------------|-----------|
+| 4.x | 2022-2023 | LOW | Stable API, widely documented |
+| 5.0 | 2024 | LOW | Minor improvements, backwards compatible |
+| 5.5 | 2025 | LOW | Within training data, stable |
+
+## Raylib Characteristics
+
+- **C library** with PascalCase function names (InitWindow, LoadTexture, etc.)
+- **Header-only modules**: raymath, raygui (optional)
+- **Platform support**: Windows, macOS, Linux, Web (Emscripten), Android, Raspberry Pi
+- **No editor** — code-only development
+- **Simple API** designed for learning and prototyping
+- **zlib/libpng license** — completely free with no restrictions
+- **No built-in physics, scene graph, or UI system** — bring your own
+
+## Key Modules
+
+| Module | Purpose | Header |
+|--------|---------|--------|
+| core | Window, input, timing, file I/O | `raylib.h` |
+| rlgl | Raw OpenGL abstraction | `raylib.h` (advanced) |
+| raudio | Audio device, sound, music | `raylib.h` |
+| raymath | Vector/Matrix math | `raymath.h` |
+| raygui | Immediate-mode UI | `raygui.h` |
+
+## Verified Sources
+
+- Official website: https://www.raylib.com/
+- GitHub repository: https://github.com/raysan5/raylib
+- Wiki: https://github.com/raysan5/raylib/wiki
+- Cheatsheet: https://www.raylib.com/cheatsheet/cheatsheet.html
+- Examples: https://github.com/raysan5/raylib/tree/master/examples

docs/engine-reference/raylib/breaking-changes.md

@@ -0,0 +1,66 @@
+# Raylib — Breaking Changes
+
+Last verified: 2026-07-22
+
+Changes between Raylib versions. Raylib is generally stable and backwards-compatible.
+Major breaking changes are rare.
+
+## 5.0 → 5.5 (2025 — LOW RISK)
+
+| Subsystem | Change | Details |
+|-----------|--------|---------|
+| Core | Minor bug fixes | Various platform-specific fixes |
+| Audio | Audio improvements | Better device detection and handling |
+| Platform | Android updates | Improved Android build support |
+| Platform | Web updates | Emscripten compatibility improvements |
+
+## 4.x → 5.0 (2024 — LOW RISK)
+
+| Subsystem | Change | Details |
+|-----------|--------|---------|
+| Core | Function signature updates | Some functions have updated parameters — verify usage |
+| Core | Deprecated function removal | Functions deprecated in 4.x may be removed |
+| Models | 3D model loading improvements | Better glTF support |
+| Shaders | Shader uniform naming | Verify uniform location queries |
+| Build | CMake improvements | Better find_package support |
+
+## 3.x → 4.0 (2022 — MEDIUM RISK)
+
+| Subsystem | Change | Details |
+|-----------|--------|---------|
+| Core | `GetMousePosition()` returns Vector2 | Was separate float returns |
+| Core | File I/O functions renamed | `LoadFileData` → `LoadFileData` (verify) |
+| Textures | `LoadImageFromTexture` | New function for texture → image conversion |
+| Textures | Image format handling | Improved format conversion |
+| Models | Mesh data structure changes | Verify mesh attribute access |
+| Audio | `InitAudioDevice()` required | Must call before audio functions |
+| Math | raymath functions updated | Some function signatures changed |
+
+## 2.x → 3.0 (2020 — HIGH RISK — Historical)
+
+| Subsystem | Change | Details |
+|-----------|--------|---------|
+| Core | Major API reorganization | Many functions renamed for consistency |
+| Core | `InitWindow()` required | Window must be initialized before most functions |
+| Colors | `Color` struct changed | Now uses unsigned char (0-255) for all channels |
+| Textures | Texture2D renamed | `Texture2D` → `Texture` (typedef) |
+| Models | Model loading API | `LoadModel()` and `LoadModelAnimations()` updated |
+| Shaders | Shader system overhaul | `LoadShader()` and `LoadShaderCode()` updated |
+| Math | Quaternion functions | Added/renamed quaternion operations |
+
+## Common Migration Checklist (Any Version)
+
+1. Check the [official changelog](https://github.com/raysan5/raylib/releases) for your specific version transition
+2. Update raylib.h and linked libraries
+3. Rebuild project — most changes will cause compile errors
+4. Verify resource loading patterns (Load*/Unload* pairs)
+5. Test on all target platforms
+6. Check shader compatibility if using custom shaders
+
+## Notes
+
+- Raylib maintains excellent backwards compatibility between minor versions
+- Breaking changes are concentrated in major version bumps (3.0, 4.0)
+- The [raylib cheatsheet](https://www.raylib.com/cheatsheet/cheatsheet.html) is updated with each release
+- Most API changes are renames for consistency, not fundamental behavior changes
+- When in doubt, check the specific release notes on GitHub