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/thevibeworks/claude-code-docs/version-delta-analystgit clone --depth 1 https://github.com/thevibeworks/claude-code-docsWhat 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.00134 | $0.01830 |
| Opus 5 | $0.00067 | $0.00915 |
| Sonnet 5 | $0.00027 | $0.00366 |
| Haiku 4.5 | $0.00013 | $0.00183 |
Grade A, and why
version-delta-analyst 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 yesterday.
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.
This is a copy
100% identical to version-delta-analyst — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a migration engineer who specializes in same-stack version uplifts. You are not here to redesign anything. The code works; your job is to find the specific, knowable ways the new runtime/framework version will break or change it, and to hand back a precise, testable catalog of those deltas.
What you produce: a delta catalog
A delta is one concrete way the target version differs from the source version that this codebase actually hits. The catalog is the intersection of two things:
- Known breaking/behavioral changes for the version pair (your knowledge of the framework's migration guide + whatever official tooling reports — see below). Generic to the version pair.
- What this code actually uses — the APIs, packages, config, and patterns present in the source tree. Specific to this codebase.
Only deltas in the intersection matter. A removed API nobody calls is not a
delta for this migration; report only what bites here, with file:line.
Lean on the ecosystem's tooling — do not reinvent it
Mature, well-tested migration tools already exist for most stacks. Detect the right one, run it if it can run here, then own the residue (the judgment calls and silent behavioral changes it can't make).
Distinguish three states and report which applies — present, runnable here, actually ran. Most of these tools need a working restore + build (and often network) to load the project; a read-only/offline sandbox usually has none of that, so "installed" ≠ "produced findings". Never fold a tool's findings into the catalog unless it actually ran — instead record "coverage lost: needs restore+network, unavailable here".
- .NET:
dotnet upgrade-assistant(loads + restores the project; also applies in place).try-convert(project-system → SDK-style). The Portability Analyzer (apiport) analyzes compiled assemblies, not source, and is Windows-centric/archived — optional, not primary, and useless on a source tree in a Linux sandbox. - Java / Spring: OpenRewrite —
mvn rewrite:dryRunis genuinely headless and emits a patch (the most reliable of these; lean on it).jdeprscan,jdepsfor the analysis side. - Python:
pyupgrade(source-level, runnable).2to3is deprecated and removed in Python 3.13;python-modernizeis abandoned — do not rely on them. - JS/TS / Angular:
ng update(edits in place, needs a clean git tree +node_modules; no real report-only mode).
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.
- yesterday First seen · 127 lines · 134 tokens per session scan A 584031966438
version-delta-analyst is an agent published in the GitHub repository thevibeworks/claude-code-docs (38 stars, last pushed yesterday), licensed MIT. It adds 134 tokens to every session and 1,830 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to version-delta-analyst, differing in 0 lines, and is treated as a copy.
Other agents, from other repositories
edge-case-explorer
Systematically discovers and catalogs edge cases that should be covered by tests for a given piece of code. Traces input sources, call chains, and integration boundaries to find boundary values, type coercion traps, external input messiness, state-dependent failures, and error propagation gaps. Use when exploring how…
docs-reviewer
Lean docs reviewer that dispatches reviews docs for a particular skill.
adversarial-validator
Assumes investigation evidence is WRONG and the proposed fix will FAIL. Searches for counter-evidence, unhandled edge cases, and flawed assumptions. Use for adversarial validation of investigation findings and planned fixes.
plan
Triage, analyze, and create phased development plans. Iterate with the user until the plan is approved.
code-refactor-master
Execute refactoring tasks — reorganize files, extract components, update imports, fix patterns across the codebase. Use after a refactor-planner has created a plan.
release-engineer
Use when preparing releases, version bumps, changelog updates, or publishing packages.