---
title: "Rust API Ergonomics Reviewer: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/anthropics-rust-api-ergonomics-reviewer/
description: "Reviews a Rust library from the downstream user’s side, and confirms a suspected lint with cargo before reporting it."
---

# Rust API Ergonomics Reviewer: review, role & definition · Undominated.ai

> Reviews a Rust library from the downstream user’s side, and confirms a suspected lint with cargo before reporting it.

[← Explore all agents](/agents/)

CODE REVIEW / Anthropic

# Rust API Ergonomics Reviewer

Reviews a Rust library from the downstream user’s side, and confirms a suspected lint with cargo before reporting it.

 [Use this definition ↓](#setup)[Original source ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/.claude/agents/rust-api-ergonomics-reviewer.md)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 4 linked sources
 Publisher Anthropic
 Licence [Apache-2.0 ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/LICENSE)
 Revision 5fed61b257d3
 [Read what was—and wasn’t—checked ↓](#review)

“Reviews Rust library/framework code from the downstream consumer's perspective. Focuses on API clarity, idiomaticity, happy-path friction, footguns, and what users will actually see in their editor and compiler output. …”

 [Anthropic · upstream description ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/.claude/agents/rust-api-ergonomics-reviewer.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The role is limited to what a downstream Rust user types, sees in compiler output, and can misuse. Correctness bugs, performance and unsafe soundness are left to other review.
- A suspected clippy or check finding has to be confirmed with cargo check or cargo clippy. The default scope is git diff origin/main.

### A good fit for

 - Give it a Rust library diff, the comparison ref and representative downstream call sites to inspect import burden, builder order, fallibility and compiler diagnostics.
- Use its severity-grouped file:line findings, proposed fixes or trade-offs and positive observations as a release-review handoff.
- Provide a public Rust API diff plus downstream call-site examples.
- Use a review that checks how default construction, generated APIs and compiler diagnostics appear to consumers.

### Weigh up before choosing

 - Bash is enabled. The git/cargo allowlist and prohibition on repository edits live in prompt text; they are not an operating-system sandbox.
- cargo check and cargo clippy can invoke build scripts and write build outputs. Scope commands to the relevant crate and use a trusted or isolated checkout.
- The default base is origin/main and the model alias is opus. Supply the actual comparison ref and select an available model in your working copy.
- The role deliberately leaves unsafe soundness and ordinary correctness testing to other review. A short no-findings response is not proof that an API is safe.
- The prompt asks to try a broken downstream example while also forbidding working-tree edits; use a separately authorized scratch fixture if a compile check needs new files.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - .claude/agents/rust-api-ergonomics-reviewer.md
- LICENSE
- Claude Code custom-subagent location and capability documentation
- Cargo build-script lifecycle documentation
- Round 2: pinned definition, output contract and permission/dependency boundaries reread on 2026-10-14

### Our findings

 - The file says to report findings and not apply them, and to stop in two sentences when nothing above Low severity is present.
- High, medium and low are labels for findings, not a measured defect rate.
- The report is capped at 1500 words and groups user-visible problems by severity with file:line evidence; if nothing exceeds Low, it stops after two sentences.
- Checks distinguish downstream impl-site lints from allowances in the library workspace, and inspect generated-code ergonomics as well as handwritten public APIs.
- The checklist distinguishes struct-update defaults from non-exhaustive types that force mutate-after-default usage.
- It examines panicking builders for fallible siblings and doc-only invariants that could move into sealed traits or newtypes.

### Not established by this review

 - The agent was not executed; model behaviour, host compatibility and task outcomes were not runtime-tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Use the role in your project.

[Upstream setup instructions ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/.claude/agents/rust-api-ergonomics-reviewer.md)
 - Copy the reviewed file into the Claude Code agents directory your project already uses, or load it as a subagent from that path.
- Grant only Read, Glob, Grep and the git and cargo commands the file names. No installer was run.

### Before you start

 - Claude Code or a host that can load this Markdown role
- A Rust library checkout when the review is actually run

### Compatibility

Claude Code

### Implementation

Markdown

### Repository review with git and Cargo execution

 - Read repository files and diffs
- Execute git inspection and cargo check/clippy under host controls; Cargo may run build scripts and write build outputs

### Cost model

Apache-2.0 instructions. Model use follows the host.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Agent definition at reviewed revision ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/.claude/agents/rust-api-ergonomics-reviewer.md) Checked 2026-10-14 https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/.claude/agents/rust-api-ergonomics-reviewer.md Supports: summary, upstreamDescription, whySelected, limitations, access
- [Apache-2.0 licence ↗](https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/LICENSE) Checked 2026-10-14 https://github.com/anthropics/buffa/blob/5fed61b257d36dac48525a73c0fcb1e9fd8b5299/LICENSE Supports: license
- [Claude Code subagent configuration ↗](https://code.claude.com/docs/en/sub-agents) Checked 2026-10-14 https://code.claude.com/docs/en/sub-agents Supports: Project installation, Host tool and model boundaries
- [Cargo build-script lifecycle ↗](https://doc.rust-lang.org/cargo/reference/build-scripts.html) Checked 2026-10-14 https://doc.rust-lang.org/cargo/reference/build-scripts.html Supports: Cargo execution and output side effects

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Expert Rust Code Reviewer ↗ Reviews a Rust diff for ownership, unsafe invariants, concurrency, error handling and public APIs, with compiler or Clippy checks for testable findings.](/agents/buffa-rust-code-reviewer/)[### Code slice worker ↗ Pins the Trailmark worker that answers from one source packet, returns a single JSON object, and says it cannot read the repository.](/agents/trailofbits-code-slice-worker/)[### Feature-dev code reviewer ↗ Reviews the unstaged git diff for bugs and against CLAUDE.md rules, and reports only issues it rates 80 or higher.](/agents/anthropic-code-reviewer/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
