Contributing

Start with the architecture overview and the guide for the subsystem you are changing. Choose the owning library before adding code: neutral contracts belong in Engine, runtime integration SDKs in their modules, optional Engine helpers in support targets, and game mechanics in the application. The module guide explains when a new owner is useful and how to compose it.

Keep a change focused on its intended behavior. Preserve unrelated work in this shared checkout and avoid changing interfaces or formatting nearby code merely because it is convenient. Apply the C++ style to affected code. Pinned dependencies retain their own licenses and upstream conventions.

Validation

Add behavior checks under the owner they exercise. Engine checks use controlled adapters; integration checks belong with the selected module. Compile public headers through the owner’s consumer probes when a change affects consumption. Use test selection to batch targets and avoid duplicate aggregate runs. Native pixels, sound, controller reports and platform services require their own observation procedures.

When reporting a change, explain the resulting behavior, why it belongs in that owner and the checks performed. Identify unresolved failures and missing coverage with their next action. Agent execution and commit rules live in AGENTS.md.

Documentation and planning

During an authorized documentation-maintenance phase, update the authoritative API or subject guide when contracts change, including ownership, valid threads, units, preconditions and failure behavior. Keep build instructions in the build guide, runner selection in the test guide, and integration-specific details with their module.

Plans describe unresolved work, prerequisites, dependency boundaries and acceptance. Keep an active task’s checklist in one owning plan and link it from the roadmap. Preserve useful decisions before removing completed plans; implementation history belongs in Git. Maintain testing requests only when that maintenance is authorized: carry outstanding requirements in the phase handoff until then, and remove accepted requests after reconciling revision and coverage. Documentation audit reports findings without editing; maintenance implements the selected corrections. Test design, implementation and execution remain separate work modes, and listing build/test commands does not authorize agent execution.