Norsk språkvask etter Språkrådets normer – for kodeagenter

Språkvask

Norsk tekst som ser ut som den er skrevet av en som kan norsk.

Språkvask er et sett med norske språkregler for kodeagenter. Det koder Språkrådets normer for rettskriving, tegnsetting og klarspråk, og legger til det normene ikke dekker: hva som avslører at en norsk tekst er tenkt på engelsk.

Installasjonen tilpasser reglene til agenten du bruker – blant annet Codex, Cursor, Claude Code, Copilot og Windsurf.

In English: Norwegian language rules for AI coding agents. Språkvask encodes the orthography, punctuation and plain-language norms published by Språkrådet (the Language Council of Norway), and catches the tells of Norwegian written by someone thinking in English. It supports multiple coding agents and works for both written standards, bokmål and nynorsk.

✗  Vennligst fyll ut ditt navn — vi sender deg en bekreftelse.
✓  Fyll ut navnet ditt – vi sender deg en bekreftelse.

Tre feil i én linje: vennligst er please i norsk drakt, ditt navn er engelsk ordstilling, og em-streken finnes ikke i norsk.

Installer

npx sprakvask

Den finner ut hvilke agenter prosjektet allerede bruker og skriver reglene dit de leter. Er det ingen å gå etter, lander de i AGENTS.md.

npx sprakvask --all       # alle støttede
npx sprakvask cursor      # bare én
npx sprakvask --global    # Claude Code, for alle prosjekter
npx sprakvask --list      # hva som støttes
npx sprakvask --remove    # angre

Start agenten på nytt etterpå.

Hvor den skriver

Det finnes ingen felles standard for dette. Innholdet er den samme prosaen uansett – bare stien og frontmatteren skiller. Claude Code får hele ferdigheten med referansefiler; de andre leser én fil, så de får sjekkene, med lenker til resten.

Filene flere deler på – AGENTS.md, copilot-instructions.md, .rules, CONVENTIONS.md – tilhører deg. Der skrives det inn et avmerket avsnitt som kan oppdateres og fjernes igjen uten at noe annet i fila røres.

Som plugin i Claude Code, hvis du heller vil ha den slik:

/plugin marketplace add sivert-io/sprakvask

Hva den gjør

Den slår inn når teksten er norsk – i grensesnitt, e-poster, dokumentasjon, commit-meldinger, vilkår. Den rører ikke kode: wantsFutureInvitations blir ikke ønskerFramtidigeInvitasjoner.

Tretten sjekker ligger i selve ferdigheten og dekker det meste. Detaljene ligger i references/ og lastes bare ved tvil:

De vanligste feilene

Kilder og forbehold

Normene er hentet fra Språkrådet – veiledningssidene om korrekt språk, klarspråkssidene og alle de 1 122 svarene i spørsmål-og-svar-basen – og formulert med egne ord og eksempler. Kapitlet om KI-preg bygger på Språkrådets test av ChatGPT, «KI-språkets fallgruver». Ideen til kapitlene om KI-preg og teksttyper kommer fra tekstforfatter-skillen i Altinn Studio-dokumentasjonen. Ordformer og bøyning slår du opp i Ordbøkene.

Dette er en sammenfatning laget av andre. Den er ikke utgitt av, tilknyttet eller godkjent av Språkrådet, og den erstatter ikke å slå opp når du er i tvil. Finner du en regel som er gjengitt feil, er en issue eller en pull request velkommen.

Lisens

MIT. Se LICENSE.