CLAUDE.md för ett repo med texter, inte kod
Projektinstruktion för marknadsteam, kommunikatörer och dokumentationsskribenter som jobbar i ett repo med markdown. Tonläge, termer, format och publiceringsregler.
- Typ
- Instruktionsfil
- Område
- Skrivande
- Verktyg
- Claude Code, Codex, Cursor
- Uppdaterad
- 8 september 2026
CLAUDE.md
# Innehållsrepo: webb och hjälpcenter
Här ligger alla texter för webbplatsen (`site/`) och hjälpcentret
(`help/`). Texterna är markdown med frontmatter. Sajten byggs vid push
till main.
## Röst
Vi skriver som en kunnig kollega som förklarar utan att förenkla. Konkret
före abstrakt, exempel före regel, kort före långt.
- Du-tilltal till läsaren. Vi om oss.
- Sentence case i rubriker: "Så kopplar du ditt bankkonto", inte
"Så Kopplar Du Ditt Bankkonto".
- Inga utropstecken. Inga superlativ om oss själva.
- Skriv ut siffror upp till tolv, siffror därefter. Procent skrivs
"procent" i löptext.
- Datum som 8 september 2026. Klockslag som 14.30.
## Termer
Använd exakt dessa ord, alltid:
- "konto", inte "användare" eller "profil"
- "abonnemang", inte "prenumeration" eller "plan"
- "logga in", inte "signa in"
- Produktnamnet skrivs "Kassan" med stort K, aldrig "kassan-appen"
Fullständig lista i `STYLE.md`. Läs den innan du skriver.
## Filformat
Varje fil börjar med frontmatter:
---
title: Rubrik i sentence case
description: En mening som passar i sökresultat, max 155 tecken
updated: 2026-09-08
---
Rubriker börjar på nivå två. Bilder ligger i `assets/` med beskrivande
filnamn och alt-text.
## Arbetssätt
- Ändra en text i taget om inte uppgiften är en genomgående termändring.
- Vid termändringar: sök igenom hela repot och rapportera antal träffar
innan du ändrar.
- Hitta inte på produktfakta, priser eller datum. Om du inte hittar
uppgiften i repot, skriv "[FAKTA SAKNAS: ...]" och säg det i din
sammanfattning.
- Skriv inte om texter du inte blivit ombedd att röra, även om de bryter
mot reglerna. Lista dem i stället.
## Publicering
Allt under `site/` som mergas till main publiceras direkt. Öppna alltid en
pull request och skriv i beskrivningen vilka sidor som ändras och varför.
När den gör nytta
- Marknadsavdelningen har flyttat webbtexterna till git och kör agenter.
- En dokumentationssajt där många skriver och ingen redigerar.
- Ett nyhetsbrev, en kunskapsbas eller en handbok som ska låta som en röst.
Så installerar du
- Claude Code
- Spara som CLAUDE.md i projektets rot. Om du redan har en AGENTS.md räcker en CLAUDE.md med raden @AGENTS.md.
- Codex, Cursor, Copilot
- Spara som AGENTS.md i projektets rot. Filen läses automatiskt när agenten startar i mappen.
Om instruktionsfiler
CLAUDE.md eller AGENTS.md i projektets rot. Talar om hur just det här projektet fungerar innan agenten rör en fil.
Närliggande
SKILL.mdSkill systemprompt-skrivcoach.mdSystemprompt AGENTS.mdInstruktionsfil
Klarspråk: skriv om text så att den går att förstå
Skriver om svensk text enligt klarspråksprinciperna som svenska myndigheter följer. Kortare meningar, aktiv form, läsaren först.
Skrivcoach som inte skriver åt dig
En assistent som förbättrar din text genom frågor och konkret återkoppling, i stället för att ersätta den med sin egen. För den som vill bli bättre, inte bara bli klar.
AGENTS.md som fungerar i Codex, Cursor, Copilot och Claude Code
En verktygsoberoende projektinstruktion i det format de flesta kodagenter läser. Kort nog att faktiskt läsas, konkret nog att göra skillnad.