# agent/markdown-mirrors Every page has a markdown twin, declared via a link alternate. Reglen agent/markdown-mirrors kører i site-scope med severity 'error' og indgår i agent-parathed-domænet sammen med 7 andre kontrakter i frameworket. ## Hvorfor markdown-mirrors findes Agents prefer fetching clean markdown over parsing HTML — per-page .md mirrors are the emerging convention (Stripe and Vercel docs ship them). Each page must declare and the target file must exist. Generate both page and mirror from the same content source. ## Sådan håndhæves markdown-mirrors Reglen markdown-mirrors evalueres på hele sitets fakta-indeks på én gang, fordi kravet kun giver mening på tværs af sider — den enkelte side kan se perfekt ud, mens mønsteret er problemet. Fejler en side, får agenten en finding, hvor fix-instruktionen for markdown-mirrors er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på markdown-mirrors 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 agent/markdown-mirrors 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 markdown-mirrors sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten. ## Relaterede regler - [agent/token-efficiency](https://pseo.mikkelkrogsholm.dk/regler/agent/token-efficiency/) - [agent/answer-first](https://pseo.mikkelkrogsholm.dk/regler/agent/answer-first/) - [agent/stable-heading-anchors](https://pseo.mikkelkrogsholm.dk/regler/agent/stable-heading-anchors/)