claudeers.
// Productivity

jev-demo

Jev decide, el LLM razona: triage de Jira, pre-vuelo de código y router de modelos para PRs, con skills de Claude Code

// Productivity[ cli ][ api ][ mobile ][ claude ]#claude#productivity$open-sourceupdated about 1 month ago
Repository unavailable
0/100
last commit —
last release none
releases 0
open issues 0

Install with your AI

This project is repository unavailable — not recommended for automated install, so we don't generate an auto-install prompt for it. Read the repo and decide for yourself.

// compatibility

Platformscli, api, mobile
Operating systems—
AI compatibilityclaude
License—
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

jev-demo

Jev decide, el LLM razona. Tres demos con servicios reales (Jev, Claude, Jira y GitHub) sobre el mismo patrón:

estado → pregunta tipada → Jev → probabilidad → tu código decide → acción

Jev (TypeSafe AI) no escribe texto: responde preguntas cerradas (elige una opción, sí/no, una puntuación) con su probabilidad, en milisegundos y por fracciones de centavo. Tu código decide qué hacer con esa probabilidad, y Claude solo trabaja donde hace falta, con el modelo que hace falta.

DemoQué haceCarpetaSkills
1 · Triage de JiraJev clasifica cada ticket (tipo, prioridad, equipo y si necesita a una persona); tu código aplica, aplica y marca para revisión, o escala.demo1-triage//triage, /lote
2 · Pre-vueloAntes de tocar código, Jev revisa cada función y marca las que ya tienen problemas. Claude explica solo las marcadas.demo2-pre-vuelo//pre-vuelo
3 · Router de PRsJev decide qué PR va a reglas sin LLM, cuál a Haiku y cuál a Sonnet. Claude revisa y comenta en GitHub.demo3-router//router, /comparar
CostosTokens y USD de cada ejecución: "solo LLM" (todo a Sonnet) frente a "con Jev".scripts/costs.ts/costos

Todo es real: no hay modo simulado. Cada comando llama a los servicios de verdad y los tokens salen del usage de cada API.

Requisitos

  • Node 22.18 o más nuevo (node --version). Ejecuta TypeScript directo: no hay dependencias ni npm install.
  • Claude Code con sesión iniciada. Los scripts llaman a Claude con claude -p: no necesitas API key de Anthropic.
  • Llave de Jev (TYPESAFE_API_KEY), de la consola de TypeSafe AI. Con unos dólares de saldo te sobra: cada demo cuesta centavos.
  • Jira Cloud (el plan gratuito sirve) y un token de API.
  • git y GitHub CLI (gh auth login) para la demo 3.

Dónde está cada cosa

La configuración de Jev

ArchivoQué es
shared/jev.tsEl cliente de Jev. Un fetch a POST https://api.typesafe.ai/v1/systemone con model, state (los datos) y questions; vuelven answers con probabilidades y usage. Tiene tres bloques: las formas de preguntar (choice, noul, score), la llamada (askJev) y el costo.
demo1-triage/questions.tsLo que se le pregunta a Jev en la demo 1: 4 preguntas por ticket (tipo, prioridad, equipo, si necesita a una persona).
demo2-pre-vuelo/questions.tsDemo 2: 6 preguntas por función (responsabilidades, oculta errores, muta la entrada, números mágicos, lógica duplicada, severidad).
demo3-router/questions.tsDemo 3: 2 preguntas por PR (complejidad y si toca dinero).
shared/thresholds.tsLo que decide tu código con esas probabilidades. Un bloque por demo: THRESHOLDS + decide(), SCAN + flagsFrom() y ROUTER + routeFor(). Son números tuyos, no del modelo, y están cubiertos por pruebas.
shared/prices.jsonUSD por millón de tokens de Jev, Sonnet y Haiku. Revísalos antes de comparar costos.
.envLlaves y modelos (JEV_MODEL, MODEL_SMALL, MODEL_LARGE). Se copia de .env.example; nunca lo subas a git.

Si Jev clasifica mal, ajusta las descripciones de los criteria en los questions.ts. Si quieres que actúe con más o menos cautela, mueve los umbrales.

Las demos

