Sources: AGENTS.md ai/test-matrix.yml Makefile CMakePresets.json android/gradlew commit 3053bf160578 build-config

Build and validation quickstart

CCB CI, CMake, Makefile, Gradle, and repository scripts define validation behaviour. This page is only a routing aid. If a command here conflicts with a build file, mark this page stale and repair it against the build contract.

Choose the smallest sufficient check first

Changed area	First check	Notes
Agent/governance metadata	python3 tools/agent/check_project_metadata.py	Then run the tools/agent unit tests
C++	make astyle-check	Behaviour changes also need focused Catch2 tests
C++ tests	make -j2 tests	Then run ./tests/cata_test "filter"
JSON	make -j2 json-check	Also run the repository formatter on changed files
Lua contract	check_luals_declarations.py and check_platform_coverage.py	Check schema, registration, and declaration changes
CMake	cmake --preset linux-x64	Use an existing repository preset
Android	cd android && ./gradlew test	Requires a configured Android SDK

The complete routing data lives in ai/test-matrix.yml. If an expensive or platform-specific check lacks dependencies, report why it was skipped. Never claim a check passed when it did not run.

Record validation results

A pull request records:

1. the exact commands that ran;
2. focused test filters or names;
3. results and any relevant RNG seed;
4. skipped checks and reasons;
5. scenarios reviewers should verify separately.

Documentation-impact automation is advisory in Phase 0/1. It does not replace source tests and does not block an ordinary source pull request because of unrelated documentation debt.