Skip to content

Add CLAUDE.md rules to improve Claude Code Review effectiveness - #48

Closed
jnasbyupgrade wants to merge 2 commits into
Postgres-Extensions:masterfrom
jnasbyupgrade:worktree-improve-claude-review
Closed

Add CLAUDE.md rules to improve Claude Code Review effectiveness#48
jnasbyupgrade wants to merge 2 commits into
Postgres-Extensions:masterfrom
jnasbyupgrade:worktree-improve-claude-review

Conversation

@jnasbyupgrade

Copy link
Copy Markdown
Contributor

Summary

  • CodeRabbit caught several real bugs in a recent SKILL.md rewrite (PR Add tests for pgxntool-version.sh and the pgxntool-version make target #43) that the automated Claude Code Review CI missed entirely.
  • That CI runs anthropics/claude-code's code-review plugin, whose compliance agents only enforce rules stated explicitly and quotably in CLAUDE.md (root, plus any CLAUDE.md sharing a path with the changed files) — there's no other repo-local config file it reads.
  • Adds a new ## Skill and Process Doc Quality section plus a testing-side rule, phrased as concrete, quotable must/never statements targeting the specific failure classes that were missed: self-contradicting doc rewrites, skill steps silently violating this repo's own CLAUDE.md policies, undefined yes/no branches, bad markdown fences, and bats tests deriving new paths instead of reusing existing helpers (e.g. PGXNREPO).

Test plan

  • N/A — documentation-only change to CLAUDE.md, no code/test behavior affected.

🤖 Generated with Claude Code

The code-review plugin's compliance agents only enforce what CLAUDE.md
states explicitly and quotably, scoped to CLAUDE.md files sharing a
path with the changed files. It has no other repo-local config file.

Adds concrete, quotable rules targeting the classes of bugs a recent
CodeRabbit pass caught that the automated review missed in a SKILL.md
rewrite: self-contradicting instructions after a late-stage section
rewrite, skill steps that silently contradict this repo's own
CLAUDE.md policies, undefined yes/no branches, bad markdown fences,
and bats tests deriving new paths instead of reusing existing helpers
like PGXNREPO.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 45204c10-39d6-427d-b7f8-b311a565a18a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

…or steps

The code-review plugin's compliance agents only see the diff — they
can't verify that a process step (re-reading a file, running a
linter) happened during authoring. Lead each rule with a declarative
"must/must not" statement checkable directly from the doc's content,
keeping the authoring-workflow advice as secondary framing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant