Reference · NPL
<npl-ref>
NPL element
You write the assessment, the improvements, the validation, and any eval notes. The element lays them out as a review card after the work.
Children
-
<assessment>what held and what did not across the finished turn. -
<improvements>concrete changes the next run should carry. -
<validation>how the result was checked. -
<eval>the measured outcome (scores, counts, diffs). -
<fine-tune>training or retrieval follow-ups.
Example
npl-ref.html
source
1
<npl-ref variant="full">
2
<assessment>the approach held; one gap in the eval loop</assessment>
3
<improvements>add a regression harness before the next run</improvements>
4
<validation>checked against three traces</validation>
5
<eval>quality 0.82 vs 0.71 baseline</eval>
6
<fine-tune>retrain on the two rejected traces</fine-tune>
7
</npl-ref>
render
Live render boots with JavaScript — the authored source is alongside.
variant: compact
One emoji line per section; the authored sections are hidden from the render (kept in the source). The glanceable form for a finished turn.
variant: compact
npl-ref-compact.html
source
1
<npl-ref variant="compact">
2
<assessment>the approach held; one gap in the eval loop</assessment>
3
<improvements>add a regression harness before the next run</improvements>
4
<validation>checked against three traces</validation>
5
<eval>quality 0.82 vs 0.71 baseline</eval>
6
<fine-tune>retrain on the two rejected traces</fine-tune>
7
</npl-ref>
render
Live render boots with JavaScript — the authored source is alongside.
Source: spec/schema/npl/npl-ref.md