VoidLight-Framework

Runs performance benchmarks for SDL3 VoidLight-Framework and detects regressions by comparing metrics against baseline. Use when testing performance-sensitive changes to AI, collision, pathfinding, particle systems, or before merging features to ensure no performance degradation.

Generates professional performance analysis reports from SDL3 VoidLight-Framework benchmark results including statistical analysis, comparison tables, visualizations, and recommendations. Use when preparing performance documentation, analyzing optimization efforts, or generating milestone/release reports.

Runs complete build validation pipeline for SDL3 VoidLight-Framework including Debug build, smoke test execution, core test suite, and summary report generation. Use when the user wants to quickly validate their changes, check if the codebase is in a good state, or run the standard daily validation workflow.

Generates comprehensive, professionally-formatted changelogs for SDL3 VoidLight-Framework from git history. Analyzes code changes, runs tests, includes architect review, and produces detailed documentation as an ongoing engineering log. Use when documenting updates, preparing releases, or creating detailed change reports.

Verify dependency structure and architecture health for SDL3 VoidLight-Framework. Detects circular dependencies, excessive coupling, layer violations, header bloat, and provides dependency graph visualization. Ensures adherence to layered architecture (Core→Managers→States→Entities). Use monthly, after major refactors, or when investigating compile time issues.

Simplified memory profiling and leak detection for SDL3 VoidLight-Framework using valgrind memcheck, AddressSanitizer, and massif. Identifies memory leaks, allocation hotspots, buffer reuse violations, and provides system-by-system memory breakdown with optimization suggestions. Use after performance-critical changes or when investigating memory issues.

Runs comprehensive code quality checks for SDL3 VoidLight-Framework including compilation warnings, static analysis (cppcheck, clang-tidy), coding standards validation, threading safety verification, and architecture compliance. Use before commits, pull requests, or when the user wants to verify code meets project quality standards.

Generates complete test suite infrastructure (test scripts, functional tests, benchmark tests, output directories, CMake integration) for a new SDL3 VoidLight-Framework system or manager following project conventions. Use when adding a new manager or system that needs testing infrastructure.

Review or fix VoidLight-Framework changes for architectural coherence, with emphasis on EDM ownership, manager vs controller boundaries, state-transition cleanup, event contracts, and world-lifecycle correctness. Use when the user wants an architecture check, wants to prevent subsystem drift, or wants help enforcing where new gameplay features should live.

Run a VoidLight repository quality gate against local project instructions, architecture and coding standards, tests, cppcheck guidance, and clang-tidy guidance. Use when the user asks to run a quality check, quality pass, standards check, architecture check, cppcheck/clang-tidy pass, or to investigate and fix findings after checking this C++ repository.

Run VoidLight-Framework benchmark regression checks and compare current performance metrics against platform-local baselines. Use when the user asks to run benchmarks, check for performance regressions, verify no performance degradation, refresh or compare baselines, or validate performance-sensitive changes to AI, collision, pathfinding, particles, projectile, threading, GPU frame timing, SIMD, event, or integrated systems.

Specialized VoidLight C++20 engineering agent for engine, gameplay, AI, rendering, UI, threading, profiling, and test-aligned fixes. Use when the user wants focused implementation help on C++20 game systems, engine architecture, performance, rendering bugs, gameplay feature work, or production-safe debugging in this repository.

Senior-level VoidLight systems review agent for C++20 engine and gameplay code, focused on system coherency, completeness, integration safety, architectural fit, lifecycle correctness, and production-readiness. Use when the user asks for a review, audit, critique, design sanity check, PR review, architecture review, or wants bugs and risks identified across interacting game systems rather than code merely being locally correct.

Design and implement targeted VoidLight-Framework regression tests, repro harnesses, Boost.Test filters, and sanitizer/debug workflows for C++20 engine, gameplay, AI, rendering, event, lifecycle, and threading bugs. Use when a bug needs a minimal reproduction, a behavior change needs focused test coverage, or a failing test needs root-cause diagnosis without relaxing expectations.