| # 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` |
|
|
| ## Go Lint Rules |
|
|
| - 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. |
|
|
| ## Change Scope |
|
|
| - 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. |
|
|
| ## Documentation Sync |
|
|
| - 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. |
|
|
