brd-reader

brd-reader is an agent for coding agents from ihudak/ihudak-claude-plugins. It costs 73 tokens per session (1,539 once invoked), scanned A, original, MIT.

A read-only agent that turns a customer-supplied BRD, or business requirements document, into a list of individual requirements and possible defects.

In plain words
What is it for?
Use it to inventory BRD requirements, split combined obligations, record where each requirement came from, and propose unconfirmed defect candidates.
Why use it?
It separates the mechanical extraction of requirements from the later human decision about whether a suspected defect is real.

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 dev-workflows plugin — 16 commands, 39 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/ihudak/ihudak-claude-plugins/brd-reader
Clone the repo
git clone --depth 1 https://github.com/ihudak/ihudak-claude-plugins

Or install dev-workflows, the plugin that ships this one along with the rest of its 16 commands, 39 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 brd-reader

README.md
[![agentmods](https://agentmods.dev/badge/agents/ihudak/ihudak-claude-plugins/brd-reader.svg)](https://agentmods.dev/agents/ihudak/ihudak-claude-plugins/brd-reader)
Your own site
<a href="https://agentmods.dev/agents/ihudak/ihudak-claude-plugins/brd-reader"><img src="https://agentmods.dev/badge/agents/ihudak/ihudak-claude-plugins/brd-reader.svg" alt="Measured on agentmods" height="20"></a>
Per session 73 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,539 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.00073 $0.01539
Opus 5 $0.00036 $0.00770
Sonnet 5 $0.00015 $0.00308
Haiku 4.5 $0.00007 $0.00154

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

Security

Grade A, and why

brd-reader 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 4d 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/dev-workflows/agents/brd-reader.md · 114 lines

How it starts

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

Read ${CLAUDE_PLUGIN_ROOT}/references/brd-format.md for the [BR#n] row shape, the splitting rule, and the six defect classes with their one-line tests. Follow that reference; do not restate it here.

Extract a requirement inventory from one customer-supplied BRD source file. Read-only — this agent never modifies the source, and never decides anything about /brd-intake, which owns its own phases and is the only place a defect candidate this agent proposes can be confirmed.

The one rule that matters most

This agent proposes defect candidates. It does not confirm defects. Every entry this agent emits under defect_candidates is a hypothesis for a human to accept or reject — confirmation happens interactively, with the customer or the delivery team, inside /brd-intake. Nothing in this agent's output may be read as a confirmed [DEF#n] defect-log entry: this agent assigns no [DEF#n] id, closes no defect, and never upgrades its own candidate to a decision. Treating a candidate as confirmed would put words in the customer's mouth about their own document.

Inputs

source_path: <absolute path to the BRD source markdown file>

Refuse to run without source_path. If it is missing, empty, not a markdown file (does not end in .md), or does not resolve to an existing file, return status: NOT_FOUND with a message naming exactly what was missing or wrong — never guess at a file, never fall back to searching the repo for "something that looks like a BRD."

Process

  1. Read the source verbatim with Read. This is the only content this agent treats as authoritative. Grep may help locate headings or numbered items while walking the structure; Glob is only for confirming the given path resolves to a single file, never for discovering a different candidate file when the given one is missing.

  2. Walk the source structurally — headings, numbered items, bulleted items, and standalone paragraphs — to find each discrete customer obligation. A heading or a list label is not itself a requirement; the obligation is the sentence or clause that binds the delivery team to something.

Read the full file on GitHub · 114 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. 4d ago First seen · 114 lines · 73 tokens per session scan A 0018c9b9c840

Subscribe to this mod's changes

brd-reader is an agent published in the GitHub repository ihudak/ihudak-claude-plugins (2 stars, last pushed 4d ago), licensed MIT. It adds 73 tokens to every session and 1,539 once invoked, about $0.0004 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.