diff --git a/CLAUDE.md b/CLAUDE.md
index 4538c07..a2e0551 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -44,6 +44,7 @@ CLAUDE.md er eneste startdokument. Oppgavelister i roten, docs under `docs/`:
   - `datalaget.md` — PG(+AGE) som graf og arkiv, PG LISTEN/NOTIFY + WebSocket som sanntidslag
   - `arbeidsflaten.md` — Spatial canvas med verktøy-paneler, drag-and-drop, kompatibilitetsmatrise
   - `unix_filosofi.md` — Maskinrommet som orkestrator, arbeid i CLI-verktøy, Claude og maskinrommet deler verktøykasse
+  - `kvalitetsprinsipper.md` — Gjør det riktig, én gang. Ikke hardkod, forstå hvorfor, én fiks ikke workarounds
 - `docs/primitiver/` — Spesifikasjoner for kjerneprimitivene:
   - `nodes.md` — Node-skjema, node_kind, visibility, CAS-noder, eierskap
   - `edges.md` — Edge-skjema, typer, metadata, systemedges
@@ -211,3 +212,23 @@ Tjenester: PG+AGE, CAS, Whisper, LiteLLM, LiveKit ...
    - **Dra verktøy inn i kontekst → transformer.** Et verktøy (AI, editor,
      studio) som mottar en node anvender sin funksjon på originalen.
    Ref: `docs/retninger/arbeidsflaten.md`, `docs/features/universell_overfoering.md`.
+
+## Utviklingsfilosofi
+Disse prinsippene styrer *hvordan* vi bygger, ikke *hva*.
+Ref: `docs/retninger/kvalitetsprinsipper.md` for utdypning.
+
+1. **Forstå hvorfor, ikke bare hva.** Ikke sett en konfigverdi fordi
+   det "fikser" problemet. Forstå mekanismen. Ellers vet du ikke hva
+   som knekker når konteksten endres.
+2. **Ikke hardkod det dynamiske.** Hvis en verdi kan leses fra request,
+   miljø eller database — ikke lås den i en konfigurasjonsfil. Spør:
+   "Hva går i stykker om vi legger til et subdomain i morgen?"
+3. **Én fiks, ikke to workarounds.** Finn rotårsaken. To workarounds
+   som kompenserer for hverandre er verre enn én ufikset bug.
+4. **Preferer fjerning over tillegg.** Kan du løse problemet ved å
+   fjerne kode/konfig? Gjør det. Mindre = færre feil = enklere.
+5. **Én mekanisme per problem.** Ikke to overlappende løsninger.
+   Det skaper forvirring om hvilken som gjør jobben.
+6. **Bedre med én ting som fungerer perfekt enn ti som fungerer
+   halvveis.** Gaffatape-løsninger skaper teknisk gjeld som vokser
+   eksponentielt. Gjør det riktig, én gang.