Utviklingsfilosofi i CLAUDE.md — leses av alle sesjoner

Seks prinsipper inline i CLAUDE.md: forstå hvorfor, ikke hardkod
det dynamiske, én fiks ikke workarounds, preferer fjerning,
én mekanisme per problem, gjør det riktig én gang.
Utdypning i docs/retninger/kvalitetsprinsipper.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
vegard 2026-03-20 02:38:36 +00:00
parent 8681c55bc8
commit bbbaa1e4ca

View file

@ -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.