Kjell Tore Guttormsen
5a0e8d774a
Manifest-drevet applier (scripts/kb-update/backfill-status.mjs) over den testede insertMetaField-primitiven + ny ren regel statusForFile (filnavn-token → Reference/ Established Practice, operatør-godkjent vokabular). 7 Reference + 7 Established Practice. Hard per-fil-invariant (én linje, body byte-identisk), idempotent, isMain-guard. 7 tester. Premiss-korreksjon (auditHeaders, ground-truth 2026-07-06): ekte not-due-restanse er 21 Status + 26 Last-updated (STATE sa 21/22). «0 har norsk dato» var falskt — 21/26 Last-updated-gap bærer allerede Sist oppdatert/Dato → relabel-residual; 5 datoløse gir «i dag» ved naiv git → utsatt. 4 dual-header ai-act-*-filer med plain-text «Status: GA» fanget i diff-inspeksjon → revertert (unngår duplikat/motsigelse) → residual (samme plain-blokk ga R20 duplikat Category). Korrigert residual logget i roadmap §R21. Verifisering: test-backfill-status 7/7; git diff +14/-0 (kun Status-linjer, body byte-identisk); not-due Status-missing 21→3; full suite 771/771 exit 0.
256 lines
12 KiB
Markdown
256 lines
12 KiB
Markdown
# Kildesporing og antakelsesregister
|
||
|
||
**Sist oppdatert:** 2026-02 (v1.0)
|
||
**Målgruppe:** Arkitekter som utarbeider AI-arkitekturvurderinger og utredninger
|
||
**Formål:** Sikre sporbarhet, transparens og etterprøvbarhet i arkitekturvurderinger
|
||
**Category:** Solution Architecture & Advisory
|
||
**Status:** Reference
|
||
|
||
---
|
||
|
||
## Om dette dokumentet
|
||
|
||
Enhver arkitekturvurdering bygger på en blanding av verifiserte fakta, kunnskapsbase-informasjon, eksperterfaring og antakelser. Denne referansefilen gir rammeverk for å klassifisere, dokumentere og validere kildene — slik at beslutningstakere vet hva de kan stole på og hva som må verifiseres.
|
||
|
||
---
|
||
|
||
## 1. Kildeklassifisering
|
||
|
||
### 1.1 Klassifiseringsnivåer
|
||
|
||
| Klasse | Betegnelse | Tillitsnivå | Definisjon | Eksempler | Holdbarhet |
|
||
|--------|-----------|-------------|------------|-----------|------------|
|
||
| **V** | **Verifisert** | Høyest | Bekreftet via MCP-verktøy (microsoft-learn, tavily) eller offisiell dokumentasjon i nåværende sesjon | MCP-søk i microsoft-learn som bekrefter GA-status for Azure OpenAI i Norway East; prisdata fra azure.microsoft.com/pricing | 1-6 måneder (avhenger av tjenestens modenhet) |
|
||
| **KB** | **Kunnskapsbase** | Høy | Fra plugin-kunnskapsbasen (references/). Kvalitetssikret ved opprettelse, men kan være foreldet. | Informasjon fra `platforms/copilot-studio.md`, `cost-models.md`, `security.md` | Sjekk "Sist oppdatert"-dato. Stale etter 6+ måneder. |
|
||
| **E** | **Ekspert** | Middels | Basert på arkitektens erfaring og fagkunnskap. Ikke verifisert mot offisiell kilde i denne sesjonen. | Arkitektens vurdering av integrasjonskompleksitet; erfaringsbaserte tidsestimater; beste-praksis-anbefalinger | Varierer. Mest robust for etablerte mønstre, minst for nye tjenester. |
|
||
| **A** | **Antakelse** | Lavest | Uverifisert antakelse. Kan være rimelig, men er ikke bekreftet. Må valideres. | "Vi antar at virksomheten har M365 E5-lisenser"; "Vi antar at Azure AI Search støtter semantic ranker i Norway East" | Må valideres før den brukes i beslutning. |
|
||
|
||
### 1.2 Visuelle markører
|
||
|
||
For bruk i utredningsdokumenter:
|
||
|
||
```markdown
|
||
Denne tjenesten er tilgjengelig i Norway East [V: microsoft-learn MCP, 2026-02-13]
|
||
Copilot Studio støtter custom topics med GPT-4o [KB: platforms/copilot-studio.md, 2026-01]
|
||
Integrasjonen med fagsystemet tar typisk 4-6 uker [E: erfaringsbasert]
|
||
Virksomheten har tilgjengelig Azure-abonnement [A: ikke verifisert — må avklares]
|
||
```
|
||
|
||
### 1.3 Regler for kildeklassifisering
|
||
|
||
1. **Alltid bruk høyest tilgjengelig klasse.** Hvis du kan verifisere via MCP, gjør det — ikke nøy deg med KB.
|
||
2. **Nedgrader ved usikkerhet.** Hvis KB-informasjon er eldre enn 6 måneder, vurder å verifisere via MCP eller nedgrader til E.
|
||
3. **Vær ærlig om antakelser.** Det er bedre å merke noe som A enn å presentere det som V.
|
||
4. **Verifiser kritiske antakelser.** Antakelser som påvirker anbefalingen må valideres — enten i sesjonen eller som oppfølgingspunkt.
|
||
|
||
---
|
||
|
||
## 2. Antakelsesregister — mal
|
||
|
||
### 2.1 Registertabell
|
||
|
||
```markdown
|
||
### Antakelsesregister
|
||
|
||
**Prosjekt:** [Prosjektnavn]
|
||
**Sist oppdatert:** YYYY-MM-DD
|
||
|
||
| ID | Antakelse | Kilde | Klasse | Konsekvens hvis feil | Sannsynlighet for feil | Valideringsplan | Status | Validert dato |
|
||
|----|-----------|-------|--------|---------------------|----------------------|-----------------|--------|---------------|
|
||
| A01 | Virksomheten har M365 E5-lisenser | Oppdragsbeskrivelse | A | Copilot-løsningen krever E5, uten den trengs separat lisensanskaffelse (+3 mnd, +X NOK) | Lav | Bekreft med IT-avdeling | ⬜ Åpen | — |
|
||
| A02 | Azure OpenAI GPT-4o er GA i Norway East | KB: platforms/azure-ai-foundry.md | KB | Må bruke Sweden Central → dataresidenskonsekvens, mulig DPIA-påvirkning | Lav | Verifiser via MCP: microsoft-learn | ✅ Validert | 2026-02-13 |
|
||
| A03 | SharePoint-innhold er strukturert og klassifisert | Ikke verifisert | A | RAG-kvalitet blir lav → POC-tid øker med 4-6 uker for datakuratering | Middels | Be om tilgang til SharePoint, gjennomfør stikkprøve | ⬜ Åpen | — |
|
||
| A04 | Integrasjon med fagsystem [X] er mulig via REST API | Muntlig fra prosjektleder | E | Uten API kreves custom connector-utvikling (+8 uker, +Y NOK) | Middels | Be om API-dokumentasjon, gjennomfør teknisk spike | ⬜ Åpen | — |
|
||
| A05 | AI Act risikoklasse er "begrenset" (ikke "høy") | Arkitektens vurdering | E | Høyrisikoklassifisering utløser conformity assessment (+3-6 mnd, +Z NOK) | Lav-Middels | Gjennomgå med juridisk rådgiver | 🔄 Under arbeid | — |
|
||
```
|
||
|
||
### 2.2 Status-verdier
|
||
|
||
| Status | Betydning | Neste steg |
|
||
|--------|-----------|------------|
|
||
| ⬜ **Åpen** | Ikke påbegynt validering | Prioriter basert på konsekvens |
|
||
| 🔄 **Under arbeid** | Validering pågår | Vent på resultat |
|
||
| ✅ **Validert** | Bekreftet korrekt | Oppgrader kildeklasse (A→V eller A→E) |
|
||
| ❌ **Avkreftet** | Antakelsen var feil | Revurder arkitekturbeslutning |
|
||
| ⏳ **Utløpt** | Valideringen er foreldet | Re-valider |
|
||
|
||
---
|
||
|
||
## 3. Konsekvensanalyse per antakelse
|
||
|
||
### 3.1 Konsekvens-kategorier
|
||
|
||
Når du dokumenterer "Konsekvens hvis feil" i antakelsesregisteret, bruk disse kategoriene:
|
||
|
||
| Kategori | Beskrivelse | Eksempel |
|
||
|----------|-------------|---------|
|
||
| **Tidskonsekvens** | Forsinkelse i prosjektplan | "+4 uker for å anskaffe manglende lisenser" |
|
||
| **Kostnadskonsekvens** | Uforutsett kostnad | "+200 000 NOK for alternativ komponent" |
|
||
| **Arkitekturkonsekvens** | Endring i valgt løsning | "Må bytte fra Norway East til Sweden Central → DPIA-oppdatering" |
|
||
| **Regulatorisk konsekvens** | Compliance-implikasjon | "Høyrisiko iht. AI Act → conformity assessment nødvendig" |
|
||
| **Organisatorisk konsekvens** | Krav til organisasjonen | "Trenger ekstern data engineer → anskaffelsesprosess" |
|
||
| **Prosjektkonsekvens** | Påvirkning på prosjektet som helhet | "Prosjektet bør stoppes/omfangsreduseres" |
|
||
|
||
### 3.2 Konsekvensmatrise
|
||
|
||
Prioriter validering basert på konsekvens × sannsynlighet:
|
||
|
||
| Prioritet | Når | Handling |
|
||
|-----------|-----|---------|
|
||
| **P1 — Kritisk** | Høy konsekvens + middels/høy sannsynlighet | Valider **før** beslutning. Blokkerer anbefaling. |
|
||
| **P2 — Viktig** | Middels konsekvens + middels sannsynlighet, ELLER høy konsekvens + lav sannsynlighet | Valider i **POC-fase**. Dokumenter som risiko. |
|
||
| **P3 — Ønskelig** | Lav konsekvens ELLER lav sannsynlighet | Valider **underveis**. Dokumenter, men blokker ikke. |
|
||
|
||
---
|
||
|
||
## 4. Valideringsarbeidsflyt
|
||
|
||
### 4.1 Valideringsprosess
|
||
|
||
```
|
||
1. Identifiser antakelse under utredningsarbeid
|
||
↓
|
||
2. Registrer i antakelsesregisteret med kildeklasse og konsekvens
|
||
↓
|
||
3. Vurder prioritet (P1/P2/P3)
|
||
↓
|
||
4. For P1: Forsøk å validere umiddelbart
|
||
│
|
||
├─ MCP-verifiserbar? → Bruk microsoft-learn, tavily, eller azure-mcp
|
||
├─ Krever tilgang/info fra virksomhet? → Dokumenter som oppfølgingspunkt
|
||
└─ Krever ekstern ekspertise? → Registrer som avhengighet
|
||
↓
|
||
5. Oppdater status og kildeklasse
|
||
↓
|
||
6. Hvis avkreftet: Revurder berørte beslutninger
|
||
```
|
||
|
||
### 4.2 MCP-verifiseringsprotokoll
|
||
|
||
For antakelser som kan verifiseres med MCP-verktøy i sesjonen:
|
||
|
||
| Verktøytype | MCP-verktøy | Egnet for |
|
||
|-------------|-------------|-----------|
|
||
| **Microsoft-dokumentasjon** | `microsoft_docs_search`, `microsoft_docs_fetch` | GA-status, regional tilgjengelighet, prismodeller, konfigurasjon |
|
||
| **Kodeeksempler** | `microsoft_code_sample_search` | API-tilgjengelighet, SDK-støtte |
|
||
| **Generelt web** | `tavily_search`, `tavily_extract` | Nyheter, annonserte endringer, community-erfaringer |
|
||
| **Azure-infrastruktur** | `azure-mcp-server` (hvis tilgjengelig) | Faktisk konfigurasjon, RBAC, ressursstatus |
|
||
|
||
### 4.3 Valideringsmal per antakelse
|
||
|
||
```markdown
|
||
### Validering av A01: [Antakelse]
|
||
|
||
**Antakelse:** [Beskrivelse]
|
||
**Kilde:** [Original kilde]
|
||
**Prioritet:** P1/P2/P3
|
||
|
||
**Valideringsmetode:** [MCP/Dokumentgjennomgang/Intervju/Teknisk spike]
|
||
|
||
**Valideringsresultat:**
|
||
- [ ] Bekreftet korrekt → Oppgrader til klasse [V/KB/E]
|
||
- [ ] Delvis korrekt → Oppdater antakelse: [ny formulering]
|
||
- [ ] Avkreftet → Konsekvens: [beskrivelse], Tiltak: [handling]
|
||
|
||
**Ny kildeklasse:** [V/KB/E]
|
||
**Validert av:** [Navn/rolle]
|
||
**Dato:** YYYY-MM-DD
|
||
**Notater:** [Evt. tilleggsinfo]
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Integrasjon med utredningsdokumentet
|
||
|
||
### 5.1 Kildesporing i tekst
|
||
|
||
I utredningsdokumentet, bruk inline-kildemarkører:
|
||
|
||
```markdown
|
||
Azure OpenAI tilbyr GPT-4o i Norway East [V: MCP microsoft-learn 2026-02-13].
|
||
Copilot Studio kan integreres med Azure AI Search for RAG [KB: platforms/copilot-studio.md].
|
||
Vi estimerer at integrasjon med fagsystemet tar 4-6 uker [E: erfaringsbasert].
|
||
Vi antar at virksomheten har tilstrekkelig Azure-budsjett [A01: Må valideres med IT-avdeling].
|
||
```
|
||
|
||
### 5.2 Antakelsessammendrag i utredningen
|
||
|
||
Inkluder dette i utredningens sammendrag (S1):
|
||
|
||
```markdown
|
||
### Antakelser og konfidens
|
||
|
||
| Antall | Kategori | Konsekvens |
|
||
|--------|----------|------------|
|
||
| [X] | Verifisert (V) | Høy tillit — dokumentert i sesjonen |
|
||
| [X] | Kunnskapsbase (KB) | Høy tillit — sjekk "sist oppdatert" |
|
||
| [X] | Ekspert (E) | Middels tillit — basert på erfaring |
|
||
| [X] | Antakelse (A) | Lav tillit — må valideres |
|
||
|
||
**P1-antakelser (kritiske, blokkerende):**
|
||
- A01: [Beskrivelse] — Valideringsplan: [Plan]
|
||
- A05: [Beskrivelse] — Valideringsplan: [Plan]
|
||
|
||
**Overordnet konfidensgrad:** 🟢 Høy / 🟡 Medium / 🔴 Lav
|
||
```
|
||
|
||
### 5.3 Antakelsesregister som vedlegg
|
||
|
||
Fullt antakelsesregister (seksjon 2.1) bør inkluderes som vedlegg i utredningsdokumentet, referert fra S10 (Vedlegg).
|
||
|
||
---
|
||
|
||
## 6. Livssyklus for antakelser
|
||
|
||
### 6.1 Antakelsens livssyklus
|
||
|
||
```
|
||
Identifisert (A) → Prioritert (P1/P2/P3) → Validering pågår (🔄) → Validert (✅) / Avkreftet (❌)
|
||
↓ (med tid)
|
||
Utløpt (⏳) → Re-validering
|
||
```
|
||
|
||
### 6.2 Re-valideringsregler
|
||
|
||
| Kildeklasse | Re-valider etter | Trigger |
|
||
|-------------|-----------------|---------|
|
||
| V (Verifisert) | 3-6 måneder | Ny major release, prisendring, regional utvidelse |
|
||
| KB (Kunnskapsbase) | 6 måneder | KB-staleness-sjekk (`scripts/kb-staleness-check.sh`) |
|
||
| E (Ekspert) | Ved ny informasjon | Ny erfaring, tilbakemelding fra prosjekt |
|
||
| A (Antakelse) | Umiddelbart — bør valideres snarest | Alltid |
|
||
|
||
---
|
||
|
||
## For Cosmo Skyberg
|
||
|
||
Denne referansefilen er ditt verktøy for å sikre transparens og etterprøvbarhet i arkitekturvurderinger. Slik bruker du den:
|
||
|
||
### Under arkitekturvurderinger:
|
||
|
||
1. **Klassifiser alltid kilder** med [V], [KB], [E], eller [A] inline i teksten. Dette tar sekunder og gir enorm verdi for beslutningstaker.
|
||
2. **Opprett antakelsesregister** for hvert prosjekt. Start med de mest kritiske antakelsene.
|
||
3. **Verifiser P1-antakelser i sesjonen** ved hjelp av MCP-verktøy (microsoft-learn, tavily).
|
||
4. **Presenter konfidensoversikt** i sammendragseksjonen.
|
||
|
||
### Når du bruker MCP-verktøy for verifisering:
|
||
|
||
- **microsoft_docs_search** → Oppgrader til klasse V med dato og søkeord
|
||
- **tavily_search** → Oppgrader til klasse V, men noter at web-kilder er mindre stabile enn offisiell docs
|
||
- **Kunnskapsbasen** → Bruk klasse KB, men sjekk "Sist oppdatert"-dato i filen
|
||
|
||
### Vanlige antakelser å registrere:
|
||
|
||
1. Lisenssituasjon (M365 E3/E5, Copilot Studio, Azure-abonnement)
|
||
2. Regional tilgjengelighet (Norway East vs. Sweden Central)
|
||
3. Datakvalitet og tilgjengelighet (SharePoint, fagsystemer)
|
||
4. Kompetansenivå i organisasjonen
|
||
5. Budsjettramme og tidsfrist
|
||
6. Regulatorisk klassifisering (AI Act risikoklasse)
|
||
7. Integrasjonsmuligheter (API-er i fagsystemer)
|
||
|
||
### Integrasjon med andre referansefiler:
|
||
|
||
- **Alternativanalyse** (`alternativanalyse-methodology.md`): Score-begrunnelser bør ha kildeklassifisering
|
||
- **Regional tilgjengelighet** (`regional-availability-verification.md`): Verifiseringslogg er kildeklasse V
|
||
- **Gjennomførbarhet** (`capacity-feasibility-benchmarks.md`): Tidsestimater er typisk klasse E eller A
|
||
- **Utredningsmal** (`ai-utredning-template.md`): Antakelsesregister er vedlegg i utredningen
|