test.prompt.md 817 B


description: "Build and run the v-gears-tests Boost.Test suite, then diagnose any failures" agent: "agent"

argument-hint: "Optional: specific test case or area to focus on"

Build and run the V-Gears test suite:

  1. Build the test target: cmake --build build --target v-gears-tests -j$(nproc) (configure build/ first if it doesn't exist: cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug).
  2. Run the suite: ctest --test-dir build --output-on-failure.
  3. For each failure, read the failing test and the code under test, fix the root cause, and rerun.
    • Tests use Boost.Test with dynamic linking.
    • New test sources must be registered manually in test/CMakeLists.txt.
    • Never use original game data in tests — build fixtures in code.
  4. Report pass/fail counts and summarize what was fixed.