ax-refine

name	ax-refine
description	Use this skill when writing or reviewing Ax bestOfN/refine code, reward functions, thresholds, native sample selection, serial attempts, generated advice, and attempt diagnostics.
version	23.0.14

Ax Refine And BestOfN

Use bestOfN(...) when you can score complete outputs independently. Use refine(...) when failed rounds should produce feedback that changes the next attempt.

Validation And Assertions

Keep reward scoring, whole-output assertions, and streaming assertions separate:

• Use schema validation for shape, types, and field-level constraints.
• Use addAssert(...) for whole-output hard invariants. Failed assertions feed correction text into the normal retry loop.
• Use addStreamingAssert(...) for partial streaming hard invariants. It aborts the current stream attempt as soon as the partial field fails, then feeds correction text into the normal retry loop.
• Use bestOfN(...) for complete-candidate selection.
• Use refine(...) for reward-scored retry rounds with generated feedback.

APIs

import { bestOfN, refine } from '@ax-llm/ax';

const selected = bestOfN(program, {
  n: 4,
  threshold: 0.8,
  :  (prediction),
});

 improved = (program, {
  : ,
  : ,
  : ,
  : ,
  :  (prediction),
});