What problem does it solve? SparkEngine's custom test framework makes it easy for tests to silently never run — unregistered files, empty filter selections, and waived flaky tests can all produce green runs that prove nothing. This Skill provides the verified runbook for registering tests, selecting and running them, interpreting results honestly, and knowing which CI checks actually block a PR. ## Core Features & Use Cases - Test registration and execution: Explains the single-executable SparkTests model, the Tests/CMakeLists.txt registry, the check-test-registration.sh guard, and SPARK_TEST_NAME/FILE/EXCLUDE/LIMIT selectors plus CLI flags like --junit-xml, --shuffle, and --empty-is-error. - Sanitizer and coverage lanes: Documents how to reproduce ASan/UBSan/LSan, TSan, and MSan CI runs locally, including suppression files, presets, and which lanes are blocking versus advisory. - CI gate truth table: Distinguishes required versus advisory checks in build.yml, including verified cases where advertised thresholds (coverage, annotation counts, clang-tidy scope) are not actually enforced. - Use Case: You add Tests/TestNavMesh.cpp but it never runs in CI. This Skill tells you to register it in Tests/CMakeLists.txt, run bash tools/check-test-registration.sh, filter with SPARK_TEST_FILE=TestNavMesh.cpp, and RED-proof the test by watching it fail before trusting the pass. ## Quick Start Ask the assistant to register a new SparkEngine test file and run only that test with the SparkTests selectors, then verify it appears in the run summary count.
