notque/vexjoy-agent / skills/meta/building-with-jev
building-with-jev
VerifiedWrite, compose, integrate, and improve programs that call Jev, TypeSafe's System One judgment model.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 52.9 KB |
| references/composition-patterns.md | markdown | 15.7 KB |
| references/composition-positions.md | markdown | 3.1 KB |
| references/cookbook-techniques.md | markdown | 6.4 KB |
| references/decision-card.md | markdown | 2.6 KB |
| references/dissolving-a-skill.md | markdown | 4.7 KB |
| references/game-review-questions.md | markdown | 6.0 KB |
| references/hill-climbing.md | markdown | 8.6 KB |
| references/images.md | markdown | 20.1 KB |
| references/improve-and-calibrate.md | markdown | 10.7 KB |
| references/integration-lifecycle.md | markdown | 7.2 KB |
| references/iteration-with-jev.md | markdown | 7.6 KB |
| references/models-and-limits.md | markdown | 7.4 KB |
| references/primitives.md | markdown | 10.2 KB |
| references/question-design.md | markdown | 14.9 KB |
| references/state-and-budget.md | markdown | 12.3 KB |
references/decision-card.md
View on GitHub# Decision card
Complete one card per gate or judgment before writing code. Each field
constrains the design; an empty field is a gap, not an option.
## Fields
1. **Desired behavior.** State the decision, the unit it applies to, and what
happens when the system acts correctly. Name a non-Jev baseline (majority
class, strongest single signal, existing rule) and its measured accuracy.
2. **Judgments.** List every Jev question, its primitive, and what each returned
number means for this domain. Define "high," "low," and "ambiguous" with
concrete examples.
3. **Evidence source.** Name the data the state draws from, its refresh rate,
and any coverage gaps (missing labels, skewed slices, stale sources). State
which gaps the design tolerates and which would invalidate it.
4. **Deterministic policy.** Write the pure function `policy(answers) -> action`
with named thresholds. State which code path owns each action and who is
accountable for the outcome.
5. **Batchable vs dependent steps.** Mark each question as batchable (runs in
the same request, no data dependency) or dependent (needs a prior answer
before it can be asked). Dependent steps add a second request; justify each.
6. **Failure and abstention.** Define behavior when Jev is unavailable, when
confidence is below the gate, and when the response is malformed. State
whether the gate fails open, fails to warn, or fails to block.
7. **Falsifying experiment.** Describe the smallest labeled test that could
reject this design: the split, the metric, and the threshold below which
the gate is not worth shipping.
8. **Versions.** Pin the Jev model id, the rubric version (date or hash), and
the policy version. State what triggers re-evaluation: a model upgrade, a
rubric edit, a data distribution shift, or a policy change.
9. **Evaluation integrity.** Record fixture and rubric hashes, human/provisional
label provenance, and an untouched group-disjoint heldout. State
that unavailable or invalid answers are `unknown` with separate failure
receipts, not quality scores. Reserve the heldout for one post-selection run.
10. **Action safety.** For any action-changing selector, define shadow-mode
evidence required before enforcement. Name the source-evidence ledger and
constraints such as permissions that confidence cannot override.
## Usage
Fill the card in the ADR, design doc, or code comment before the first Jev
call ships. Review the card when any version field changes. A gate that ships
without a card has no defined failure behavior and no falsifying experiment
-- it cannot be evaluated or retired.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |