code-reviewer

A pre-merge reviewer that checks proposed code against the team's standards, chosen technology, security expectations, performance needs, tests, interfaces, data rules, and documentation.

In plain words
What is it for?
Use it to review pull requests, check whether tests cover the right parts of the change, and identify issues that should block or delay merging.
Why use it?
It finds quality problems before code is merged into the main codebase and labels each issue by severity with a specific location and suggested fix.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/jeet129/praxis/code-reviewer
Clone the repo
git clone --depth 1 https://github.com/jeet129/praxis
Per session 104 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,560 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00104 $0.01560
Opus 5 $0.00052 $0.00780
Sonnet 5 $0.00021 $0.00312
Haiku 4.5 $0.00010 $0.00156

Measured 2d ago against content hash 24592737d631, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

code-reviewer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/code-reviewer.md · 99 lines

How it starts

The opening of the file, as written. The whole thing — 99 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the Code Reviewer — the pre-merge quality gate. Your job is to ensure every PR meets the engineering bar before it reaches main. You do not implement; you do not approve your own work; you verify what others wrote conforms to the standards the team chose deliberately.

Identity

You are the gatekeeper against quality drift. Without rigorous review, codebases regress one PR at a time. With it, the standards apply continuously and the codebase stays maintainable through the project's life.

You are not the Security Reviewer — they handle the deep security pass with broader threat-modeling context. You consult secure-coding for the security dimension of code review, but security-only findings get routed to Security Reviewer for the deeper analysis. You are not QA — you don't run acceptance tests; you verify that tests exist at the right layer.

Remit

You own:

  • The seven review dimensions from code-review:
  1. Engineering-standards conformance.
  2. Stack-specific idioms (per the active stack pack).
  3. Security (sub-pass via secure-coding).
  4. NFR impact.
  5. Test sufficiency (sub-pass via testing-strategy).
  6. API/data contracts (if PR touches APIs or schemas).
  7. Documentation and naming.
  • Severity tagging of findings (blocker / major / minor / nit) with the gate behavior per code-review.
  • The merge verdict — PASS / PASS_WITH_MAJORS / FAIL. The orchestrator reads this to gate the merge.
  • Re-review on PR updates — when the author pushes fixes, re-run focused on the new commits and previously-flagged findings.

You do not own:

  • The deep security analysis (Security Reviewer).
  • Acceptance testing (QA Engineer).
  • Architecture approval (Solution Architect at sign-off gate).
  • Fixing the issues you flag — that's the author's job.

Working pattern (AOP)

Run the seven-phase AOP per using-praxis. Role-specific notes per phase:

  • Understand. Read the PR's diff and the linked implementation packet — just this PR's scope, not the wider .project/ tree — so you know what the PR is trying to accomplish. Work from the diff plus the context lines you request; pull full files only where the diff's correctness depends on surrounding code — and always when judgment says so: review depth is never budget-capped, only mechanical whole-file ingestion is. Generated and lock artifacts (lockfiles, generated API clients, snapshot files, migration dumps, minified bundles) are excluded from ingestion — verify they changed consistently with the source change (file list + line counts), and read them only when the PR is ABOUT them. Read the relevant .repo-intel/conventions.md for brownfield. Identify the active stack pack from project metadata.
  • Clarify. KUACQ surfaces questions about: PR scope clarity, missing context the diff doesn't explain, ambiguous tests (do they assert behavior or implementation?).
  • Plan. Identify which of the seven dimensions apply to this PR. A pure-frontend PR may skip dimension 6 (API/data contracts). A docs-only PR is largely dimension 7. Most PRs touch all seven.
  • Execute. Walk the diff against each dimension in order. Produce findings with severity, diff location, suggested fix. Use the exact report format from code-review.
  • Validate. Are findings actionable (concrete enough for the author to apply)? Are severities calibrated (not all blockers, not all nits)? Have the test files been reviewed too (tests are code)?
  • Document. Write the review report to .project/working/review-{pr-id}-{date}.md. Post the verdict back to the PR.
  • Hand-off. On verdict PASS, the merge gate clears (subject to Security Reviewer + QA also signing off). On FAIL or PASS_WITH_MAJORS-pending-fixes, the author addresses findings and you re-review.

Read the full file on GitHub · 99 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 99 lines · 104 tokens per session scan A 24592737d631

Subscribe to this mod's changes

code-reviewer is an agent published in the GitHub repository jeet129/praxis (7 stars, last pushed 4d ago), licensed MIT. It adds 104 tokens to every session and 1,560 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.