agent/stable-heading-anchors
Section headings carry id attributes for deep linking. Reglen agent/stable-heading-anchors kører i page-scope med severity 'warning' og indgår i agent-parathed-domænet sammen med 7 andre kontrakter i frameworket.
Hvorfor stable-heading-anchors findes
AI engines and humans cite sections via fragment URLs (#section-id). Headings without ids cannot be deep-linked, and auto-generated ids that churn between builds break citations that already exist. Ids should be deterministic slugs of the heading text.
Sådan håndhæves stable-heading-anchors
Reglen stable-heading-anchors 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 stable-heading-anchors er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'warning' betyder at et brud på stable-heading-anchors 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 stable-heading-anchors 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/stable-heading-anchors 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 stable-heading-anchors sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.
Relaterede regler
Tilbage til oversigten over alle 86 regler.