ie-predictability-reviewer

ie-predictability-reviewer is an agent for coding agents from davidteren/intent-engineering. It costs 60 tokens per session (1,004 once invoked), scanned A, original, MIT.

An always-on code and plan reviewer focused on whether names and behavior match. It looks for hidden side effects, unexpected return values, silent failures, and interfaces that behave differently from what they suggest.

In plain words
What is it for?
Reviewing code, APIs, and implementation plans for misleading names, accidental writes, inconsistent results, and failures that are hidden from callers.
Why use it?
It helps catch surprises that can make an API or codebase difficult to trust and use correctly.

Agent

Installs and runs on its own, but its text points at files inside its plugin — anything it tells you to read at a ${CLAUDE_PLUGIN_ROOT} path is only there once the plugin is installed. Installing the plugin gets both.

Part of the intent-engineering plugin — 6 skills, 5 agents shipped together

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/davidteren/intent-engineering/ie-predictability-reviewer
Clone the repo
git clone --depth 1 https://github.com/davidteren/intent-engineering

Or install intent-engineering, the plugin that ships this one along with the rest of its 6 skills, 5 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ie-predictability-reviewer

README.md
[![agentmods](https://agentmods.dev/badge/agents/davidteren/intent-engineering/ie-predictability-reviewer.svg)](https://agentmods.dev/agents/davidteren/intent-engineering/ie-predictability-reviewer)
Your own site
<a href="https://agentmods.dev/agents/davidteren/intent-engineering/ie-predictability-reviewer"><img src="https://agentmods.dev/badge/agents/davidteren/intent-engineering/ie-predictability-reviewer.svg" alt="Measured on agentmods" height="20"></a>
Per session 60 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,004 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.00060 $0.01004
Opus 5 $0.00030 $0.00502
Sonnet 5 $0.00012 $0.00201
Haiku 4.5 $0.00006 $0.00100

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

Security

Grade A, and why

ie-predictability-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 5d 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.

plugins/intent-engineering/agents/ie-predictability-reviewer.md · 86 lines

How it starts

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

Predictability Lens

You enforce the Principle of Least Astonishment, DWIM, and WYSIWYG. Your job: find every place where a reasonable developer or user would form an expectation from a name, signature, label, or preview — and then be surprised by the actual behavior. A "surprise" you can't tie to a specific broken expectation is not a finding.

Read first

Load your detection heuristics from ${CLAUDE_PLUGIN_ROOT}/resources/ — the "Violation smells" sections are your checklist:

  • principles/least-astonishment.md
  • principles/dwim.md
  • principles/wysiwyg.md
  • agnostic/naming.md
  • agnostic/error-handling.md
  • agnostic/api-design.md

What you're hunting for

  • Name/behavior mismatchget*/fetch*/load*/is*/has* that also mutates; predicate returning a non-boolean; validate that changes state; a flag whose name implies the opposite of its effect. A name is a promise; flag broken promises.
  • Hidden side effects — a query that writes, a "pure" helper that touches global state, a getter that triggers I/O or lazy persistence. Command-query separation broken.
  • Surprising returns — inconsistent return types/shapes across branches of one function or across a sibling family; returning null/[]/0 where the caller can't distinguish "empty" from "failed".
  • Silent failures — swallowed exceptions, bare catch/except, errors masked by fallback values, a dry-run/preview that doesn't match the real run.
  • DWIM gone wrong — magic coercion or intent-guessing that does the wrong thing irreversibly; OR the opposite, code so rigid it rejects obviously-valid input on a technicality. Name which side it errs on.
  • WYSIWYG divergence — what's shown (preview, optimistic UI, edit view, dry-run) diverges from the real saved result/state.
  • UX surprise (when user-facing) — a control that doesn't do what its label implies; a destructive action with no confirm/undo; the back button losing state.

Confidence calibration

Read the full file on GitHub · 86 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. 5d ago First seen · 86 lines · 60 tokens per session scan A 0197518f697e

Subscribe to this mod's changes

ie-predictability-reviewer is an agent published in the GitHub repository davidteren/intent-engineering (3 stars, last pushed 19d ago), licensed MIT. It adds 60 tokens to every session and 1,004 once invoked, about $0.0003 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.

Related

Other agents, from other repositories

guide

Answers questions about the audit plugin itself — what a config key does, how the plan gate grades, how the capability policy resolves, what the journal can and cannot prove — from the plugin's own README, reference docs, schemas and SECURITY.md, with a citation for every claim. Mechanically read-only (Read/Grep/Glob…

AleksandarBisevac/claude-plugins · 96 tokens

audit-executor

Task executor for the audit orchestrator. Implements exactly ONE manifest task with TDD/regression/gate-only test discipline and reports a structured outcome. No web tools, no nested agents; it never commits and never stashes — git belongs to the orchestrator. Spawned by the audit plugin; not meant for direct use.

AleksandarBisevac/claude-plugins · 69 tokens

audit-explorer

Read-only codebase auditor for /audit:init fan-out. Audits ONE subsystem for the requested dimensions and returns a strict-JSON findings array. Mechanically read-only — its tool list has no Edit/Write/Bash, so it cannot modify files or run shell commands. Spawned by the audit plugin; not meant for direct use.

AleksandarBisevac/claude-plugins · 72 tokens

audit-reviewer

Phase sign-off reviewer for /audit. Analyzes the phase diff (through the project review skill when one is configured) and returns structured findings. It cannot edit — no Edit/Write in its tool list; fixes are separate audit-executor runs. Spawned by the audit plugin; not meant for direct use.

AleksandarBisevac/claude-plugins · 68 tokens

bead-epic-auditor

Use this agent when auditing bead epics for closure drift — finding open epics whose entire child set is already closed (so their GitHub/Plane cluster issue never got the close fan-out), or otherwise reasoning about epic/subtree completion across a bd Dolt database.

jeremylongshore/dolt-mcp-vcs-plugin · 63 tokens

skill-analyzer

Deep analysis agent for skill quality review. Reviews skill content, instruction clarity, trigger phrase effectiveness, and provides actionable improvement suggestions.

VersoXBT/skill-manager · 29 tokens