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.
12 KiB
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:
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
- Alltid bruk høyest tilgjengelig klasse. Hvis du kan verifisere via MCP, gjør det — ikke nøy deg med KB.
- Nedgrader ved usikkerhet. Hvis KB-informasjon er eldre enn 6 måneder, vurder å verifisere via MCP eller nedgrader til E.
- Vær ærlig om antakelser. Det er bedre å merke noe som A enn å presentere det som V.
- Verifiser kritiske antakelser. Antakelser som påvirker anbefalingen må valideres — enten i sesjonen eller som oppfølgingspunkt.
2. Antakelsesregister — mal
2.1 Registertabell
### 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
### 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:
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):
### 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:
- Klassifiser alltid kilder med [V], [KB], [E], eller [A] inline i teksten. Dette tar sekunder og gir enorm verdi for beslutningstaker.
- Opprett antakelsesregister for hvert prosjekt. Start med de mest kritiske antakelsene.
- Verifiser P1-antakelser i sesjonen ved hjelp av MCP-verktøy (microsoft-learn, tavily).
- 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:
- Lisenssituasjon (M365 E3/E5, Copilot Studio, Azure-abonnement)
- Regional tilgjengelighet (Norway East vs. Sweden Central)
- Datakvalitet og tilgjengelighet (SharePoint, fagsystemer)
- Kompetansenivå i organisasjonen
- Budsjettramme og tidsfrist
- Regulatorisk klassifisering (AI Act risikoklasse)
- 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