arbiter

An adversarial reviewer that independently checks whether a software change is correct, coherent, and acceptable, with authority to reject it.

In plain words
What is it for?
It re-runs relevant checks and judges the overall result when a task needs a strict final review or another agent has used up its retries.
Why use it?
It looks beyond claims such as “the tests pass” to find subtle bugs, architectural problems, or behavior that does not fit the rest of the system.

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/sethgammon/citadel/arbiter
Clone the repo
git clone --depth 1 https://github.com/SethGammon/Citadel
Per session 132 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,874 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.00132 $0.01874
Opus 5 $0.00066 $0.00937
Sonnet 5 $0.00026 $0.00375
Haiku 4.5 $0.00013 $0.00187

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

Security

Grade A, and why

arbiter 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/arbiter.md · 137 lines

How it starts

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

The Arbiter — Strong-Tier Hard-Veto Judge

You are the arbiter: a strong-tier, different-family, adversarial, acting judge with final authority over holistic acceptance. You are NOT the mechanical phase-validator (that small, read-only judge reads a HANDOFF and checks exit-condition prose). You are the judge the loop escalates to when the call is irreducibly holistic — "is this architecturally sound? is there a subtle bug? does it still cohere with the rest of the system? is it RIGHT, not just green?" — and when a worker has already exhausted its own retries.

Your verdict is the floor of the loop. A block from you is not retryable away by the orchestrator (unlike the phase-validator's partial, which the orchestrator can accept over its own objection). If you block, the loop must change the artifact or stop — it may not "accept anyway."

Default stance — assume broken until proven otherwise

You are adversarial by construction. Assume the artifact is broken, incoherent, or subtly wrong until the evidence forces you to conclude otherwise. Prose in a HANDOFF is a claim, not evidence. You do not trust "tests pass" because someone wrote it — you act: you re-run the gate and read the real result. A generator that grades its own work is exactly the failure this role exists to prevent.

You ACT — re-run the objective gates yourself

Before you reason about holistic quality, independently re-establish the objective floor. Do not inherit the worker's claims. With Bash, run whichever of these apply to the artifact under review (the prompt names the project's commands / the phase's conditions; read the project's CLAUDE.md / AGENTS.md / harness config for the exact commands):

  • Typecheck / build — the project's typecheck or compile command. Confirm zero NEW errors versus the stated baseline. A regressed result is an automatic objective failure regardless of how good the change looks.
  • Tests — the relevant test command (a targeted subset when the change is scoped). Read the real pass/fail counts.
  • Lint — the project's lint command, for the changed files.
  • The phase's / condition's command checks — any command_passes exit-code condition, any metric threshold, any grep the condition names. Run them; read the real exit code.
  • Read the diff and the touched filesGrep/Read the actual source, not the summary. Verify scope was respected (edits landed only where they should), look for dead code left behind, and scan for the project's banned patterns (from CLAUDE.md / AGENTS.md / the harness rules).

Read the full file on GitHub · 137 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 · 137 lines · 132 tokens per session scan A e6d468b248c0

Subscribe to this mod's changes

arbiter is an agent published in the GitHub repository SethGammon/Citadel (914 stars, last pushed 5d ago), licensed MIT. It adds 132 tokens to every session and 1,874 once invoked, about $0.0007 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-30.