RutaQué es
demo1-triage/classify.tsLlama a Jev con las preguntas del ticket y decide la acción con decide().
demo1-triage/triage.tsClasifica issues que ya existen (npm run triage -- KAN-1). Lo usa /triage.
demo1-triage/batch.tsClasifica todo el backlog en paralelo y compara contra data/humanreview.json. Lo usa /lote.
demo1-triage/jira.tsCliente de Jira Cloud y mapeo de las opciones de Jev a tipos y prioridades de Jira.
demo1-triage/llm.tsEl "antes" de la demo 1: el mismo triage solo con Claude.
demo2-pre-vuelo/scan.tsEl comando de la demo 2: lee el ticket, parte los archivos en funciones, pregunta a Jev y manda solo lo marcado a Claude.
demo2-pre-vuelo/analyze.tsLa llamada a Jev por función, con caché, y flagsFrom().
demo2-pre-vuelo/split.tsParte un archivo en funciones, sin AST.
demo2-pre-vuelo/explain.tsClaude explica una función marcada. Con --mode=direct, el "antes": Claude revisa todas.
demo3-router/router.tsUna llamada a Jev por PR; routeFor() elige la ruta.
demo3-router/review.tsRevisa las PRs (--mode=jev o --mode=direct) y, con --comment, comenta en GitHub.
demo3-router/llm.tsRevisión con Claude o con reglas locales (cero tokens).
demo3-router/compare.tsTabla "solo LLM" frente a "con Jev": tokens, costo, ahorro y proyección.
demo3-router/import-prs.mjsTrae PRs reales de cualquier repo a un JSON.
scripts/open-prs.mjsRecrea las 20 PRs de data/prs-real.json como PRs abiertas en tu fork.
scripts/seed.ts, clean.ts, reset.tsSiembran el backlog en Jira, lo devuelven al punto de partida o lo borran.
scripts/costs.tsCosto de cada ejecución, una tabla por demo.

Los skills de Claude Code (.claude/skills/)

SkillQué haceScript
/triage <queja de cliente>Claude redacta y crea el issue con el MCP de Atlassian; Jev lo clasifica.npm run triage
/loteJev clasifica todos los tickets pendientes del backlog. Solo se activa a mano porque escribe en Jira.npm run batch -- --no-create
/pre-vuelo KAN-XXX [solo-jev]Jev revisa las funciones que toca el ticket; sin solo-jev, Claude explica las marcadas.npm run scan
/router [sin comentar]Jev elige el modelo de cada PR, Claude revisa y comenta en tu fork. Solo se activa a mano porque escribe en GitHub.npm run review -- --mode=jev
/compararSolo LLM frente a con Jev en la demo 3.npm run compare
/costos [1,2]Costo de cada ejecución, una tabla por demo.npm run costs

Cada skill solo ejecuta y resume: Claude no clasifica ni elige rutas; eso lo hacen Jev y tu código. El MCP de Atlassian ya está en .mcp.json: al abrir Claude Code en este repo, acéptalo y autentícate con /mcp → atlassian.

Datos

RutaQué es
data/tickets.json30 tickets de una tienda en línea: 27 claros y 3 ambiguos (T28–T30). Es lo que siembra seed.
data/humanreview.jsonTipo, prioridad y equipo esperados de cada ticket, según una persona. batch compara a Jev contra esto (por key o, si tus keys son otras, por título).
data/tickets-files.jsonQué archivos de Medusa toca cada ticket (demo 2).
data/prs-real.json20 PRs reales de medusajs/medusa, con el commit de cada una para recrearlas.
data/prs-fork.json(lo generas tú) Esas 20 PRs, abiertas en tu fork.
results-backup/Ejecuciones de ejemplo, incluidos los tres "antes" (todo a Sonnet), para que /comparar y /costos funcionen sin gastar. Son de nuestro Jira y nuestro fork: para comparar con lo tuyo, genera los tuyos (paso 6).
results/(se crea solo, no se sube) Lo que escribe cada ejecución.

Puesta en marcha

1. Llaves

