diff --git a/AGENTS.md b/AGENTS.md index 539a458d4..a1d380dc4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -68,7 +68,9 @@ reviewable, and compatible with the project's normal engineering constraints. specified in `./scripts/gitlint/rules`. - For LLM-assisted changes, follow the disclosure guidance in `CONTRIBUTING.md`: use the project's `Assisted-by:` trailer when disclosure is needed, and do not - add `Co-authored-by` or similar trailers unless that policy changes. + add `Co-authored-by` or similar trailers unless that policy changes. Prefer + explicit version numbers, such as `Assisted-by: Claude:Opus-4.7`, rather than + `Assisted-by: Claude:Opus-4`. - Temporary allowances such as `#[allow(unused)]` or ignored tests are only acceptable if resolved within the same commit series or paired with a clear TODO referencing a ticket. Ask the developer if in doubt. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 25407b4c7..88a3627bc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -41,7 +41,8 @@ Comments should be concise and add additional context or information to the code Logging should be minimal and high signal. Use `info!` for important normal state changes that matter in production; use `warn!` or `error!` only for -abnormal conditions. Keep `debug!` for focused diagnostics. +abnormal conditions. Keep `debug!` for focused diagnostics. Please find more +information in [`docs/logging.md`](docs/logging.md). [Rust Style]: https://github.com/rust-lang/rust/tree/HEAD/src/doc/style-guide/src