Thanks to visit codestin.com
Credit goes to github.com

Skip to content

fix: improve agent-native-reviewer with triage, prioritization, and stack-aware search#387

Merged
tmchow merged 2 commits into
mainfrom
improve-agent-native-reviewer
Mar 26, 2026
Merged

fix: improve agent-native-reviewer with triage, prioritization, and stack-aware search#387
tmchow merged 2 commits into
mainfrom
improve-agent-native-reviewer

Conversation

@tmchow
Copy link
Copy Markdown
Collaborator

@tmchow tmchow commented Mar 26, 2026

The agent-native-reviewer had the right philosophy but couldn't navigate real codebases -- it told the agent WHAT to check without helping it figure out HOW to find things in an unfamiliar project. This rewrites the system prompt to close that gap.

Key changes:

  • Triage step (step 0) -- before any review work, the agent determines whether agent integration exists, identifies the tech stack, and decides whether this is an incremental review or full audit. Previously it dove straight into "Map the Landscape" with no orientation.
  • Stack-specific search strategies -- a table mapping 6 common stacks (Vercel AI SDK, LangChain, OpenAI Assistants, Claude Code plugins, Rails + MCP, generic) to concrete file patterns for finding UI actions and agent tools.
  • Prioritization heuristics -- three tiers (must-have / should-have / low-priority parity) so core domain CRUD gets flagged as Critical while missing parity on a settings page is an Observation at most.
  • "What You Don't Flag" section -- prevents false positives on intentionally human-only flows (CAPTCHA, 2FA, OAuth consent, biometrics, platform gates).
  • Noun Test (step 6) -- restored from the original's "Write to Location" heuristic. For every domain entity, checks context injection + action parity + discoverability in one pass.
  • Confidence calibration -- aligns with the ce-review ensemble pattern used by peer agents like correctness-reviewer.
  • Nuanced "primitives over workflows" -- workflow tools flagged for review, not categorically rejected. Safety-critical atomic sequences and external system orchestration are acknowledged exceptions.

Also adds missing frontmatter fields (color: cyan, tools: Read, Grep, Glob, Bash) and collapses the original's 7 verbose anti-pattern subsections into a scannable reference table. Net result: 192 lines down from 262, with substantially more actionable guidance.


Compound Engineering v2.54.0
🤖 Generated with Claude Opus 4.6 (1M context, extended thinking) via Claude Code

…tack-aware search

- Add missing frontmatter fields (color, tools) to match peer review agents
- Add triage step (step 0) to orient the agent in unfamiliar codebases
- Add stack-specific search strategies for common frameworks (Vercel AI SDK,
  LangChain, OpenAI Assistants, Claude Code plugins, Rails + MCP)
- Add prioritization heuristics so not every missing tool is a Critical finding
- Add incremental vs. full audit guidance for the most common review scenario
- Add confidence calibration to align with the ce-review ensemble pattern
- Add "What You Don't Flag" section to prevent false positives on intentionally
  human-only flows (CAPTCHA, 2FA, OAuth consent, biometrics)
- Restore the "Noun Test" heuristic as step 6 in the review process
- Nuance "primitives over workflows" with justified exceptions
- Collapse verbose anti-pattern subsections into a scannable reference table
- Cut from 262 lines to 192 while adding substantial new guidance
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2a42f5111a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread plugins/compound-engineering/agents/review/agent-native-reviewer.md Outdated
- Align noun-test severity with priority tiers from step 2
@tmchow tmchow merged commit e792166 into main Mar 26, 2026
2 checks passed
This was referenced Mar 26, 2026
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