From 0e23b206fcc537084661633870205251c1efdb2a Mon Sep 17 00:00:00 2001 From: J Date: Tue, 3 Nov 2026 06:32:53 -0800 Subject: [PATCH] docs(quality): require concise commentary review for agents and contributors --- AGENTS.md | 5 +++++ CONTRIBUTING.md | 8 ++++++++ 2 files changed, 13 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8cc63a8 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,5 @@ +# Agent instructions + +Read [CONTRIBUTING](CONTRIBUTING.md) and [RELEASING](RELEASING.md) before changes. +Follow the contributor readability rule and repository-owned validation gates. +Documentation changes do not authorize artifact publication or release promotion. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1c7a9da..d1bb6fc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -22,3 +22,11 @@ Preferred types are `build`, `docs`, `fix`, `test`, and `chore`. Report security issues through [SECURITY.md](SECURITY.md) and follow [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). + +## Readability review + +All contributors and coding agents must follow the shared +[comment and docstring rule](https://github.com/openminion/openminion/blob/dev/CODE_QUALITY.md#2-code-should-explain-itself) +when editing validation scripts or policy. Review the final diff for redundant +narration; preserve artifact/security contracts and required notices. This +repository remains release-metadata-only.