AGENTS.md

These rules apply to all agent-made changes in this repository.

PR Gate

Before opening or updating a PR, run the same local gates as .github/workflows/quality-gates.yml.
Required commands:
- ./scripts/lint.sh
- ./tests/scripts/check-refactor-line-gate.sh
- ./tests/scripts/run-unit-all.sh
- npm run build --prefix webui

Run gofmt -w on every changed Go file before commit or push.
Do not ignore error returns from I/O-style cleanup calls such as Close, Flush, Sync, or similar methods.
If a cleanup error cannot be returned, log it explicitly.

Keep changes additive and tightly scoped to the requested feature or bugfix.
Do not mix unrelated refactors into feature PRs unless they are required to make the change pass gates.

When business logic or user-visible behavior changes, update the corresponding documentation in the same change.
docs/prompt-compatibility.md is the source-of-truth document for the “API -> pure-text web-chat context” compatibility flow.
If a change affects message normalization, tool prompt injection, prompt-visible tool history, file/reference handling, history split, or completion payload assembly, update docs/prompt-compatibility.md in the same change.