agent/token-efficiency
Visible text makes up a reasonable share of the HTML bytes. Reglen agent/token-efficiency kører i page-scope med severity 'warning' og indgår i agent-parathed-domænet sammen med 7 andre kontrakter i frameworket.
Hvorfor token-efficiency findes
AI agents fetch pages under context-window pressure: boilerplate-heavy HTML gets truncated before the content. Pages over 30 KB where visible text is under 10% of the bytes are mostly markup — inline data blobs, SVG bloat, or wrapper-div soup.
Sådan håndhæves token-efficiency
Reglen token-efficiency evalueres på hver enkelt renderet HTML-side for sig, så et fund altid kan føres tilbage til én konkret side og én konkret rettelse i data eller template. Fejler en side, får agenten en finding, hvor fix-instruktionen for token-efficiency er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'warning' betyder at et brud på token-efficiency rapporteres uden at blokere builds — men guld-standarden er først nået, når også advarslerne er væk.
Domænet: agent-parathed
Agent-domænet gør sitet læsbart for AI-assistenter: llms.txt og llms-full.txt, markdown-spejle af hver side, korrekt encoding af danske tegn, svar-først-afsnit og stabile ankre til citationer. Det er det mindst kommodiserede domæne — og det hurtigst voksende discovery-lag. Netop derfor hører token-efficiency hjemme her: kravet kan afgøres maskinelt, og dermed kan det håndhæves i stedet for blot at blive anbefalet.
Test og fixtures
Som alle kontrakter i frameworket har agent/token-efficiency en mutant-test, der beviser at reglen fejler, når kravet brydes — en regel uden en fejlende test er ikke en regel. Golden-fixturet beviser omvendt, at en fuldt compliant side består token-efficiency sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.
Relaterede regler
Tilbage til oversigten over alle 86 regler.