# seo/heading-hierarchy

Headings start at h1 and never skip levels. Reglen seo/heading-hierarchy kører i page-scope med severity 'error' og indgår i teknisk seo-domænet sammen med 23 andre kontrakter i frameworket.

## Hvorfor heading-hierarchy findes

A clean heading outline (h1 → h2 → h3, no skips) is how both search engines and AI agents extract document structure. Skipped levels break the outline and harm accessibility (screen reader navigation).

## Sådan håndhæves heading-hierarchy

Reglen heading-hierarchy 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 heading-hierarchy er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på heading-hierarchy fejler hele verifikationen med exit-kode 1, så hverken CI eller en agent kan skibe sitet før fundet er rettet.

## Test og fixtures

Som alle kontrakter i frameworket har seo/heading-hierarchy 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 heading-hierarchy sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.

## Relaterede regler

- [seo/structured-data](https://pseo.mikkelkrogsholm.dk/regler/seo/structured-data/)
- [seo/og-tags](https://pseo.mikkelkrogsholm.dk/regler/seo/og-tags/)
- [seo/lang-attribute](https://pseo.mikkelkrogsholm.dk/regler/seo/lang-attribute/)