Legg til CLAUDE.md og _memories/-struktur
CLAUDE.md gir Claude Code prosjektkontekst når den jobber i repoet: kunde, team, gjennomføringsmodell, mappestruktur, konvensjoner og referanser til malverket. _memories/ er prosjekt-scoped memory som overlever sesjoner og deles via git mellom alle som jobber på prosjektet (skilles fra Claude's globale auto-memory som er Petter-spesifikk): - MEMORY.md som indeks - _template-memory.md som mal for nye memories - project_standard-online-kontekst.md som første memory med prosjektets utgangspunkt etablert fra salgsfasen Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
149
CLAUDE.md
Normal file
149
CLAUDE.md
Normal file
@@ -0,0 +1,149 @@
|
||||
# CLAUDE.md — Standard Online (oppdrag)
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working in this repository.
|
||||
|
||||
## Repository Purpose
|
||||
|
||||
Arbeidsmappe for kartleggings- og anbefalingsarbeidet Forte Digital gjør for **Standard Online**: masterdata, arkitektur og operasjonelt rammeverk for AI-agenter på tvers av SuperOffice, Business Central og nopCommerce. Repoet inneholder selve gjennomføringsdokumenter, leveranser, møtenotater, funn og handlingsplaner.
|
||||
|
||||
Strukturen følger Forte sitt `startklar-malverk` (Nivå 1 — avgrenset strategisk, 6-8 uker).
|
||||
|
||||
## Om kunden
|
||||
|
||||
- **Selskap:** Standard Online
|
||||
- **Søsterselskap:** Standard Digital (utviklingskapasitet i Riga)
|
||||
- **Beslutningskontakt:** Direktør produkt og kundeopplevelse
|
||||
- **Forte-ansvarlig:** Petter Schultz
|
||||
|
||||
Bedrifts- og brukerdata lever parallelt i flere av kundens systemer uten klare master-systemer eller etablerte dataeiere — det er det vi skal kartlegge og foreslå løsninger for.
|
||||
|
||||
## Systemlandskap
|
||||
|
||||
| System | Type | Eier |
|
||||
|---|---|---|
|
||||
| SuperOffice | CRM | Standard Online |
|
||||
| Business Central | ERP | Standard Online |
|
||||
| nopCommerce (egenutviklet) | E-handel | Standard Online |
|
||||
|
||||
## Forte-team
|
||||
|
||||
| Rolle | Navn | Allokering |
|
||||
|---|---|---|
|
||||
| Ledende konsulent | Ragnhild Aaraas Hånde | 80% |
|
||||
| Senior rådgiver | Petter Schultz | 20% |
|
||||
|
||||
Ragnhild driver det daglige arbeidet (kartlegging, workshops, dialog med Standard Digital, sammenstilling). Petter eier metodikk og maler fra Oras og DNK, kvalitetssikrer ved hver fasegrense.
|
||||
|
||||
## Gjennomføring — 4 faser
|
||||
|
||||
| Fase | Uker | Hovedaktivitet | Milestone |
|
||||
|---|---|---|---|
|
||||
| A — Oppstart | 1 | Kickoff, scope, datakilde-inventar | — |
|
||||
| B — Kartlegging | 2-3 | Intervjuer, workshops, datakvalitet | Delleveranse 1: Nåsituasjon + risiko (uke 3) |
|
||||
| C — Anbefalinger | 3-5 | Masterdata, arkitektur, AI, personvern | Delleveranse 2: Målbilde + masterdata (uke 5) |
|
||||
| D — Forankring | 6-7 | Presentasjon, overlevering | Sluttleveranse (uke 6-7) |
|
||||
|
||||
Detaljer i `../../Salg/_mal/startklar-malverk/02-gjennomforing.md`.
|
||||
|
||||
## Mappestruktur — 9 nummererte mapper
|
||||
|
||||
| Mappe | Formål |
|
||||
|---|---|
|
||||
| `1.oppdrag-og-kontekst/` | Scope, leveranser, interessenter, møtelogg |
|
||||
| `2.organisasjonsforstaelse/` | Roller, beslutningsveier, nøkkelpersoner |
|
||||
| `3.system-og-datalandskap/` | Systemer, integrasjoner, as-is |
|
||||
| `4.informasjonsarkitektur/` ⭐ | Begrepskatalog, masterdata, governance — kjerne |
|
||||
| `5.personvern-og-sikkerhet/` | GDPR, Privacy by Design |
|
||||
| `6.ai-rammeverk/` | Operasjonelle AI-prinsipper |
|
||||
| `7.standardisering-og-handlingsplan/` | Avvik, prioritering, tiltak |
|
||||
| `8.kontinuerlig-laering-og-referanser/` | Intervjuguider, åpne spørsmål, funn |
|
||||
| `9.leveranser-og-oppsummeringer/` | Executive Summary, sluttrapport |
|
||||
|
||||
Komplett innholdsfortegnelse: [_index.md](_index.md).
|
||||
|
||||
## Konvensjoner
|
||||
|
||||
Felles konvensjoner følger Forte sitt startklar-malverk: `../../Salg/_mal/startklar-malverk/00-konvensjoner.md`.
|
||||
|
||||
### Frontmatter
|
||||
|
||||
Alle leveranse-/analysedokumenter har YAML-frontmatter:
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: "Dokumenttittel — Standard Online"
|
||||
date: "YYYY-MM-DD"
|
||||
tags: [...]
|
||||
refs:
|
||||
- "relativ/sti/til/relatert.md"
|
||||
qa:
|
||||
status: "draft | final-candidate | needs-fix"
|
||||
reviewed_on: "YYYY-MM-DD"
|
||||
version: 1
|
||||
---
|
||||
```
|
||||
|
||||
### ID-system
|
||||
|
||||
Strukturerte ekstrakter får IDer som kan refereres på tvers av dokumenter:
|
||||
|
||||
- `DEC-YYYY-XXX` — beslutninger
|
||||
- `ACT-YYYY-XXX` — handlinger
|
||||
- `RISK-YYYY-XXX` — risikoer
|
||||
|
||||
### ANTAKELSE-markering
|
||||
|
||||
Når noe baseres på begrenset informasjon, marker det eksplisitt:
|
||||
|
||||
```
|
||||
ANTAKELSE: [tekst] conf: lav|moderat|høy
|
||||
```
|
||||
|
||||
### Andre
|
||||
|
||||
- **Datoformat:** ISO `YYYY-MM-DD`
|
||||
- **Filnavn:** bindestrek, ikke understrek. Æ/Ø/Å → ae/oe/aa
|
||||
- **Språk:** Norsk Bokmål
|
||||
|
||||
## Memories — prosjektkunnskap som overlever sesjoner
|
||||
|
||||
Prosjektspesifikke memories lagres i `_memories/`-mappen. Memories er strukturerte oppsummeringer av:
|
||||
|
||||
- **project**: prosjektkontekst, beslutninger, status, viktige funn
|
||||
- **feedback**: brukerens preferanser og rettelser spesifikt for dette prosjektet
|
||||
- **reference**: pekere til eksterne systemer og dokumenter (Confluence, Notion, etc.)
|
||||
|
||||
Forskjellen fra Claude's globale auto-memory (`~/.claude/projects/.../memory/`):
|
||||
|
||||
- **Global memory** = Petters generelle preferences på tvers av alle prosjekter
|
||||
- **Prosjekt-memory (her)** = ting som er spesifikt for Standard Online, og som bør deles med alle som jobber på prosjektet (Ragnhild, andre Forte-konsulenter, fremtidige Claude-sesjoner)
|
||||
|
||||
Når Claude oppdager noe verdt å huske som er prosjekt-spesifikt, skal det lagres her — ikke i global memory. Versjoneringen via git gjør at memories overlever maskinbytter og deles på tvers av teamet.
|
||||
|
||||
**Indeks:** [_memories/MEMORY.md](_memories/MEMORY.md) — oppdateres ved hver ny memory.
|
||||
**Mal:** [_memories/_template-memory.md](_memories/_template-memory.md).
|
||||
|
||||
## Sentrale referansecase (metodikk og maler)
|
||||
|
||||
Bygger på to ferske oppdrag:
|
||||
|
||||
- **Oras Group** (`../../Salg/Oras/`): Data Health Assessment for CRM-anskaffelse. Risikoregister-mønster, Executive Summary-struktur, integrasjonslandskap-tabell.
|
||||
- **Den norske kirke / Nstat** (`../../../Kirken/`): Informasjonsarkitektur for offentlig organisasjon. 9-mappe-struktur, Begrepseier/Dataforvalter/Master-vokabular, Privacy by Design, 3-nivå governance.
|
||||
|
||||
## Repository-konvensjoner
|
||||
|
||||
- Default branch: `main`
|
||||
- Direkte commits til main er tillatt (ingen branch protection — 2-personers prosjekt)
|
||||
- Issues sporer arbeid per fase (labels: `fase-A/B/C/D/milepel`)
|
||||
- Milestones: Delleveranse 1, Delleveranse 2, Sluttleveranse
|
||||
- Commits som inkluderer Claude-bidrag merkes med `Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>`
|
||||
|
||||
## Salgsmaterialet — kilden til oppdraget
|
||||
|
||||
`../../Salg/Standard/` inneholder:
|
||||
- Forslaget vi sendte (`Forslag - Masterdata, arkitektur og AI-klargjøring.md`)
|
||||
- Kundens oppdragsbeskrivelse (PDF)
|
||||
- Pitch-presentasjon (PPTX)
|
||||
- CV-er for teamet
|
||||
|
||||
Når du trenger å verifisere "hva vi lovet kunden" — slå opp der.
|
||||
11
_memories/MEMORY.md
Normal file
11
_memories/MEMORY.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# MEMORY — Standard Online
|
||||
|
||||
Prosjektspesifikke memories. Hver linje peker til en memory-fil i denne mappen.
|
||||
|
||||
Format: `- [Tittel](fil.md) — én-linjes hook`
|
||||
|
||||
Hold listen kort og scannbar. Bruk `[[fil-navn]]`-lenker innen memory-filer for kryssreferanser.
|
||||
|
||||
---
|
||||
|
||||
- [Standard Online — prosjektkontekst](project_standard-online-kontekst.md) — kunde, scope, team, sentrale aktører og bakgrunn fra salgsfasen
|
||||
39
_memories/_template-memory.md
Normal file
39
_memories/_template-memory.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
name: kort-kebab-case-slug
|
||||
description: én-linjes oppsummering som hjelper å vurdere relevans i fremtidige sesjoner — vær spesifikk
|
||||
metadata:
|
||||
type: project | feedback | reference
|
||||
---
|
||||
|
||||
# Tittel på memory-en
|
||||
|
||||
For **feedback** og **project** memories — strukturér slik:
|
||||
|
||||
**[Hovedregel eller fakta i én setning]**
|
||||
|
||||
**Hvorfor:** [Grunnen — typisk en hendelse, en preferanse, en kunde-beslutning. Lar fremtidige Claude-sesjoner vurdere edge cases istedenfor å følge regelen blindt.]
|
||||
|
||||
**Hvordan brukes:** [Når og hvor regelen/faktumet kicker inn. Konkret: "ved planlegging av X", "i samtaler om Y", "før beslutninger om Z".]
|
||||
|
||||
---
|
||||
|
||||
For **reference** memories — strukturér slik:
|
||||
|
||||
**Hva:** [Hvilken ekstern ressurs det er — Notion-side, Confluence-rom, dashboard, etc.]
|
||||
|
||||
**Hvor:** [URL eller plassering]
|
||||
|
||||
**Når brukes:** [Hva slags spørsmål eller arbeid sender deg dit]
|
||||
|
||||
---
|
||||
|
||||
## Lenker til relaterte memories
|
||||
|
||||
Bruk wikilink-stil: `[[andre-memory-navn]]`. Det er greit å lenke til memories som ikke finnes ennå — markerer at de er verdt å skrive.
|
||||
|
||||
## Sjekkliste når du oppretter en ny memory
|
||||
|
||||
- [ ] Frontmatter-felter fylt ut (`name`, `description`, `metadata.type`)
|
||||
- [ ] Lagt til linje i `MEMORY.md` (alfabetisk eller tematisk gruppert)
|
||||
- [ ] Filnavn følger mønster `<type>_<slug>.md` (f.eks. `project_kickoff-funn.md`)
|
||||
- [ ] ANTAKELSE-er markert eksplisitt med confidence-nivå hvis innholdet er hypotetisk
|
||||
92
_memories/project_standard-online-kontekst.md
Normal file
92
_memories/project_standard-online-kontekst.md
Normal file
@@ -0,0 +1,92 @@
|
||||
---
|
||||
name: standard-online-kontekst
|
||||
description: Kunde, scope, team og sentrale aktører for Standard Online-oppdraget — etablert fra salgsfasen før oppdragsstart
|
||||
metadata:
|
||||
type: project
|
||||
---
|
||||
|
||||
# Standard Online — prosjektkontekst
|
||||
|
||||
Etablert fra salgsfasen (mai 2026). Oppdater ved oppstart med faktiske datoer, navn og bekreftet scope.
|
||||
|
||||
## Kunde og søsterselskap
|
||||
|
||||
**Standard Online** er en norsk e-handels-/SaaS-aktør. Bedrifts- og brukerdata lever parallelt i tre systemer uten tydelige master-systemer eller etablerte dataeiere. Samtidig ser kunden konturene av en utvikling der AI-agenter skal konsumere, berike og handle på disse dataene — masterdata-grunnlaget må derfor være AI-ready fra start, ikke etterarbeid.
|
||||
|
||||
**Standard Digital** er søsterselskap i Riga, med utviklingskapasitet. De er **både bidragsyter og mottaker** av kartleggingen — sentral kontakt for å forstå dagens arkitektur og praksis.
|
||||
|
||||
## Beslutningsstruktur
|
||||
|
||||
**Beslutningskontakt:** Direktør produkt og kundeopplevelse hos Standard Online (navn ikke i frontmatter — bekreft og oppdater ved kickoff).
|
||||
|
||||
**Hvorfor det betyr noe:** Beslutninger om systemvalg og arkitektur ligger hos kunden, eventuelt i samråd med ERP-/CRM-leverandører. Vi leverer beslutningsgrunnlag, ikke implementering. Direktøren er styringspunkt — rask responstid på avklaringer forutsettes.
|
||||
|
||||
## Systemlandskap
|
||||
|
||||
- **SuperOffice** (CRM)
|
||||
- **Business Central** (ERP)
|
||||
- **nopCommerce** (egenutviklet nettbutikk)
|
||||
|
||||
ANTAKELSE: Bedrifts- og brukerdata er duplisert mellom CRM og ERP. conf: høy (eksplisitt i kundens oppdragsbeskrivelse)
|
||||
|
||||
ANTAKELSE: nopCommerce har egen brukermaster for nettbutikk-konti, separat fra SuperOffice-kontakter. conf: moderat (typisk e-handelsmønster, men ikke verifisert hos kunden)
|
||||
|
||||
## Scope og avgrensninger
|
||||
|
||||
**Innenfor:** kartlegging og anbefaling. 7 leveranser:
|
||||
1. Nåsituasjon med gap og risiko
|
||||
2. Arkitekturskisser (as-is + to-be)
|
||||
3. Masterdata-modell med System-of-Record
|
||||
4. Operasjonelt AI-rammeverk
|
||||
5. GDPR/personvern
|
||||
6. Handlingsplan
|
||||
7. Governance-modell
|
||||
|
||||
**Utenfor:** implementering, leverandørvalg, detaljert teknisk design. Eventuell implementeringsfase prises som egen leveranse.
|
||||
|
||||
## Team
|
||||
|
||||
| Rolle | Navn | Allokering | Eier |
|
||||
|---|---|---|---|
|
||||
| Ledende konsulent | Ragnhild Aaraas Hånde | 80% | Daglig arbeid, workshops, dialog Standard Digital, sammenstilling |
|
||||
| Senior rådgiver | Petter Schultz | 20% | Metodikk-eier, masterdata + arkitektur, KS ved fasegrenser |
|
||||
|
||||
**Hvorfor 80/20:** Lavere totalpris enn én senior på 100%, redundans, kombinerer teknisk dybde + senior rådgivning. Bekreftet modell i pitch (PPTX slide 14).
|
||||
|
||||
## Kommersiell modell
|
||||
|
||||
- 6-8 ukers løp (effektivt)
|
||||
- Time & materials, fakturert løpende
|
||||
- Blandet timepris ca. 1 480 NOK/time (Ragnhild 1 400, Petter 1 800 — endelig satt før utsending)
|
||||
- 30 dager netto, reise og utlegg separat
|
||||
|
||||
## Hvorfor dette oppdraget er litt annerledes enn Oras og DNK
|
||||
|
||||
| Aspekt | Standard | Oras | DNK |
|
||||
|---|---|---|---|
|
||||
| Dybde | Nivå 1 (avgrenset strategisk) | Nivå 1 men dyp teknisk | Nivå 2 (pågående 6+ mnd) |
|
||||
| Hovedfokus | Masterdata + arkitektur + **AI-rammeverk** | CRM-konsolidering | Informasjonsarkitektur |
|
||||
| AI-spor | **Eksplisitt leveranse** (ny dimensjon) | Ikke i scope | Ikke i scope |
|
||||
| Antall systemer | 3 | 2 CRM + ERP + flere | 10+ fagsystemer |
|
||||
|
||||
Konsekvens: Vi skal IKKE replikere Oras' entity-by-entity-dybde. Vi stopper på domene-nivå. AI-rammeverket er det nye sporet (mappe 6) — operasjonelle prinsipper, ikke arkitektur-spec.
|
||||
|
||||
## Referansecase som danner grunnlag
|
||||
|
||||
- **Oras** (Salg/Oras/): risikoregister-mønster, Executive Summary, integrasjonslandskap
|
||||
- **Den norske kirke / Nstat** (Kirken/): 9-mappe-struktur, masterdata-vokabular (Begrepseier/Dataforvalter/Master), Privacy by Design, governance på 3 nivåer
|
||||
|
||||
## Salgsmaterialet som etablerer kontekst
|
||||
|
||||
- `../../Salg/Standard/Forslag - Masterdata, arkitektur og AI-klargjøring.md` — fullstendig forslag
|
||||
- `../../Salg/Standard/Oppdragsbeskrivelse masterdataprosjekt.pdf` — kundens RFP
|
||||
- `../../Salg/Standard/Standard_Digital2.pptx` — pitch-presentasjonen
|
||||
|
||||
## Sjekkpunkter ved oppstart
|
||||
|
||||
- [ ] Bekreft direktør-navn og stedfortreder
|
||||
- [ ] Bekreft kontaktperson(er) hos Standard Digital
|
||||
- [ ] Avtal kommunikasjonsstruktur (Slack? Teams? E-post?)
|
||||
- [ ] Identifiser 8-12 personer til intervjurunde
|
||||
- [ ] Få tilgang til eksisterende underlag (arkitekturskisser, dataflyt)
|
||||
- [ ] Bekreft endelig timepris og total ramme
|
||||
Reference in New Issue
Block a user