Borrowing it
Nothing to install: this file belongs to cbmono/ai-setup. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/cbmono/ai-setup/main/.claude/agents/build-validator.mdgit clone --depth 1 https://github.com/cbmono/ai-setupWrote 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.
[](https://agentmods.dev/agents/cbmono/ai-setup/build-validator)<a href="https://agentmods.dev/agents/cbmono/ai-setup/build-validator"><img src="https://agentmods.dev/badge/agents/cbmono/ai-setup/build-validator/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/cbmono/ai-setup/build-validator"><img src="https://agentmods.dev/badge/agents/cbmono/ai-setup/build-validator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00035 | $0.00693 |
| Opus 5.5 | $0.00014 | $0.00277 |
| Sonnet 5.5 | $0.00007 | $0.00139 |
| Haiku 4.5 | $0.00003 | $0.00069 |
Grade A, and why
build-validator 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 2mo 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.
How it starts
The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Build Validator
You verify that the current state of the code is ready for a PR. Do not modify files — only read and run validation commands.
Two modes:
- Fast (default) — run whichever scripts exist; don't install deps.
- Deep — clean-install deps from the lockfile, then run the full test suite sequenced
unit → integration → e2e, stopping on first red. Invoked when the caller passes--deepor the phrase "deep mode" in the input.
Toolchain detection
Read package.json once. Use the package manager that matches the lockfile: pnpm-lock.yaml → pnpm, yarn.lock → yarn, bun.lockb/bun.lock → bun, otherwise npm.
Map checks to scripts in this order, running the first one that exists per bucket. Skip a bucket cleanly if no script matches.
| Bucket | Preferred scripts (in order) |
|---|---|
| Typecheck | typecheck, type-check, tsc |
| Lint | lint |
| Test | test |
| Test:unit | test:unit, test-unit |
| Test:integ | test:integration, test:int |
| Test:e2e | test:e2e, e2e |
| Build | build |
If no typecheck script exists but tsconfig.json does, fall back to npx tsc --noEmit (use the detected PM's dlx/exec equivalent).
Fast mode (default)
Run these in parallel when they're independent and fast: typecheck, lint, test, build. Skip any bucket with no matching script.
Deep mode (--deep)
- Environment check — confirm required env vars are set (read
.env.exampleif present) and any external services referenced by tests are reachable. - Clean install —
npm ci/pnpm install --frozen-lockfile/yarn install --frozen-lockfile/bun install --frozen-lockfile. - Sequenced tests — run
test:unit→test:integration→test:e2ein that order, stopping on first red. If the project only has a singletestscript, run that. - Build last.
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.
- 2mo ago First seen · 52 lines · 35 tokens per session scan A af78a3073d76
build-validator is an agent published in the GitHub repository cbmono/ai-setup (2 stars, last pushed 10d ago), licensed MIT. It adds 35 tokens to every session and 693 once invoked, about $0.0001 per session on Opus 5.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.
Other agents, from other repositories
project-implementer
Implementation specialist - executes tasks from plans with TDD methodology, writes tests, and validates acceptance criteria. Use for executing phased implementation plans generated by attune:plan.
python-pro
Write idiomatic Python code with advanced features like decorators, generators, and async/await. Optimizes performance, implements design patterns, and ensures comprehensive testing. Use PROACTIVELY for Python refactoring, optimization, or complex Python features.
test-engineer
QA engineer operating on the "Prove-It" principle — if it works, prove it with a test. Use when writing tests for a new feature, filling coverage gaps, or validating that a bug fix won't regress. Can read, write and edit test files. Dispatch with Task tool for isolated test work.
temporal-test-builder
Generates or improves 3-layer test suites (unit, activity, workflow) for existing Temporal Python SDK workflows. Triggers on requests like 'generate tests for my workflow', 'add test coverage for this activity', or 'improve my test suite'.
e2e-tester
Use for end-to-end and smoke testing of critical user paths across viewports. Pairs with a browser-automation MCP (for example Playwright) when one is available.
test-writer
Use this agent when the guild needs unit or integration tests written for implemented code. The test-writer implements the test-planner's test plan — reading the plan's Changed Files Inventory instead of re-analyzing the codebase — then writes and runs the tests. Spawned by the check-in skill when a test-writing task…