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:
parent
8681c55bc8
commit
bbbaa1e4ca
1 changed files with 21 additions and 0 deletions
21
CLAUDE.md
21
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
|
- `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
|
- `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
|
- `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:
|
- `docs/primitiver/` — Spesifikasjoner for kjerneprimitivene:
|
||||||
- `nodes.md` — Node-skjema, node_kind, visibility, CAS-noder, eierskap
|
- `nodes.md` — Node-skjema, node_kind, visibility, CAS-noder, eierskap
|
||||||
- `edges.md` — Edge-skjema, typer, metadata, systemedges
|
- `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,
|
- **Dra verktøy inn i kontekst → transformer.** Et verktøy (AI, editor,
|
||||||
studio) som mottar en node anvender sin funksjon på originalen.
|
studio) som mottar en node anvender sin funksjon på originalen.
|
||||||
Ref: `docs/retninger/arbeidsflaten.md`, `docs/features/universell_overfoering.md`.
|
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.
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue