# 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.

## 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

- [agent/answer-first](https://pseo.mikkelkrogsholm.dk/regler/agent/answer-first/)
- [agent/stable-heading-anchors](https://pseo.mikkelkrogsholm.dk/regler/agent/stable-heading-anchors/)
- [agent/llms-txt](https://pseo.mikkelkrogsholm.dk/regler/agent/llms-txt/)