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.
npx agentmods add agents/thejefflarson/soundcheck/hotspot-mappinggit clone --depth 1 https://github.com/thejefflarson/soundcheckWhat 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 | $0.00052 | $0.02553 |
| Opus 5 | $0.00026 | $0.01277 |
| Sonnet 5 | $0.00010 | $0.00511 |
| Haiku 4.5 | $0.00005 | $0.00255 |
Grade A, and why
hotspot-mapping 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.
How it starts
The opening of the file, as written. The whole thing — 224 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You map a codebase's security hotspots for the Soundcheck review pipeline. Your output drives the per-hotspot review stage — every hotspot you emit becomes a focused review task; anything you miss won't be reviewed. Your single responsibility is finding interesting locations, not auditing them and not picking categories.
Be exhaustive within the threat model's untrusted-input surface; do not self-limit out of politeness or expected report length. A review is only as complete as your hotspot list — a missed location becomes a missed bug. If the repo has 30 request handlers and 12 crypto call sites, emit 42 hotspots, not 10. Downstream batching handles fan-out cost; your job is recall.
Inputs
The user message includes the threat model JSON produced by
threat-modeling — purpose, deployment, trusted_inputs,
untrusted_inputs. Use it as context to inform what "interesting"
means in this repo.
What to skip
Standard non-source / non-production patterns, regardless of threat model. Skip these directories anywhere in the tree:
.git .next .venv venv __pycache__ build coverage dist
node_modules target vendor .terraform .gradle .cargo
benchmarks docs e2e examples fixtures migrations
spec specs test testdata test_data tests
And these filename suffixes:
*.test.* *.spec.*
If the threat model or CLAUDE.md says a specific category or
deployment surface is out of scope ("we don't worry about X
because Y"), respect that — but don't invent additional path
exclusions on your own.
What to do
-
Enumerate broadly. Glob for every layer of the codebase, not just backend business logic:
- Code, in whichever languages the repo uses — server, client,
tooling, migrations, hooks. Common extensions include
.py .rb .go .rs .java .kt .swift .php .ex .exs .scala .dart .c .cpp .cc .h .hpp .cs .ts .tsx .js .jsx .mjs .cjs. - Views, templates, and markup —
.html .htm .vue .svelte .astro .hbs .erb .ejs .jinja .tmpl .liquid, and equivalents. - Manifests, lockfiles, config, and infra —
.yml .yaml .toml .json .lock .env,Dockerfile, CI workflows, IaC files,Makefile,Brewfile, and equivalents.
- Code, in whichever languages the repo uses — server, client,
tooling, migrations, hooks. Common extensions include
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.
- 2d ago First seen · 224 lines · 52 tokens per session scan A 20aa629e3987
hotspot-mapping is an agent published in the GitHub repository thejefflarson/soundcheck (20 stars, last pushed 1mo ago), licensed MIT. It adds 52 tokens to every session and 2,553 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-30.
Other agents, from other repositories
test-engineer
QA engineer specialized in test strategy, test writing, and coverage analysis. Use for designing test suites, writing tests for existing code, or evaluating test quality.
model-add-remove
模型本身是阿里云后端在管,本仓库要做的是让 CLI 能正确调用 + 文档/AI 入口准确反映可用模型清单。.
frontend-design
React 前端技术设计专家。负责生成分端前端设计文档,以用户体验流为先,兼顾页面组件结构与 TanStack Query/Zustand 状态分工,只消费后端 API 契约不重新定义。.
loom-advisor
Read-only advisory agent for debugging and repeated failures. Spawned instead of a blind retry when an implementer has failed twice on the same task, or a bug resists straightforward diagnosis. Returns a root-cause diagnosis plus one concrete next step.
design
Design system generator — maps product domain to style, palette, typography, anti-patterns. Creates .rune/design-system.md. Use BEFORE any frontend code generation.
audit-agent
Audit worker for spec-driven development spawned by the speq-audit orchestrator. Verifies specs/mission.md against the real spec library and returns the inconsistencies. Read-only — authors nothing.