docs(guides): document the CODING_STANDARDS.md criteria file - #1573
Conversation
The capability shipped in #1572 without reaching the guide, so nothing told a reader that review is customizable or that the file exists. The guide said only that project-standards runs "when applicable standards files exist", which stayed true and explained nothing. Adds a "Repo-owned review criteria" section covering what a reader needs to write one: placement scopes it, any format works, it takes precedence over the instruction file per changed file, and it can grow because it is read at review time rather than charged to every agent turn. The intro, a TL;DR row, the persona-selection bullet, the FAQ answer, and the catalog row now point at it.
PR SummaryLow Risk Overview The The on-demand skills table in Reviewed by Cursor Bugbot for commit 2c0f81b. Bugbot is set up for automated code reviews on this repo. Configure here. |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |


Summary
ce-code-review's guide never mentioned that the review is customizable. #1572 shippedCODING_STANDARDS.mdas the criteria source, but the docs went out unchanged, so a reader had no way to discover the feature — the page said only that project-standards runs "when applicable standards files exist," which stayed technically true and explained nothing.The new Repo-owned review criteria section covers what someone actually needs in order to write one: where to put the file and what it governs, that any format works (prose, bullets, tables — no schema, no identifiers), that it takes precedence over
CLAUDE.md/AGENTS.mdper changed file so existing repos keep the review they had, and why enforceable rules belong there rather than in an instruction file that is charged to every agent turn.The intro, a TL;DR row, the persona-selection bullet, the FAQ answer, and the catalog row in
docs/guides/README.mdnow point at it. Docs only — no skill or source behavior changes.Validation
bun run release:validatereports metadata in sync;tests/release-metadata.test.tspasses 44/0. Both new anchor links resolve to the added heading, and no "applicable standards file" phrasing remains. No skill counts changed — this adds no skill, so the rootREADME.mdneeds nothing.Security Disclosure
No security-relevant changes. Documentation prose only, in
docs/guides/, which #1571 moved out of the plugin skills tree — nothing here ships as runtime agent instruction.Agent Disclosure
Claude Code · claude-opus-5[1m]