git clone https://github.com/LIDR-academy/jev-demo && cd jev-demo
cp .env.example .env     # llena las llaves
npm test                 # 16 pruebas: umbrales y lectura de respuestas
VariableDónde se consigue
TYPESAFE_API_KEYConsola de TypeSafe AI → API keys.
JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKENLa URL de tu sitio (https://TU-SITIO.atlassian.net), tu correo y un token de https://id.atlassian.com/manage-profile/security/api-tokens.
JIRA_PROJECT_KEYLa key de tu proyecto (por defecto KAN).
JIRA_TEAM_*Opcional: el id de cada equipo de Atlassian (el final de la URL del equipo, .../people/team/<id>). Sin ids, el equipo solo va en el comentario de Jev.

2. Jira

  1. Crea un proyecto de software (team-managed), por ejemplo KAN.
  2. Si tu Jira está en español, los tipos son Error, Historia y Tarea, y ya están mapeados. Si está en inglés, cambia ISSUE_TYPE en demo1-triage/jira.ts a Bug, Story y Task.
  3. Opcional: crea los equipos Pagos, Plataforma, Frontend y Datos en Atlassian y copia sus ids a .env.

3. Sembrar el backlog

npm run seed -- --done=8    # crea los 30 tickets sin clasificar y mueve 8 a Finalizada

Quedan 22 pendientes con la etiqueta batch: son los que clasifica /lote.

4. Medusa, para la demo 2

gh repo clone LIDR-academy/medusa ../medusa-fork -- --depth 1    # o define MEDUSA_PATH en .env

El ticket "Reembolso parcial se registra como total" toca el servicio de pagos y el proveedor de Stripe de Medusa: 58 funciones de código real, sin bugs sembrados.

5. Tu fork con 20 PRs abiertas, para la demo 3

gh repo fork LIDR-academy/medusa --clone=false     # su develop está fijo en el commit de la demo
node scripts/open-prs.mjs --fork=TU-USUARIO/medusa --path=../medusa-prs --dry-run    # prepara todo en local, no envía nada
node scripts/open-prs.mjs --fork=TU-USUARIO/medusa --path=../medusa-prs              # push + 20 PRs abiertas
npm run import-prs -- --repo=TU-USUARIO/medusa --state=open --count=20 --out=data/prs-fork.json
  • Usa --path=../medusa-prs, no ../medusa-fork: ese es el clon de solo lectura del paso 4 y no apunta a tu fork.
  • Se hace fork de LIDR-academy/medusa y no de medusajs/medusa porque Medusa avanza a diario: en un fork nuevo de medusajs/medusa, los commits de estas PRs pueden quedar demasiado atrás y open-prs no los encuentra.
  • GitHub deja un solo fork de Medusa por cuenta. Si ya tienes uno, crea este en una organización tuya: gh repo fork LIDR-academy/medusa --org TU-ORG --clone=false (y usa --fork=TU-ORG/medusa).

El router solo debe comentar en PRs tuyas: /router no usa --comment si data/prs-fork.json no viene de tu fork. Al terminar: node scripts/open-prs.mjs --fork=TU-USUARIO/medusa --cleanup cierra las PRs y borra las ramas.

6. Los "antes" (todo a Sonnet, sin Jev)

Para comparar, cada demo necesita su "antes". Puedes usar los de ejemplo:

mkdir -p results && cp results-backup/*direct*.json results/

O generar los tuyos sobre tu Jira y tu fork (unos centavos en Sonnet, ~2 min):

npm run batch -- --mode=direct                              # lee tus issues; no escribe en Jira
npm run scan -- --ticket=KAN-XXX --mode=direct              # KAN-XXX: el issue "Reembolso parcial se registra como total"
npm run review -- --mode=direct --data=data/prs-fork.json

Ejecutar las demos

Abre Claude Code en la raíz del repo:

/triage Pagué con débito y me llegaron dos cargos por el mismo pedido
/lote
/pre-vuelo KAN-XXX solo-jev
/pre-vuelo KAN-XXX
/costos 1,2
/router
/comparar
/costos

Qué deberías ver:

  • /triage: el issue nuevo con tipo, prioridad y equipo, cada uno con su %, y la acción (apply). En Jira, el comentario de Jev con cada decisión.
  • /lote: 22 tickets en ~2 s por menos de un décimo de centavo. Casi todos apply; los 3 ambiguos ("No funciona", "Cambiar el color del botón de pagar y arreglar el cobro doble", "¿Esto es normal?") se escalan a una persona con la etiqueta escalado. "Tipo+equipo OK" compara contra data/humanreview.json.
  • /pre-vuelo … solo-jev: 58 funciones en ~1 s; 1 o 2 marcadas. roundToCurrencyPrecision sale siempre: su catch {} vacío esconde que, con monedas sin decimales (como el yen), el monto queda sin redondear.
  • /pre-vuelo …: Claude explica solo las marcadas. Las demás no gastan tokens de LLM.
  • /router: cada PR con su ruta. Lo trivial va a reglas (cero tokens), lo medio a Haiku, y lo complejo, lo dudoso o lo que toca dinero a Sonnet. Los comentarios aparecen en tus PRs.
  • /comparar y /costos: el ahorro con Jev en cada demo.

Los números cambian un poco entre ejecuciones, sobre todo en los casos que están justo en el umbral.

Sin Claude Code

Los mismos pasos con npm:

npm run triage -- KAN-XXX                            # un issue que ya existe
npm run batch -- --no-create                         # demo 1
npm run scan -- --ticket=KAN-XXX --explain           # demo 2 (sin --explain: solo Jev)
npm run review -- --mode=jev --data=data/prs-fork.json [--comment]   # demo 3
npm run compare
npm run costs

Repetir la demo

npm run limpiar    # quita lo que hizo Jev en el backlog, borra los issues de /triage y vacía results/ salvo los "antes"; las keys no cambian
npm run reset      # empieza de cero: borra los issues de la demo (después, npm run seed)

limpiar no toca GitHub: los comentarios del router se quedan en tus PRs hasta que los borres o hagas --cleanup.

Umbrales

Todos en shared/thresholds.ts; se pueden mover sin tocar código con estas variables en .env:

VariableDefaultEfecto
THRESHOLD_APPLY0.70Confianza mínima (la más baja de tipo, prioridad y equipo) para aplicar directo.
THRESHOLD_FLAG0.50Entre esto y APPLY: aplica y etiqueta revisar. Debajo, escala.
THRESHOLD_HUMAN0.50Si la probabilidad de que haga falta una persona llega a esto, escala sin tocar el ticket.
SCAN_THRESHOLD0.60Pre-vuelo: desde qué probabilidad una señal cuenta como marca.
ROUTER_MONEY_THRESHOLD0.50Si la PR toca dinero con esta probabilidad, va a Sonnet siempre.
ROUTER_MIN_CONFIDENCE0.60Debajo, la PR va a Sonnet aunque parezca trivial.

Límites

  • Jev no explica ni razona: elige entre opciones que tú definiste. En la demo 2, Jev dice dónde mirar; Claude dice qué está mal.
  • Como cualquier modelo, es vulnerable a texto malicioso dentro del ticket o la PR. Por eso los umbrales y la revisión humana viven en tu código.
  • El ahorro de la demo 3 depende de la mezcla de PRs: con más PRs triviales sube; con más PRs de pagos, baja.

// faq

What is jev-demo?

Jev decide, el LLM razona: triage de Jira, pre-vuelo de código y router de modelos para PRs, con skills de Claude Code. It is open-source on GitHub.

Is jev-demo free to use?

jev-demo is open-source, so it is free to use.

What category does jev-demo belong to?

jev-demo is listed under productivity in the Claudeers registry of Claude-compatible tools.

9 views
★ 15 stars
unclaimed
updated about 1 month ago

// embed badge

jev-demo on Claudeers
[![Claudeers](https://claudeers.com/api/badge/jev-demo.svg)](https://claudeers.com/jev-demo)

// retro hit counter

jev-demo hit counter
[![Hits](https://claudeers.com/api/counter/jev-demo.svg)](https://claudeers.com/jev-demo)

// reviews

// guestbook

0/500

// related in Productivity

🔓

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

// productivitykepano/★ 52,609◷ MIT[ claude ]
🔓

Open source repository of plugins primarily intended for knowledge workers to use in Claude Cowork

// productivityanthropics/⟨Python⟩★ 34,871◷ Apache-2.0[ claude ]
🔓

Garry's Opinionated OpenClaw/Hermes Agent Brain

// productivitygarrytan/⟨TypeScript⟩★ 33,099◷ MIT[ claude ]
🔓

An open-source alternative to Claude Cowork (powered by opencode)

// productivitydifferent-ai/⟨TypeScript⟩★ 24,523◷ NOASSERTION[ claude ]
→ see how jev-demo connects across the ecosystem