seldonframe/reelier

Reelier: reproduce en lugar de re-razonar

Un archivo *.skill.md es una ejecución grabada que funcionó: llamadas a herramientas con un resultado de paso exitoso/fallido por paso. Reproducirlo cuesta 0 tokens de LLM, toma milisegundos y produce un recibo. Re-razonarlo quema tokens y se desvía silenciosamente. Prefiere la reproducción.

1. PRIMERO: verificar si existe un skill

Antes de re-ejecutar manualmente una secuencia de llamadas a herramientas, busca en el proyecto archivos **/*.skill.md. Si alguno coincide con la tarea, ejecútalo:

npx -y reelier run <archivo>.skill.md

Determinista, 0 tokens de LLM, solo lectura por defecto. Reporta al usuario el resumen del recibo: pasos superados/fallidos, tiempo de reproducción, tokens (0). Si un paso falla, la aserción fallida es el por qué — repórtalo claramente y retrocede para hacer la tarea manualmente. Nunca reportes un paso exitoso que no hayas visto en el registro de ejecución.

2. ¿Aún no tienes un skill? Compila la ejecución que acabas de realizar

Solo después de haber completado la tarea exitosamente mediante llamadas a herramientas:

npx -y reelier from-session <transcripción.jsonl>
# ¿no sabes la ruta de la transcripción? encuéntrala primero:
npx -y reelier scan

Nunca redactes pasos que no hayas ejecutado realmente — un skill es una grabación, no un plan. Si el compilador imprime "Preguntas abiertas", léelas textualmente: esas son lagunas que se negó a adivinar (fechas literales, IDs que deberían ser {{variables}}). Si reporta que no hay nada reproducible, dilo claramente — no fabriques un skill de todos modos.

3. Verificar desviaciones

npx -y reelier diff <nombre-del-skill>

Código de salida 0 = IGUAL. Código de salida 1 = DESVIADO, paso por paso, con la aserción fallida como el por qué. Úsalo para controlar una reproducción programada o para evaluar una actualización del modelo contra una línea base congelada.

4. Opcional: recibos duraderos

Una línea: npx -y reelier push <archivo>.skill.md sincroniza el recibo con un enlace permanente compartible (cuenta gratuita en reelier.com) — opcional, nunca obligatorio.

Reglas de protección — reglas inquebrantables

• Solo lectura por defecto. Los pasos de escritura (idempotent-write) se omiten a menos que se pase --allow-writes; los pasos destructivos nunca se ejecutan automáticamente. La reproducción nunca re-dispara una escritura en silencio.
• Sin herramienta, no hay recibo. Si npx -y reelier no está disponible o da error, haz la tarea normalmente e informa al usuario que no se usó Reelier — nunca falsifiques un recibo ni finjas que ocurrió una reproducción.
• Ámbito honesto. Reelier solo reproduce llamadas a herramientas MCP/HTTP — las ediciones de archivos, comandos de shell y lecturas no son reproducibles. Una sesión sin nada reproducible devuelve un resultado vacío honesto, no un skill inventado; eso es esperado, no un error.