Contributing

Start with AGENTS.md and docs/index.md. Preserve Commerce Scope isolation, source-data minimization, atomic publication, and the separation between training and serving.

Use make test-focused TEST=... while developing and make test before handoff. Run make smoke for packaging changes, make migration-check for migrations, and make compose-check for container artifacts. A meaningful bug fix includes a regression test demonstrated against the defective behavior before it passes with the fix. Treat a deleted test, weakened assertion, new skip, threshold change, or acceptance-criteria change as a contract change requiring explicit review.

Update the approved specification for intended behavior changes and the implementation reference for as-built changes. Add an ADR under docs/adr/ for durable, hard-to-reverse ownership, dependency, storage, privacy, or verification decisions.

Record commands and results in the pull request or docs/agents/handoff.md. Do not commit credentials, populated environment files, production commerce data, raw interaction exports, or Shopper identifiers. Publishing and deployment require separate explicit authority.