jev-use · diff
git:20260920.e18181a to git:20260920.d26bee2
12 added, 13 removed. Audit A to A.
---
name: jev-use
description: Use before ANY step that is a decision rather than writing: labelling, filtering or triaging MANY items; checking whether a command, test or build succeeded; picking the next action from options you can list; judging safety, quality or severity; or risk-checking each command of a checklist or pipeline before it runs. Route by where the facts already are: facts already in your context go to the jev_judge tool with ALL questions batched into ONE call; items sitting in a file or in tool output go through the `jev-use judge` CLI from a script, so that data never enters the conversation; a safety decision that blocks every tool call belongs in the `jev-use hook gate` PreToolUse hook, not in a call you make by hand. Take any verdict back with escalate: true. Never for steps that must produce new text or code, or judgments whose options you cannot enumerate.
---
# Handing off to Jev
- Per decision, measured: Jev $0.000032 / 257 ms vs claude-haiku-4.5 $0.000761 /
- 792 ms and claude-sonnet-5 $0.001494 / 1366 ms — 24x and 47x cheaper. That is a
- RATE win ($0.042/Mtok in, $0 out), not a token win: Jev spends *more* tokens per
- decision, not fewer. So the saving is real only when the decision **leaves the
- conversation** — which is what the routing below is for. You stay the planner
- and the writer.
+ Jev answers a typed judgment in ~250 ms at a judgment-model rate ($0.042/Mtok
+ in, $0 out) instead of LLM reasoning. It is a RATE win, not a token win: Jev
+ spends *more* tokens per decision, not fewer. So the saving is real only when
+ the decision **leaves the conversation** — which is what the routing below is
+ for. You stay the planner and the writer.
## Route each decision: where are the facts × does it block?
| Where the facts are | **Nothing is blocked** — you can keep working | **Blocked** — nothing proceeds until this is decided |
| --- | --- | --- |
| **Already in your context** | `jev_judge`, every question about that state batched into **ONE** call (`noul` yes/no, `choice` next action, `score` quality) | `jev_gate` on that one action before you run it — and if it is *every* tool call, wire `jev-use hook gate` as a PreToolUse hook **once** and the decision leaves the conversation for good: 24 gated commands, 17.1 s, **zero LLM tokens**, vs 46.9 s / $0.2366 through a supervisor LLM |
| **Sitting in a file or tool output** | a script pipes the file to `jev-use judge` — the items never enter your context | same CLI, from the script, then act on the verdicts it prints |
| **To be written by you** (new text, code, options you cannot enumerate) | yours | yours |
## Rules that make it pay off
- - **Never paste bulk data into `jev_judge`.** Measured on 90 items: pushing
- them through the tool by hand cost **1.66x MORE** money and 1.45x more time
- than just deciding them yourself. Instead route by reference (the CLI), or
- route only the handful you genuinely cannot settle — that lane cost less than
- pasting everything, and was the only one that got all 90 right 3 times of 3.
- - **Batch.** Measured: 12 questions about one state in ONE call took 186 ms;
- the same 12 one at a time took 2,672 ms. Never one call per item.
+ - **Route bulk data by reference.** When the items sit in a file or in tool
+ output, have a script pipe them to `jev-use judge` — data pasted into a
+ `jev_judge` call travels through your context twice, as tool input and as
+ the verdict block back. Or route only the handful you genuinely cannot
+ settle yourself.
+ - **Batch.** Measured: 12 questions about one state in ONE call took 224 ms;
+ the same 12 one at a time took 2,662 ms. Never one call per item.
- **State is everything Jev sees.** Put the relevant facts (tool output, file
excerpts, task intent) into `state`; Jev has no other context.
- **Honor escalations.** A verdict with `escalate: true` hands that question
back to you: `writing`/`open_ended` mean it was structurally yours;
`oversized` means the state was too big to judge; `unsure` means Jev's
answer is only a prior (it's still in `answer` — use it as a hint);
`unreachable` means proceed as if Jev didn't exist.
- **Don't route trivia.** If you already know the answer, just act; a Jev
call you didn't need is still a call.
Numbers, lanes, variance and caveats: `bench/RESULTS.md`.