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